POST
上传图片

Authorizations

Authorization
string
header
required

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

Body

multipart/form-data
file
file
required

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

purpose
string
required

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

Example:

"vision"

Response

KaienAPI 临时图片地址

url
string<uri>
required

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

Example:

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

created
integer<int64>

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

Example:

1757403998946

expires_at
integer<int64>

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

Example:

1757490398946