POST
上传图片

授权

Authorization
string
header
必填

在请求头中传入:Authorization: Bearer sk-...

请求体

multipart/form-data
file
file
必填

要上传的图片。支持 JPG、PNG、GIF、WebP,默认最大 10 MiB。

purpose
string
必填

兼容用途字段,图片引用场景建议填写 vision。KaienAPI 会校验但不会保存该字段。

示例:

"vision"

响应

KaienAPI 临时图片地址

url
string<uri>
必填

临时公开 HTTPS 地址,在有效期内访问无需携带 API Key。

示例:

"https://assets.kaien-canvas.cn/files/example.png"

created
integer<int64>

文件创建时间,Unix 毫秒时间戳。

示例:

1757403998946

expires_at
integer<int64>

预计过期时间,Unix 毫秒时间戳;实际失效时间可能稍晚。

示例:

1757490398946