GPT Image 2 Edit

gpt_image_2_edit

GPT Image 2 Edit 是 OpenAI 的图像编辑模型，用于基于输入图像和文本提示词生成编辑后的高质量图像。

调用地址

POST /v1/queue/gpt_image_2_edit # 创建任务

GET /v1/queue/gpt_image_2_edit/requests/{request_id}/status # 查询状态

GET /v1/queue/gpt_image_2_edit/requests/{request_id}/response # 获取结果

PUT /v1/queue/gpt_image_2_edit/requests/{request_id}/cancel # 取消任务

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/gpt_image_2_edit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "Replace the background with a clean white studio setup while preserving the product details.",
    "images": ["https://example.com/input.png"],
    "n": 1,
    "size": "1024x1024",
    "quality": "medium",
    "background": "auto",
    "output_format": "jpeg",
    "output_compression": 90,
    "moderation": "auto"
  }'

prompt string 必填

描述需要生成或编辑出的图像内容，最大长度为 32000 个字符

images any 必填

用于编辑的输入图像引用列表

最多输入：16 张图像

mask any

遮罩图像，用于指定输入图像中需要编辑的区域，透明区域会作为可编辑区域。遮罩应与被编辑图像同格式、同尺寸且包含 alpha 通道；未提供 mask 时，整张图像都可被编辑

n int

要生成的编辑后图像数量

范围：1 - 10

默认值：1

size string

请求输出图像尺寸

支持 auto、常用固定尺寸（如 1024x1024、1024x1536、1536x1024），或满足 GPT Image 2 尺寸约束的自定义 WIDTHxHEIGHT 值

自定义尺寸要求：宽和高都必须是 16 的倍数；宽高比不超过 3:1；最长边不超过 3840px；总像素数必须在 655360 到 8294400 之间

默认值：auto

quality string

生成图像的质量等级

可选值：low、medium、high、auto

默认值：auto

background string

生成图像的背景设置。GPT Image 2 官方当前不支持 transparent 透明背景；如果传入 transparent，服务可能接受请求，但不保证生成透明背景，实际可能被上游忽略或按非透明背景处理

可选值：auto、opaque

默认值：auto

output_format string

Image API 返回图像的文件格式

可选值：png、jpeg、webp

默认值：png

output_compression int

输出图像的压缩等级，仅在 output_format 为 jpeg 或 webp 时生效，例如 output_compression=50 表示按 50% 压缩输出图像

范围：0 - 100

默认值：100

moderation string

GPT Image 生成请求的内容审核严格程度

可选值：auto、low

默认值：auto

user string

代表最终用户的唯一标识

响应参数

{
  "request_id": "mmsu_01hxyz...",
  "response_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_2_edit/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_2_edit/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_2_edit/requests/mmsu_01hxyz.../cancel",
  "queue_position": 0
}

字段	类型	说明
`request_id`	string	任务 ID，后续查询、获取结果和取消都使用它
`response_url`	string	获取最终结果的 URL
`status_url`	string	查询任务状态的 URL
`cancel_url`	string	取消任务的 URL
`queue_position`	int	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理