接口对接说明
声音复刻对接文档
1.
POST /v1/files/upload，拿到 file_id）。2.
POST /v1/voice_clone）。基础信息
https://www.goatapi.com/Authorization: Bearer sk-xxxxapplication/json1) 上传音频：POST /v1/files/upload
Content-Type：multipart/form-data请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
file | file(binary) | 是 | 音频文件 |
purpose | string | 否 | 用途。默认 voice_clone |
model | string | 否 | 建议填speech-02-hd |
请求示例（上传待复刻音频）
字段说明
file.file_id：后续调用 /v1/voice_clone 时要用到。base_resp.status_code=0：表示上游业务成功。2) 发起复刻：POST /v1/voice_clone
Content-Type：application/json请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
file_id | int64 | 是 | 待复刻音频的 file_id（来自上传接口） |
voice_id | string | 是 | 你要创建的音色 ID 不可重复 |
model | string | 否 | 可填 speech-02-hd |
text | string | 否 | 试听文本 |
clone_prompt | object | 否 | 示例音频参数对象 |
clone_prompt.prompt_audio | int64 | 否 | 示例音频 file_id（通常来自 purpose=prompt_audio 的上传） |
clone_prompt.prompt_text | string | 否 | 示例音频对应文本 |
language_boost | string | 否 | 语言增强设置 |
need_noise_reduction | boolean | 否 | 是否降噪（true 时生效） |
need_volume_normalization | boolean | 否 | 是否音量归一化（true 时生效） |
aigc_watermark | boolean | 否 | 是否添加水印（true 时生效） |
推荐调用方式
file_id + voice_id。text + speech_model（如 speech-02-hd / speech-02-turbo）。请求示例
成功响应示例
{
"input_sensitive": false,
"input_sensitive_type": 0,
"demo_audio": "https://xxx/preview_audio_url",
"base_resp": {
"status_code": 0,
"status_msg": "success"
}
}字段说明
demo_audio：试听音频地址（如果上游生成了试听音频）。base_resp.status_code=0：表示上游业务成功。错误处理
{
"error": {
"message": "错误信息",
"type": "new_api_error",
"param": "",
"code": "invalid_request"
}
}file is required：上传接口未传 file。file_id is required：复刻接口未传 file_id。voice_id is required：复刻接口未传 voice_id。request body too large：请求体超过网关限制（会返回 413）。计费说明（接入方常问）
/v1/files/upload：上传接口不计费。/v1/voice_clone：会计费。/v1/voice_clone 里同时传了 text + 合成模型（speech_model 或可用于合成的 model）时，试听文本会按字符额外计费。修改于 2026-05-05 12:22:20