上传文件

把文件上传到平台资产体系并返回 file_id，供 ASR 等异步/大文件场景按 id 复用。该接口对齐 Files 的上传操作，请求体为 multipart/form-data。

POST

/v1/files

上传文件。请求体为 multipart/form-data，文件字段流式进入资产，返回 file 对象，其中 id 即 file_id。

认证

在请求头中加入 Authorization: Bearer <API_KEY> 完成鉴权，密钥可在控制台「API 密钥」页生成。

curl https://api.mosi.cn/v1/files \
  -H "Authorization: Bearer $MOSS_API_KEY"

请求字段

字段	类型	必填	说明
file	file	是	multipart 文件字段，流式上传到资产，不整文件读入内存。
purpose	string	是	文件用途，例如 `audio`；平台记录该标记。

请求示例

curl https://api.mosi.cn/v1/files \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -F file=@speech.wav \
  -F purpose=audio

响应字段

字段	类型	必返	说明
id	string	是	文件 id，即后续接口使用的 `file_id`。
object	string	是	固定为 `file`。
bytes	integer	是	文件字节数。
created_at	integer	是	创建时间，Unix 时间戳，单位为秒。
filename	string	是	原始文件名。
purpose	string	是	上传时传入的用途标记。
status	string	是	文件状态，例如 `processed` / `active`；失败时可能返回 `failed`，具体以服务端实际返回为准。

响应示例

{
  "id": "<file_id>",
  "object": "file",
  "bytes": 1048576,
  "created_at": 1710000000,
  "filename": "speech.wav",
  "purpose": "audio",
  "status": "processed"
}

下一步

查询文件列表

查询当前账号上传的文件列表。

音频转写

音频转写接口。