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

# GPT Image 2

> GPT Image 2：图片生成模型。包含 MixRoute 调用示例与参数。

GPT Image 2 是 OpenAI 推出的图片生成模型。

可使用下方端点通过 MixRoute 调用 `gpt-image-2`。

## 核心能力

* 文生图 - 根据自然语言提示词生成图片
* 图片编辑 - 使用提示词修改上传图片
* 输出控制 - 配置尺寸与质量
* Images API - 使用 /v1/images/generations

## 输出规格

| 属性   | 取值                                                       |
| ---- | -------------------------------------------------------- |
| 端点   | `/v1/images/generations`, `/v1/images/edits`             |
| 常用尺寸 | 1024x1024, 1536x1024, 1024x1536, 2048x2048, up to 3840px |
| 尺寸限制 | 边长为 16 的倍数；宽高比不超过 3:1；总像素 655,360-8,294,400              |
| 质量   | low, medium, high, auto                                  |
| 格式   | png, jpeg, webp                                          |
| 背景   | opaque, auto                                             |

## 快速示例

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/images/generations" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "model": "gpt-image-2",
      "prompt": "A minimal red circle centered on a white background",
      "size": "1024x1024",
      "n": 1,
      "quality": "low"
    }'
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    import requests

    response = requests.post(
        "https://api.mixroute.ai/v1/images/generations",
        headers={"Authorization": "Bearer YOUR_API_KEY"},
        json={'model': 'gpt-image-2',
              'prompt': 'A minimal red circle centered on a white background',
              'size': '1024x1024',
              'n': 1,
              'quality': 'low'},
    )

    print(response.json())
    ```
  </Tab>
</Tabs>

## 参数

| 参数                   | 类型      | 必填 | 说明                         |
| -------------------- | ------- | -- | -------------------------- |
| `model`              | string  | 是  | 固定为 `gpt-image-2`。         |
| `prompt`             | string  | 是  | 需要生成图片的文字描述。               |
| `n`                  | integer | 否  | 生成图片数量。                    |
| `size`               | string  | 否  | 输出图片尺寸。                    |
| `quality`            | string  | 否  | 模型支持时设置输出质量。               |
| `output_format`      | string  | 否  | png、jpeg 或 webp。           |
| `output_compression` | integer | 否  | JPEG 或 WebP 压缩级别，范围 0-100。 |
| `background`         | string  | 否  | opaque 或 auto。             |

## 图片编辑

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/images/edits" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -F "model=gpt-image-2" \
      -F "image=@source.png" \
      -F "prompt=Replace the white background with a pale blue background" \
      -F "size=1024x1024" \
      -F "quality=low"
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")

    result = client.images.edit(
        model="gpt-image-2",
        image=open("source.png", "rb"),
        prompt="Replace the white background with a pale blue background",
        size="1024x1024",
        quality="low",
    )

    print(result.data[0])
    ```
  </Tab>
</Tabs>

### 编辑参数

| 参数                   | 类型      | 必填 | 说明                             |
| -------------------- | ------- | -- | ------------------------------ |
| `image`              | file    | 是  | 通过 multipart form data 上传的源图片。 |
| `model`              | string  | 是  | 固定为 `gpt-image-2`。             |
| `prompt`             | string  | 是  | 图片编辑指令。                        |
| `size`               | string  | 否  | 输出图片尺寸。                        |
| `quality`            | string  | 否  | 输出质量。                          |
| `output_format`      | string  | 否  | png、jpeg 或 webp。               |
| `output_compression` | integer | 否  | JPEG 或 WebP 压缩级别，范围 0-100。     |