Skip to main content
POST
上传音频文件

说明

上传音频文件并获取 file_id,用于后续音色克隆接口引用。音色克隆场景下,purpose 固定传 voice_clone
  • 音频要求:建议上传 3-30 秒 的清晰人声音频,文件大小 50MB 以内,支持 MP3、AAC、WAV 格式。
  • 请求格式:使用 multipart/form-data,文件字段必须以二进制文件形式上传。
  • 结果使用:后续克隆接口中的 file_id 使用返回值里的 file.file_id

调用示例

上传文件接口的 Authorization 直接传 API Key,不需要 Bearer 前缀。-F "file=@/path/to/voice.wav" 中的 @ 不能省略;省略后会上传字符串路径,而不是文件内容。

成功返回示例

下一步

上传成功后,您可以选择以下任一方式生成克隆音色:

授权

Authorization
string
header
必填

直接传 API Key,例如:sk-xxxx

请求体

multipart/form-data
file
file
必填

参考音频文件。建议 3-30 秒,文件大小 50MB 以内,支持 MP3、AAC、WAV 格式。

purpose
string
默认值:voice_clone
必填

文件用途。音色克隆场景固定传 voice_clone

Allowed value: "voice_clone"
示例:

"voice_clone"

响应

200 - application/json

成功

file
object
base_resp
object

通用状态结构