GPT Image 1 Edit

gpt_image_1_edit

OpenAI 的 GPT Image 1 Edit 高质量图像编辑模型，支持多种图像尺寸、批量生成和质量等级控制。

调用地址

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

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

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

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

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/gpt_image_1_edit" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A clean product photo of a red apple on a white table, soft studio lighting.",
    "images": ["https://example.com/input.png"],
    "input_fidelity": "low",
    "n": 1,
    "size": "1024x1024",
    "quality": "medium",
    "background": "auto",
    "output_format": "jpeg",
    "output_compression": 90,
    "moderation": "auto"
  }'

prompt string 必填

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

images any 必填

用于编辑的输入图像列表

mask any

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

input_fidelity string

控制模型在编辑时保留输入图像细节的程度

可选值：high、low

默认值：low

n int

要生成的编辑后图像数量

范围：1 - 10

默认值：1

size string

请求输出图像尺寸

可选值：1024x1024、1024x1536、1536x1024、auto

默认值：auto

quality string

设置生成图像的质量等级，更高质量通常会增加延迟和成本

可选值：low、medium、high、auto

默认值：auto

background string

生成图像的背景透明度。透明背景仅适用于支持透明通道的输出格式，例如 png 或 webp

可选值：transparent、opaque、auto

默认值：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_1_edit/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_1_edit/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_1_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	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理