Skip to main content
POST
保存制品
此操作会向当前制品存储写入一个新版本,重复发送相同请求也可能产生新版本。提交前确认内容与目标应用、用户和会话
文本使用 artifact.text;二进制内容使用 artifact.inlineData,并提供 mimeType 与 Base64 编码的 data。保存后使用响应中的 version 读取确切版本,canonicalUri 是否可直接访问取决于存储后端与访问权限

路径参数

app_name
string
必填

应用名称

user_id
string
必填

用户 ID

session_id
string
必填

会话 ID

请求体

application/json
filename
string
必填

制品文件名

artifact
Part · object
必填

制品内容,使用 Part 消息片段格式

customMetadata
Custommetadata · object | null

自定义元数据

响应

请求成功

version
integer
必填

单调递增的制品版本号

canonicalUri
string
必填

已存储制品的规范 URI

customMetadata
Custommetadata · object

自定义元数据

createTime
number

创建时间,Unix 时间戳,单位为秒

mimeType
string | null

内容的 MIME 类型

最后修改于 2026年9月19日