OpenAI Images Edits

OpenAI 兼容图片编辑接口，用于上传原图并按提示词进行局部修改、风格转换或图生图。

接口信息

项目	值
方法	POST
路径	/v1/images/edits
完整地址	https://api.gemai.cc/v1/images/edits
鉴权	Authorization: Bearer sk-你的令牌
Content-Type	multipart/form-data

请求字段示例

字段	说明
model	图片编辑模型
image	要编辑的图片文件
prompt	编辑说明
size	输出尺寸

代码示例

cURL

curl --location 'https://api.gemai.cc/v1/images/edits' \
  --header "Authorization: Bearer $GEMAI_API_KEY" \
  --form 'model="gpt-image-2"' \
  --form 'image=@"./input.png"' \
  --form 'prompt="把图片改成日系插画风格，保留主体构图"' \
  --form 'size="1024x1024"'

JavaScript

import fs from 'node:fs'

const form = new FormData()
form.append('model', 'gpt-image-2')
form.append('prompt', '把图片改成日系插画风格，保留主体构图')
form.append('size', '1024x1024')
form.append('image', new Blob([fs.readFileSync('./input.png')]), 'input.png')

const response = await fetch('https://api.gemai.cc/v1/images/edits', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${process.env.GEMAI_API_KEY}`,
  },
  body: form,
})

console.log(await response.json())

Python

import os
import requests

with open('input.png', 'rb') as image:
    response = requests.post(
        'https://api.gemai.cc/v1/images/edits',
        headers={'Authorization': f"Bearer {os.environ['GEMAI_API_KEY']}"},
        data={
            'model': 'gpt-image-2',
            'prompt': '把图片改成日系插画风格，保留主体构图',
            'size': '1024x1024',
        },
        files={'image': image},
        timeout=300,
    )

response.raise_for_status()
print(response.json())

返回示例

{
  "created": 1741569952,
  "data": [
    {
      "url": "https://example.com/edited-image.png"
    }
  ]
}

注意事项

• 上传文件时不要手动设置 Content-Type: application/json。
• 图片体积越大，上传和生成耗时越久。