Skip to main content
POST
使用 GPT Image 编辑一张来源图片(真实计费)
使用 multipart 上传一张 PNG、JPEG 或 WebP。两个逆向接口都会转发 lowmediumhighauto,实际效果取决于上游。 当前 Images 形式的 Edit 是同步接口。需要 1~16 张参考图时,使用 /v1/images/tasks 并设置 action=edit
在线测试会产生真实编辑费用。请使用开发图片和开发密钥,避免分享带凭证的生成命令。

授权

Authorization
string
header
必填

YingTu API Key。

请求体

multipart/form-data
model
enum<string>
必填
可用选项:
gpt-image-2-web,
gpt-image-2-vip
示例:

"gpt-image-2-web"

prompt
string
必填
Minimum string length: 1
示例:

"保留产品主体,把背景替换为浅蓝色"

image
file
必填

一张 PNG、JPEG 或 WebP 来源图片。

size
enum<string>

当前公开支持三档尺寸。请明确传入 size 以获得可预测的像素尺寸;4K 横图使用 3840x2160。

可用选项:
1024x1024,
2048x2048,
3840x2160
示例:

"1024x1024"

quality
enum<string>

两个 GPT Image 接口都会转发该值;实际效果由所选上游决定。

可用选项:
low,
medium,
high,
auto
示例:

"low"

n
enum<integer>
默认值:1
可用选项:
1

响应

完整图片编辑响应

created
integer<int64>
必填

Unix 秒级时间戳。

data
object[]
必填
Required array length: 1 element
size
string

Output size when returned by the selected GPT Image route.

quality
string

Quality value reported by the selected GPT Image route.

usage
object
最后修改于 2026年9月3日