Skip to main content
GET
获取文件

请求头

kimi-api-version
enum<string>

本次请求使用的 API 版本,格式为 YYYY-MM-DD。发送 2026-09-01-beta 即使用本文档所述版本。/v1/files* 之外必传:未携带请求头将被拒绝并返回 400 invalid_request_error;在 /v1/files* 上缺省时选择兼容行为。所有端点对未知取值均返回 400 invalid_request_error。 平台当前支持的 API 版本。新的日期版本发布时加入;版本在公告的 Sunset 日期后移除。

可用选项:
2026-09-01-beta

路径参数

id
string
必填

文件 ID。

响应

文件的元数据。

上传到调用方项目的文件元数据。

id
string
必填

文件 ID。

filename
string
必填

原始文件名(可能带有服务器分配的去重后缀)。

mime_type
string
必填

上传时检测到的 MIME 类型。

size_bytes
integer<int64>
必填

文件大小(字节)。

created_at
string<date-time>
必填

上传时间戳。

extract_status
enum<string>
必填

当前处理状态。

可用选项:
ready,
error
purpose
enum<string>

处理用途。

可用选项:
file-extract,
image,
video,
batch