文件上传

开发指南 API参考

模型价格模型发布

使用本接口，在云知声 Token Hub大模型服务平台，上传所需文件。

POST/v1/files/upload

授权

Authorizationstringheader必填

HTTP: Bearer Auth

Security Scheme Type: http
HTTP Authorization Scheme: Bearer API_key，用于验证账户信息，可在项目管理>API Key 中查看。

请求头

Content-Typestring默认值: multipart/form-data必填

请求体

purpose string 必填

文件使用目的。取值及支持格式如下：

voice_clone: 快速克隆原始文件（支持wav格式）
prompt_audio: 声音克隆的示例音频（支持wav格式）
t2a_async_input: 异步长文本语音生成合成中，请求体中的文本文件（支持text格式）
a2t_async_input: 异步语音转写中，请求体中的音频文件（支持mp3、opus、wav、amr、m4a、ogg格式）
ocr_async_input: 异步文档解析中，请求体中的图片或文件（支持jpg、png、pdf格式）

file binary 必填

需要上传的文件。填写文件的路径地址。

响应体结构

fileobject

file.file_idinteger<int64>

文件的唯一标识符

file.bytesinteger<int64>

文件大小，以字节为单位

file.created_atinteger<int64>

创建文件时的 Unix 时间戳，以毫秒为单位

file.filenamestring

文件的名称

file.purposestring

文件的使用目的

base_respobject

base_resp.status_codeinteger

状态码如下：

100001, 请求参数错误
101999, 服务内部错误

更多内容可查看错误码了解详情

base_resp.status_msgstring

状态详情

Upload File

curl --request POST \
  --url https://maas-api.hivoice.cn/v1/files/upload \
  --header 'Authorization: Bearer <api_key>' \
  --header 'Content-Type: multipart/form-data' \
  --form purpose=voice_clone \
  --form file=@/path/to/file

200

{
  "file": {
    "file_id": 123456789,
    "bytes": 213836,
    "created_at": 1774268796,
    "filename": "test.wav",
    "purpose": "voice_clone"
  },
  "base_resp": {
    "status_code": 0,
    "status_msg": "success"
  }
}