上传图片
curl --request POST \
--url https://ai.xbrod.com/v1/uploads/images \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form file=@example-fileimport requests
url = "https://ai.xbrod.com/v1/uploads/images"
files = { "file": ("example-file", open("example-file", "rb")) }
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('file', '<string>');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://ai.xbrod.com/v1/uploads/images', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"url": "https://images-1234567890.cos.ap-shanghai.myqcloud.com/images/9a9b3d4d29ca4b68da9e001519f4d780.png",
"bytes": 53646,
"content_type": "image/png",
"filename": "upload.png",
"created_at": 1792061639
}上传管理
上传图片
上传参考图并获取可用于图像生成的图片地址。
POST
/
v1
/
uploads
/
images
上传图片
curl --request POST \
--url https://ai.xbrod.com/v1/uploads/images \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form file=@example-fileimport requests
url = "https://ai.xbrod.com/v1/uploads/images"
files = { "file": ("example-file", open("example-file", "rb")) }
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('file', '<string>');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://ai.xbrod.com/v1/uploads/images', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"url": "https://images-1234567890.cos.ap-shanghai.myqcloud.com/images/9a9b3d4d29ca4b68da9e001519f4d780.png",
"bytes": 53646,
"content_type": "image/png",
"filename": "upload.png",
"created_at": 1792061639
}使用项目的 API 密钥上传 PNG、JPEG 或 WebP 图片。可以上传本地文件,也可以提供可公开访问的图片地址。
上传本地文件(
通过图片地址上传:
成功时返回上传后的公网图片地址,以及文件大小和类型:
将返回的
@ 后是运行 curl 的机器上的文件路径):
curl -X POST 'https://ai.xbrod.com/v1/uploads/images' \
-H 'Authorization: Bearer <本项目 API 密钥>' \
-F '[email protected]'
curl -X POST 'https://ai.xbrod.com/v1/uploads/images' \
-H 'Authorization: Bearer <本项目 API 密钥>' \
-H 'Content-Type: application/json' \
-d '{"image_url":"https://example.com/reference.png"}'
{
"url": "https://images-1234567890.cos.ap-shanghai.myqcloud.com/images/9a9b3d4d29ca4b68da9e001519f4d780.png",
"bytes": 53646,
"content_type": "image/png",
"filename": "upload.png",
"created_at": 1792061639
}
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。重新编码可能改变部分非图像元数据;需要保留原文件时请先自行压缩后再上传。授权
API key created in this gateway, not a provider key.
请求体
multipart/form-dataapplication/json
PNG、JPEG 或 WebP 图片,输入最多 64 MiB;超过 20 MiB 时不缩小尺寸,尝试压缩。不透明的 PNG 如无损压缩后仍超限,可能转为 JPEG。输出最多 20 MiB。