使用 GPT Image 编辑一张来源图片(真实计费)
curl --request POST \
--url https://api.yingtu.ai/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form model=gpt-image-2-web \
--form 'prompt=保留产品主体,把背景替换为浅蓝色' \
--form image='@example-file'import requests
url = "https://api.yingtu.ai/v1/images/edits"
files = { "image": ("example-file", open("example-file", "rb")) }
payload = {
"model": "gpt-image-2-web",
"prompt": "保留产品主体,把背景替换为浅蓝色"
}
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('model', 'gpt-image-2-web');
form.append('prompt', '保留产品主体,把背景替换为浅蓝色');
form.append('image', '<string>');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://api.yingtu.ai/v1/images/edits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"created": 123,
"data": [
{
"b64_json": "iVBORw0KGgo="
}
],
"size": "<string>",
"quality": "<string>",
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"total_tokens": 1,
"input_tokens_details": {
"text_tokens": 1,
"image_tokens": 1
},
"output_tokens_details": {
"text_tokens": 1,
"image_tokens": 1
}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "insufficient_user_quota"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "insufficient_user_quota"
}
}{
"error": {
"message": "Insufficient balance for this request",
"type": "new_api_error",
"param": "",
"code": "insufficient_user_quota"
}
}{
"error": {
"message": "Request body exceeds the current limit",
"type": "new_api_error",
"param": "",
"code": "read_request_body_failed"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "insufficient_user_quota"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "insufficient_user_quota"
}
}GPT Image API
使用 GPT Image 编辑图片
查看同步 GPT Image Edit 接口,包括一张 multipart 来源图、编辑提示词、三档尺寸、quality 和 Base64 PNG。
POST
/
v1
/
images
/
edits
使用 GPT Image 编辑一张来源图片(真实计费)
curl --request POST \
--url https://api.yingtu.ai/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form model=gpt-image-2-web \
--form 'prompt=保留产品主体,把背景替换为浅蓝色' \
--form image='@example-file'import requests
url = "https://api.yingtu.ai/v1/images/edits"
files = { "image": ("example-file", open("example-file", "rb")) }
payload = {
"model": "gpt-image-2-web",
"prompt": "保留产品主体,把背景替换为浅蓝色"
}
headers = {"Authorization": "Bearer <token>"}
response = requests.post(url, data=payload, files=files, headers=headers)
print(response.text)const form = new FormData();
form.append('model', 'gpt-image-2-web');
form.append('prompt', '保留产品主体,把背景替换为浅蓝色');
form.append('image', '<string>');
const options = {method: 'POST', headers: {Authorization: 'Bearer <token>'}};
options.body = form;
fetch('https://api.yingtu.ai/v1/images/edits', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"created": 123,
"data": [
{
"b64_json": "iVBORw0KGgo="
}
],
"size": "<string>",
"quality": "<string>",
"usage": {
"input_tokens": 1,
"output_tokens": 1,
"total_tokens": 1,
"input_tokens_details": {
"text_tokens": 1,
"image_tokens": 1
},
"output_tokens_details": {
"text_tokens": 1,
"image_tokens": 1
}
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "insufficient_user_quota"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "insufficient_user_quota"
}
}{
"error": {
"message": "Insufficient balance for this request",
"type": "new_api_error",
"param": "",
"code": "insufficient_user_quota"
}
}{
"error": {
"message": "Request body exceeds the current limit",
"type": "new_api_error",
"param": "",
"code": "read_request_body_failed"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "insufficient_user_quota"
}
}{
"error": {
"message": "<string>",
"type": "invalid_request_error",
"param": "<string>",
"code": "insufficient_user_quota"
}
}使用 multipart 上传一张 PNG、JPEG 或 WebP。两个逆向接口都会转发
low、medium、high 或 auto,实际效果取决于上游。
当前 Images 形式的 Edit 是同步接口。需要 1~16 张参考图时,使用 /v1/images/tasks 并设置 action=edit。
在线测试会产生真实编辑费用。请使用开发图片和开发密钥,避免分享带凭证的生成命令。
授权
YingTu API Key。
请求体
multipart/form-data
可用选项:
gpt-image-2-web, gpt-image-2-vip 示例:
"gpt-image-2-web"
Minimum string length:
1示例:
"保留产品主体,把背景替换为浅蓝色"
一张 PNG、JPEG 或 WebP 来源图片。
当前公开支持三档尺寸。请明确传入 size 以获得可预测的像素尺寸;4K 横图使用 3840x2160。
可用选项:
1024x1024, 2048x2048, 3840x2160 示例:
"1024x1024"
两个 GPT Image 接口都会转发该值;实际效果由所选上游决定。
可用选项:
low, medium, high, auto 示例:
"low"
可用选项:
1 最后修改于 2026年9月3日