POST
上传图片

Authorizations

Authorization
string
header
required

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

Body

multipart/form-data
file
file
required

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

purpose
string
required

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

Example:

"vision"

Response

上游图片地址

url
string<uri>
required

上游图片存储返回的公开 HTTPS 地址,访问时无需携带 Kaien API Key。

Example:

"https://image.example.com/uploads/example.png"

created
integer<int64>

上游图片存储返回的创建时间戳。

Example:

1757403998946