查询文件详情

查询单个文件的元信息，返回 file 对象。

GET

/v1/files/{file_id}

按 file_id 返回单个文件的元信息（file 对象）。

认证

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

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

请求参数

路径参数	类型	必填	说明
file_id	string	是	`POST /v1/files` 返回的 `id`。

请求示例

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

响应字段

字段	类型	必返	说明
id	string	是	文件 id，即 `file_id`。
object	string	是	固定为 `file`。
bytes	integer	是	文件字节数。
created_at	integer	是	创建时间，Unix 时间戳，单位为秒。
filename	string	是	原始文件名。
purpose	string	是	文件用途标记；可能为空字符串。
status	string	是	文件状态，以服务端实际返回为准。

响应示例

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

下一步

删除文件

删除已上传文件。

上传文件

上传音频文件并获取 file_id。