Skip to main content
POST
/
v1
/
images
/
edits
curl -X POST https://gogogotoken.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-1" \
  -F "image=@input.png" \
  -F "mask=@mask.png" \
  -F "prompt=Replace the background with a clean white studio backdrop" \
  -F "size=1024x1024"

{
  "created": 1730000000,
  "data": [
    {
      "url": "https://example.com/edited-image.png"
    }
  ]
}
使用 OpenAI Images Edits API 兼容格式编辑图片，支持上传原图、蒙版与编辑提示词。具体可用性取决于模型与渠道。 
curl -X POST https://gogogotoken.ai/v1/images/edits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "model=gpt-image-1" \
  -F "image=@input.png" \
  -F "mask=@mask.png" \
  -F "prompt=Replace the background with a clean white studio backdrop" \
  -F "size=1024x1024"

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

​
接口说明

该接口使用 multipart/form-data 上传图片资源。若模型或渠道不支持编辑能力，可能返回权限或上游错误。

​
请求头

​
Authorization
string
required
API Key 鉴权信息，格式为 Bearer YOUR_API_KEY。

​
请求体

​
model
string
default:"gpt-image-1"
required
图像编辑模型 ID。请以 GET /v1/models 返回结果为准。
​
image
string
required
原始图片文件。请求需使用 multipart/form-data 上传。
​
prompt
string
required
编辑提示词。
​
mask
string
蒙版图片文件。透明区域通常表示需要编辑的区域，具体规则取决于模型。
​
n
integer
default:1
生成数量，默认 1。
​
size
string
default:"1024x1024"
图片尺寸，例如 1024x1024。
​
response_format
string
返回格式，例如 url 或 b64_json。部分模型可能由上游配置决定。

​
响应体

​
created
integer
响应创建时间戳。
​
data
object[]
图片结果数组。
​
url
string
可访问的图片 URL。
​
b64_json
string
base64 编码的图片内容。

​
错误码

状态码含义处理建议
401API Key 无效或未传检查请求头与令牌状态
403无权限访问目标图像模型检查 API Key 分组权限
415上传格式不支持确认使用 multipart/form-data 并上传有效图片
429触发限速降低请求频率或调整套餐
5xx上游或网关异常稍后重试，并查看控制台日志