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。

查询参数

version
string

要返回的版本。省略时返回最新版本。

响应

指定版本的产物。

save_artifact 工具交付的文件。产物归项目所有,绑定到产生它的会话。在同一会话中再次交付同一路径,会为同一产物新增一个版本。列出与获取在未指定 version 时返回最新版本。

id
string
必填

产物 ID,跨版本不变。

session_id
string
必填

产生该产物的会话。

path
string
必填

源文件在沙箱内的路径。在其会话内标识该产物。

name
string
必填

文件名(path 的基础名),用于显示与下载。

mime_type
string
必填

该版本的 MIME 类型。

size_bytes
integer<int64>
必填

该版本的字节大小。

version
string
必填

本次交付的版本("1""2"……,每次保存该路径都会递增)。获取与下载时作为 version 参数传入。

delivered_at
string<date-time>
必填

该版本产生的时间。