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

# GPT-Image-2.5 画像生成

> gpt-image-2.5-flare と gpt-image-2.5-sunburst 通常版の接続ガイド。非同期タスク、参考画像、固定の high 画質、解像度ごとの課金について説明します

通常版は `POST /v1/images/generations` で画像タスクを作成し、タスク ID を返します。タスク完了後、照会エンドポイントで画像 URL を取得します。2 つのモデルは同じリクエスト形式を使用します:

| モデル      | リクエストの model             |
| -------- | ------------------------ |
| Flare    | `gpt-image-2.5-flare`    |
| Sunburst | `gpt-image-2.5-sunburst` |

`gpt-image-2.5` はシリーズ名です。呼び出し時は表の完全なモデル名を指定してください。

<Note>
  本ページでは通常版を説明します。実際の token に基づく課金が必要な場合は、独立した [GPT-Image-2.5 VIP ドキュメント](../gpt-image-2.5-vip/generation) を使用してください。両版とも非同期タスクで、主な違いは size の形式と課金方法です。
</Note>

<Note>
  **中国本土のユーザー向け：** 中国本土のユーザーは `https://toapis.cn` を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では `https://toapis.com` を `https://toapis.cn` に置き換えてください。
</Note>

API Key は [コンソール](https://toapis.com/dashboard) で作成できます。

## クイックスタート

自分の ToAPIs API Key を環境変数 `TOAPIS_API_KEY` に設定し、タスクを送信します:

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-flare",
    "prompt": "Children's picture book style, a veterinarian listening to a baby otter's heartbeat with a stethoscope",
    "quality": "high",
    "size": "1:1",
    "resolution": "1K",
    "n": 1
  }'
```

送信時のレスポンス例:

```json theme={null}
{
  "id": "tsk_img_example",
  "object": "generation.task",
  "model": "gpt-image-2.5-flare",
  "status": "pending",
  "progress": 0,
  "created_at": 1788951900,
  "metadata": {}
}
```

返された `id` を保存し、下の `TASK_ID` をその値に置き換えて照会します:

```bash theme={null}
curl --fail-with-body \
  --url https://toapis.com/v1/images/generations/TASK_ID \
  --header "Authorization: Bearer $TOAPIS_API_KEY"
