Skip to main content
POST
上传音频文件

说明

上传文件并获取 file_id。通过 purpose 区分用途:
  • 请求格式:使用 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(不需要 Bearer 前缀)

请求体

multipart/form-data
file
file
必填

上传音频文件

purpose
enum<string>
必填

文件用途

可用选项:
voice_clone,
speech_to_text
示例:

"voice_clone"

响应

200 - application/json

成功

file
object
base_resp
object