GPT Image 1.5 Edit

gpt_image_1_5_edit

OpenAI 的 GPT Image 1.5 Edit 高质量图像编辑模型，支持基于输入图像和文字提示生成编辑后的图像。

调用地址

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

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

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

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

请求参数

curl --location "https://cloud.seaart.ai/model/v1/queue/gpt_image_1_5_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"],
    "background": "auto",
    "n": 1,
    "output_compression": 90,
    "output_format": "jpeg",
    "quality": "medium",
    "size": "1024x1024",
    "moderation": "auto"
  }'

prompt string 必填

所需图像或编辑结果的文字描述，最大长度为 32000 个字符

images any 必填

用于编辑的输入图像引用列表，最多输入 16 张图像

mask any

遮罩图像引用，用于指定输入图像中需要编辑的区域，透明区域会作为可编辑区域。file_id 和 image_url 二选一提供；遮罩应与被编辑图像同格式、同尺寸且包含 alpha 通道，image_url 最大长度为 20971520

background string

生成图像的背景透明度

可选值：transparent、opaque、auto

默认值：auto

input_fidelity string

控制编辑或参考图工作流中对原始输入图像细节的保留强度

可选值：high、low

默认值：low

n int

要生成的编辑后图像数量

范围：1 - 10

默认值：1

output_compression int

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

范围：0 - 100

默认值：100

output_format string

Image API 返回图像的文件格式。jpeg 通常比 png/webp 生成更快；当 output_format 为 jpeg 或 webp 时，可以配合 output_compression 控制压缩

可选值：png、jpeg、webp

默认值：png

quality string

图像质量等级

可选值：low、medium、high、auto

默认值：auto

size string

生成图像的大小

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

默认值：auto

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_5_edit/requests/mmsu_01hxyz.../response",
  "status_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_1_5_edit/requests/mmsu_01hxyz.../status",
  "cancel_url": "https://cloud.seaart.ai/model/v1/queue/gpt_image_1_5_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	队列位置

后续操作

查询状态

获取结果

取消任务

错误处理