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

# GPT Image 2

> GPT Image 2：圖片生成模型。包含 MixRoute 呼叫範例與參數。

<link rel="alternate" hrefLang="en" href="https://mixroute.ai/docs/model-api/openai/gpt-image-2" />

<link rel="alternate" hrefLang="zh-Hans" href="https://mixroute.ai/docs/zh-hans/model-api/openai/gpt-image-2" />

<link rel="alternate" hrefLang="zh-Hant" href="https://mixroute.ai/docs/zh-hant/model-api/openai/gpt-image-2" />

<link rel="alternate" hrefLang="ja" href="https://mixroute.ai/docs/ja/model-api/openai/gpt-image-2" />

<link rel="alternate" hrefLang="x-default" href="https://mixroute.ai/docs/model-api/openai/gpt-image-2" />

GPT Image 2 可通過下方原生圖片介面呼叫。

支援圖片生成與編輯，尺寸限制、透明背景支援和輸入保真度按模型版本區分。

<Tip>
  [生成參數](/docs/zh-hant/api-reference/endpoint/gpt-image) | [編輯參數](/docs/zh-hant/api-reference/endpoint/gpt-image-edit)
</Tip>

`POST https://api.mixroute.ai/v1/images/generations`

## 呼叫示例

將 MixRoute Key 設定到環境變數 `MIXROUTE_API_KEY`，通過 `Authorization: Bearer ...` 認證。編輯圖片前，將素材佔位值替換為可訪問的圖片或本地檔案。

```bash theme={null}
curl --request POST "https://api.mixroute.ai/v1/images/generations" \
  --header "Authorization: Bearer $MIXROUTE_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "gpt-image-2",
  "prompt": "A clean product photograph of a red ceramic mug on a white background.",
  "n": 1,
  "size": "1024x1024",
  "quality": "low",
  "output_format": "png"
}'
```

### Python

```python theme={null}
import json
import os
import requests

payload = json.loads(r'''
{
  "model": "gpt-image-2",
  "prompt": "A clean product photograph of a red ceramic mug on a white background.",
  "n": 1,
  "size": "1024x1024",
  "quality": "low",
  "output_format": "png"
}
''')
response = requests.post(
    "https://api.mixroute.ai/v1/images/generations",
    headers={"Authorization": "Bearer " + os.environ["MIXROUTE_API_KEY"]},
    json=payload,
    timeout=180,
)
response.raise_for_status()
result = response.json()
import base64
from pathlib import Path

for index, item in enumerate(result["data"]):
    Path(f"image_{index}.png").write_bytes(base64.b64decode(item["b64_json"]))
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.