```

タスクは `pending`、`queued`、`in_progress` を経て、最終的に `completed` または `failed` になります。`completed` の場合は `result.data` から画像 URL を読み取り、`failed` の場合は `error` を読み取ります。数秒ごとに 1 回照会することを推奨します。完全なフィールドは [画像タスクのステータス取得](../../tasks/image-status) を参照してください。

送信の成功はタスクが作成されたことを示します。`completed` になるまで待ってから画像をダウンロードし、待機中は同じタスク ID を照会し続けてください。

## Body

<ParamField header="Authorization" type="string" required>
  `Bearer YOUR_TOAPIS_API_KEY` で認証します。
</ParamField>

<ParamField body="model" type="string" required>
  `gpt-image-2.5-flare` または `gpt-image-2.5-sunburst`。
</ParamField>

<ParamField body="prompt" type="string" required>
  画像の説明。参考画像を使用する場合は、保持する主体と変更する内容を記述します。
</ParamField>

<ParamField body="quality" type="string" default="high">
  現在の通常版 W8X チャネルでは `high` に固定されているため、このパラメータは省略できます。他の文字列値を指定しても無視され、一律で `high` が使用されます。Playground には品質オプションが表示されません。

  現在の通常版は resolution ごとに課金されます。
</ParamField>

<ParamField body="size" type="string" default="1:1">
  画面のアスペクト比。例：`1:1`、`3:2`、`2:3`、`4:3`、`3:4`、`5:4`、`4:5`、`16:9`、`9:16`、`21:9`。

  比率を指定し、resolution も明示的に指定することを推奨します。サーバーはこの 2 つから出力ピクセルサイズを計算します。通常版の比率での指定方法は、VIP 版のピクセルサイズでの指定方法とは異なります。
</ParamField>

<ParamField body="resolution" type="string" default="1K">
  解像度の段階。`1K`、`2K`、`4K` に対応し、小文字形式も受け付けます。このフィールドは通常版の課金段階を決定します。
</ParamField>

<ParamField body="background" type="string">
  背景の任意パラメータ. `"transparent"` を指定すると透明背景の画像を生成します. 省略すると通常の画像生成になります.

  テキストからの生成と `reference_images` を含むリクエストの両方で使用できます.
</ParamField>

<ParamField body="n" type="integer" default={1}>
  1 リクエストにつき `1` を使用し、画像を 1 枚生成します。
</ParamField>

<ParamField body="reference_images" type="string[]">
  省略可能な参考画像の URL リスト。画像アドレスはサーバーからアクセスできる必要があります。ローカル画像は先に [Upload 画像API](../../uploads/images) で URL を取得してください。

  `image_urls` にも対応しています。いずれか一方のフィールドを選択してください。本エンドポイントの例では URL の参考画像を使用します。ローカルファイルを直接アップロードして編集する場合は、[VIP 画像編集](../gpt-image-2.5-vip/generation) を参照してください。
</ParamField>

## アスペクト比と解像度の例

| size   | 1K          | 2K          | 4K          |
| ------ | ----------- | ----------- | ----------- |
| `1:1`  | `1024x1024` | `2048x2048` | `2880x2880` |
| `3:2`  | `1536x1024` | `2048x1360` | `3520x2336` |
| `2:3`  | `1024x1536` | `1360x2048` | `2336x3520` |
| `16:9` | `1536x864`  | `2048x1152` | `3840x2160` |
| `9:16` | `864x1536`  | `1152x2048` | `2160x3840` |

`4K` は解像度の段階を表し、実際の縦横サイズはアスペクト比によって決まります。たとえば正方形の 4K 出力は `2880x2880` です。

## 参考画像を使った生成

同じ生成エンドポイントを使用し、`reference_images` を追加します。下の例では Sunburst を使用しており、戻り値は引き続き非同期タスクです:

```bash theme={null}
curl --fail-with-body --request POST \
  --url https://toapis.com/v1/images/generations \
  --header "Authorization: Bearer $TOAPIS_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt-image-2.5-sunburst",
    "prompt": "Keep the baby otter and the veterinarian from the reference image, and add a yellow scarf to the baby otter",
    "reference_images": ["https://example.com/otter.png"],
    "quality": "high",
    "size": "1:1",
    "resolution": "2K",
    "n": 1
  }'
```

`https://example.com/otter.png` を自分の参考画像 URL に置き換え、返されたタスク ID で結果を照会します。

## 料金

以下は 2026-09-09 時点で確認した標準価格です。1 回につき画像を 1 枚生成し、2 つの通常版モデルの価格は同じです:

| resolution | USD/枚 |
| ---------- | ----: |
| 1K         | 0.015 |
| 2K         | 0.020 |
| 4K         | 0.025 |

これら 3 つの価格は `low`、`medium`、`high`、`xhigh`、`max` のいずれにも適用されます。現在、参考画像の入力に 1 枚あたりの追加費用はありません。アカウント固有の価格や割引が適用される場合があります。最新の価格は [モデル料金ページ](https://toapis.com/pricing) とアカウントの実際の設定を基準とします。

## VIP 版との違い

| 項目         | 通常版                        | VIP 版                      |
| ---------- | -------------------------- | -------------------------- |
| モデル名       | `-vip` なし                  | `-vip` 付き                  |
| タスク方式      | 非同期タスクで、タスク ID で画像 URL を取得 | 非同期タスクで、タスク ID で画像 URL を取得 |
| size       | 比率を推奨（例：`16:9`）            | ピクセルサイズ（例：`1536x1024`）     |
| resolution | `1K`、`2K`、`4K`             | 省略し、サイズは size で指定          |
| 課金         | resolution に対応する 1 枚あたりの価格 | 実際のテキストと画像の token          |
| 参考画像       | 生成エンドポイントに参考画像 URL を指定     | 編集エンドポイントで画像ファイルをアップロード    |

VIP に切り替える際は、モデル名とパラメータも合わせて変更してください。詳細は [GPT-Image-2.5 VIP](../gpt-image-2.5-vip/generation) を参照してください。