Sign in

v1

latestOpenAPI 3.1.02026-07-2634132204.7 KB
ImageEdit

图片编辑接口

基于文本提示对图片进行编辑，支持多种图片生成模型和参数配置，目前仅 gpt-image-1 和 gemini-nano-banana 模型支持该接口

post/images/edits

Request body

modelstring required

画图模型

promptstring required

文本提示

background'transparent' | 'opaque' | 'auto'

背景透明度，目前仅 gpt-image-1 支持该配置

maskstring

用于遮罩的图片URL/Base64编码数据

sizestring

图片尺寸，不同模型设置不同，详见模型尺寸表

ninteger

图片数量，默认为1

quality'auto' | 'low' | 'medium' | 'high'

图片质量，支持 auto/low/medium/high 四个配置项，默认为auto

response_format'url' | 'b64_json'

图片响应格式，支持 url/b64_json 两种格式，默认为url

output_format'png' | 'jpg' | 'webp'

图片输出格式，支持 png/jpg/webp 三种格式，默认为png

retriesinteger

自动重试次数，默认0，表示失败不重试

Example request

{
  "model": "gpt-image-1",
  "prompt": "在小猫的脚下画一只老鼠",
  "size": "1024x1024",
  "n": 1
}

Response

成功响应

createdinteger required

创建时间戳

task_idstring

任务ID

task_status'pending' | 'running' | 'succeed' | 'failed'

任务状态

Example response

{
  "task_status": "succeed"
}