> ## 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 ドキュメント](https://docs.toapis.com/docs/ja/api-reference/images/gpt-image-2.5-vip/generation.md) を使用してください。両版とも非同期タスクで、主な違いは size の形式と課金方法です。 > [!NOTE] > > **中国本土のユーザー向け：** 中国本土のユーザーは `https://toapis.cn` を API エンドポイント（Base URL）としてご利用ください。本ドキュメント内の例では `https://toapis.com` を `https://toapis.cn` に置き換えてください。 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 回照会することを推奨します。完全なフィールドは [画像タスクのステータス取得](https://docs.toapis.com/docs/ja/api-reference/tasks/image-status.md) を参照してください。 送信の成功はタスクが作成されたことを示します。`completed` になるまで待ってから画像をダウンロードし、待機中は同じタスク ID を照会し続けてください。 ## Body **Authorization** `string` *required* `Bearer YOUR_TOAPIS_API_KEY` で認証します。 **model** `string` *required* `gpt-image-2.5-flare` または `gpt-image-2.5-sunburst`。 **prompt** `string` *required* 画像の説明。参考画像を使用する場合は、保持する主体と変更する内容を記述します。 **quality** `string` (default: high) 現在の通常版では `high` に固定されているため、このパラメータは省略できます。他の文字列値を指定しても無視され、一律で `high` が使用されます。Playground には品質オプションが表示されません。 現在の通常版は resolution ごとに課金されます。 **size** `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 版のピクセルサイズでの指定方法とは異なります。 `auto` を指定すると上流が自動でサイズを選択しますが、最終的なアスペクト比とピクセルサイズは保証されません。 **resolution** `string` (default: 1K) 解像度の段階。`1K`、`2K`、`4K` に対応し、小文字形式も受け付けます。このフィールドは通常版の課金段階を決定します。 **background** `string` 背景の任意パラメータ. `"transparent"` を指定すると透明背景の画像を生成します. 省略すると通常の画像生成になります. テキストからの生成と `reference_images` を含むリクエストの両方で使用できます. **n** `integer` (default: 1) 1 リクエストにつき `1` を使用し、画像を 1 枚生成します。 **reference\_images** `string[]` 画像から画像を生成するための参考画像 URL のリストです (省略可能)。画像アドレスはサーバーからアクセスできる必要があります。画像 URL のみ対応し、ローカルファイルのアップロードと base64 は使用できません。ローカル画像は先に [Upload 画像API](https://docs.toapis.com/docs/ja/api-reference/uploads/images.md) で URL を取得してください。 `image_urls` にも対応しています。いずれか一方のフィールドを選択してください。 ## 透明背景 生成リクエストに `"background": "transparent"` を追加すると透明背景の画像を取得できます. 省略すると通常の生成になります. ```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": "透明背景の赤い丸いステッカー", "quality": "high", "size": "1:1", "resolution": "1K", "background": "transparent", "n": 1 }' ``` 完了後は通常どおりタスク ID で照会し, `result.data` から画像 URL を取得します. ## アスペクト比と解像度の例 | 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](https://docs.toapis.com/docs/ja/api-reference/images/gpt-image-2.5-vip/generation.md) を参照してください。 This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.