> ## 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

> GPT Imageの画像生成フィールド、モデルの制約、およびリクエスト例。

GPT Imageモデル向けのOpenAI Imagesリクエスト形式を使用して、テキストから画像を生成します。

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

## モデル

| モデルID | 機能と制限 |
| - | - |
| `gpt-image-2.5-flare` | 画像生成と編集向けの高速なGPT Image 2.5モデル。 |
| `gpt-image-2.5-sunburst` | 精密な生成、高度な編集、細部まで作り込んだビジュアル素材向けのGPT Image 2.5モデル。 |
| `gpt-image-2` | 生成と編集。柔軟なサイズ指定に対応。入力の忠実度は高に固定。 |
| `gpt-image-1.5` | 生成と編集。標準の画像サイズ。 |
| `gpt-image-1` | 生成と編集。標準の画像サイズ。 |

## リクエストパラメーター

| フィールド | 型 | 必須 | 説明 |
| - | - | - | - |
| `model` | string | はい | 上の表にある完全なモデルID。ルーティングのために明示的に設定してください。 |
| `prompt` | string | はい | 希望する出力または編集内容の説明。最大32000文字。 |
| `n` | integer | いいえ | 出力画像数。1〜10。デフォルトは1です。 |
| `size` | string | いいえ | 出力サイズ、または`auto`（デフォルト）。以下のモデル別のサイズルールを参照してください。 |
| `quality` | string | いいえ | `auto`（デフォルト）、`low`、`medium`、または`high`。GPT Image 2.5 Flare/Sunburstは、さらに`xhigh`と`max`にも対応します。 |
| `background` | string | いいえ | `auto`（デフォルト）、`opaque`、または`transparent`。透過にはPNGまたはWebPが必要です。GPT Image 2でのサポートはプレビュー段階です。 |
| `moderation` | string | いいえ | `auto`（デフォルト）または`low`。モデルのコンテンツフィルタリングのレベルを制御します。 |
| `output_format` | string | いいえ | 画像のエンコード形式: `png`（デフォルト）、`jpeg`、`webp`のいずれか。 |
| `output_compression` | integer | いいえ | 圧縮設定は0～100で、デフォルトは100です。JPEGまたはWebPの出力にのみ適用されます。 |
| `stream` | boolean | いいえ | trueの場合はサーバー送信イベントを返します。デフォルトはfalseです。 |
| `partial_images` | integer | いいえ | ストリーミング専用の部分画像数です。0〜3を指定します。0の場合、中間画像なしで最終画像が送信されます。生成が早く完了すると、届く部分画像の数が指定数より少なくなる場合があります。 |
| `user` | string | いいえ | エンドユーザーの安定した識別子で、不正利用の監視に使用します。生の個人情報は避けてください。 |

## サイズのルール

| モデル | 指定可能なサイズ |
| - | - |
| GPT Image 1 / 1.5 | `auto`, `1024x1024`, `1536x1024`, `1024x1536` |
| GPT Image 2 / 2.5 | `auto`または`WIDTHxHEIGHT`。縦横の両辺は16で割り切れる必要があり、各辺は最大3840 px、長辺と短辺の比率は最大3:1、総ピクセル数は655360～8294400です。 |

GPT Image 2で総ピクセル数が3686400を超える解像度は実験的です。これらのGPTモデルはBase64形式の画像データを返します。DALL-E専用の`response_format`や`style`を送信しないでください。

## 例

環境変数`MIXROUTE_API_KEY`にMixRouteのキーを設定してください。リクエストは`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.5-flare",
  "prompt": "A clean product photograph of a red ceramic mug on a white background.",
  "size": "1024x1024",
  "quality": "low",
  "n": 1,
  "output_format": "png"
}'
```

### Python

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

payload = json.loads(r'''
{
  "model": "gpt-image-2.5-flare",
  "prompt": "A clean product photograph of a red ceramic mug on a white background.",
  "size": "1024x1024",
  "quality": "low",
  "n": 1,
  "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"]))
```

## レスポンス

各画像を`data[].b64_json`から取得し、リクエストした`output_format`でデコードします。ストリーミングでは、部分画像と完了画像のイベントが返されます。最終ファイルには、最後の完了イベントを使用してください。

[GPT Imageの編集](/ja/api-reference/endpoint/gpt-image-edit)


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