控制台

查询文件详情

GET/v1/files/{file_id}

查询文件详情。使用 POST /v1/files 上传返回的 file_id 查询。

请求参数

路径参数类型必填说明
file_id: string必填

POST /v1/files 返回的 id。

返回值

字段类型说明
id: string

文件 id，即 file_id。

object: string

固定为 file。

bytes: integer

文件字节数。

created_at: integer

创建时间，Unix 时间戳，单位为秒。

filename: string

原始文件名。

purpose: string

文件用途标记；可能为空字符串。

status: string

文件状态，以服务端实际返回为准。

边界

对外接口不暴露 asset_id；模型调用传 file_id 时，由平台解析为下载 URL 后供下游使用，调用方与模型侧都只接触 file_id 或 URL。

下一步

删除文件

删除已上传文件。

上传文件

上传音频文件并获取 file_id。