> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gogogotoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT 图像编辑接口

> OpenAI Images Edits API 兼容格式

使用 OpenAI Images Edits API 兼容格式编辑图片，支持上传原图、蒙版与编辑提示词。具体可用性取决于模型与渠道。

<RequestExample>
  ```bash cURL theme={null}
  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"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "created": 1730000000,
    "data": [
      {
        "url": "https://example.com/edited-image.png"
      }
    ]
  }
  ```

  ```json base64 theme={null}
  {
    "created": 1730000000,
    "data": [
      {
        "b64_json": "<base64>"
      }
    ]
  }
  ```
</ResponseExample>

## 接口说明

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

## 请求头

<ParamField header="Authorization" type="string" required>
  API Key 鉴权信息，格式为 `Bearer YOUR_API_KEY`。
</ParamField>

## 请求体

<ParamField body="model" type="string" required default="gpt-image-1">
  图像编辑模型 ID。请以 `GET /v1/models` 返回结果为准。
</ParamField>

<ParamField body="image" type="string" required>
  原始图片文件。请求需使用 `multipart/form-data` 上传。
</ParamField>

<ParamField body="prompt" type="string" required default="Replace the background with a clean white studio backdrop">
  编辑提示词。
</ParamField>

<ParamField body="mask" type="string">
  蒙版图片文件。透明区域通常表示需要编辑的区域，具体规则取决于模型。
</ParamField>

<ParamField body="n" type="integer" default={1}>
  生成数量，默认 `1`。
</ParamField>

<ParamField body="size" type="string" default="1024x1024">
  图片尺寸，例如 `1024x1024`。
</ParamField>

<ParamField body="response_format" type="string">
  返回格式，例如 `url` 或 `b64_json`。部分模型可能由上游配置决定。
</ParamField>

## 响应体

<ResponseField name="created" type="integer">
  响应创建时间戳。
</ResponseField>

<ResponseField name="data" type="object[]">
  图片结果数组。

  <ResponseField name="url" type="string">
    可访问的图片 URL。
  </ResponseField>

  <ResponseField name="b64_json" type="string">
    base64 编码的图片内容。
  </ResponseField>
</ResponseField>

## 错误码

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