POST
/
images
/
edits
curl --request POST \
  --url https://geekai.co/api/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-1",
  "prompt": "在小猫的脚下画一只老鼠",
  "image": "<string>",
  "mask": "<string>",
  "size": "1024x1024",
  "n": 1,
  "quality": "auto",
  "response_format": "url",
  "retries": 0
}'
{
  "created": 123,
  "data": [
    {
      "url": "<string>",
      "revised_prompt": "<string>"
    }
  ]
}

注意：目前仅 GPT Image 1 模型支持图片编辑，其他模型不支持。你可以在模型广场筛选查看系统支持的所有画图模型列表，画图模型请求/响应参数结构兼容 OpenAI，切换模型时只需修改对应的模型名称即可，若模型请求/响应参数和 OpenAI 不一致，极客智坊底层会自动转换对齐。

图片编辑 API 调用示例可以参考这里：图片编辑。

​
请求/响应参数明细

Authorizations

​
Authorization
string
header
required

JWT认证token

Body

application/json
​
model
string
required

画图模型

Example:

"gpt-image-1"

​
prompt
string
required

文本提示

Example:

"在小猫的脚下画一只老鼠"

​
image
required

单张图片URL/Base64编码数据

​
mask
string

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

​
size
string

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

Example:

"1024x1024"

​
n
integer

图片数量，默认为1

Example:

1

​
quality
string
default:auto

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

Example:

"auto"

​
response_format
enum<string>
default:url

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

Available options:
url,
b64_json
​
retries
integer
default:0

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

Example:

0

Response

200
application/json
成功响应
​
created
integer
required

创建时间戳

​
data
object[]
required

生成的图片列表