Skip to main content
POST
添加会话资源

请求头

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。

请求体

application/json

为会话添加文件资源的请求体。凭据库(Vault)和记忆库的绑定在创建时即已固定。

type
enum<string>
必填

资源类型。创建后只能添加文件资源。

可用选项:
file
file_id
string
必填

要挂载的已上传文件 ID。

响应

已创建的资源绑定,携带分配的 id

作为资源绑定到会话的文件。

type
enum<string>
必填
可用选项:
file
file_id
string
必填

引用的已上传文件。

id
string

绑定时分配的会话资源 ID。

mime_type
string

文件 MIME 类型,读取时从存储的元数据解析。

title
string

显示标题,读取时从存储的元数据解析。

path
string

文件在会话工作区内链接的路径,位于 upload/ 下。