Skip to main content
POST
上传图片
使用项目的 API 密钥上传 PNG、JPEG 或 WebP 图片。可以上传本地文件,也可以提供可公开访问的图片地址。 上传本地文件(@ 后是运行 curl 的机器上的文件路径):
通过图片地址上传:
成功时返回上传后的公网图片地址,以及文件大小和类型:
将返回的 url 作为后续图片生成请求的 image_urls 项传入;上传与生成是两次独立请求。 本地文件及 URL 指向的图片输入最大为 64 MiB。20 MiB 以内原样上传;超过 20 MiB 时,网关不缩小图片尺寸:PNG 优先尝试无损压缩;不透明的 PNG 若无损压缩后仍超过限制,再尝试转为高画质 JPEG,返回地址、filename 和 content_type 将相应变为 JPEG;有透明度的 PNG 不会转为 JPEG。JPEG 会尝试优先使用较高画质重新编码。上传后的图片最大为 20 MiB(20,971,520 字节)。超过 64 MiB、图片过大无法安全解码,或压缩后仍超过 20 MiB 时返回 413;超过 20 MiB 的 WebP 暂不支持压缩,也返回 413。重新编码可能改变部分非图像元数据;需要保留原文件时请先自行压缩后再上传。

授权

Authorization
string
header
必填

API key created in this gateway, not a provider key.

请求体

file
file
必填

PNG、JPEG 或 WebP 图片,输入最多 64 MiB;超过 20 MiB 时不缩小尺寸,尝试压缩。不透明的 PNG 如无损压缩后仍超限,可能转为 JPEG。输出最多 20 MiB。

响应

图片上传成功。

url
string<uri>
必填

可直接用于图片生成请求 image_urls 的公网地址。

bytes
integer<int64>
必填
content_type
string
必填

实际上传图片的类型;PNG 转换后为 image/jpeg。

filename
string

实际上传图片的文件名;PNG 转换后后缀为 .jpg。

created_at
integer<int64>