Skip to main content
POST
GPT-Image-2.5 画像生成
通常版は POST /v1/images/generations で画像タスクを作成し、タスク ID を返します。タスク完了後、照会エンドポイントで画像 URL を取得します。2 つのモデルは同じリクエスト形式を使用します: gpt-image-2.5 はシリーズ名です。呼び出し時は表の完全なモデル名を指定してください。
本ページでは通常版を説明します。実際の token に基づく課金が必要な場合は、独立した GPT-Image-2.5 VIP ドキュメント を使用してください。両版とも非同期タスクで、主な違いは size の形式と課金方法です。
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.comhttps://toapis.cn に置き換えてください。
API Key は コンソール で作成できます。

クイックスタート

自分の ToAPIs API Key を環境変数 TOAPIS_API_KEY に設定し、タスクを送信します:
送信時のレスポンス例:
返された id を保存し、下の TASK_ID をその値に置き換えて照会します:
タスクは pendingqueuedin_progress を経て、最終的に completed または failed になります。completed の場合は result.data から画像 URL を読み取り、failed の場合は error を読み取ります。数秒ごとに 1 回照会することを推奨します。完全なフィールドは 画像タスクのステータス取得 を参照してください。 送信の成功はタスクが作成されたことを示します。completed になるまで待ってから画像をダウンロードし、待機中は同じタスク ID を照会し続けてください。

Body

string
必須
Bearer YOUR_TOAPIS_API_KEY で認証します。
string
必須
gpt-image-2.5-flare または gpt-image-2.5-sunburst
string
必須
画像の説明。参考画像を使用する場合は、保持する主体と変更する内容を記述します。
string
デフォルト:"high"
現在の通常版 W8X チャネルでは high に固定されているため、このパラメータは省略できます。他の文字列値を指定しても無視され、一律で high が使用されます。Playground には品質オプションが表示されません。現在の通常版は resolution ごとに課金されます。
string
デフォルト:"1:1"
画面のアスペクト比。例:1:13:22:34:33:45:44:516:99:1621:9比率を指定し、resolution も明示的に指定することを推奨します。サーバーはこの 2 つから出力ピクセルサイズを計算します。通常版の比率での指定方法は、VIP 版のピクセルサイズでの指定方法とは異なります。
string
デフォルト:"1K"
解像度の段階。1K2K4K に対応し、小文字形式も受け付けます。このフィールドは通常版の課金段階を決定します。
string
背景の任意パラメータ. "transparent" を指定すると透明背景の画像を生成します. 省略すると通常の画像生成になります.テキストからの生成と reference_images を含むリクエストの両方で使用できます.
integer
デフォルト:1
1 リクエストにつき 1 を使用し、画像を 1 枚生成します。
string[]
省略可能な参考画像の URL リスト。画像アドレスはサーバーからアクセスできる必要があります。ローカル画像は先に Upload 画像API で URL を取得してください。image_urls にも対応しています。いずれか一方のフィールドを選択してください。本エンドポイントの例では URL の参考画像を使用します。ローカルファイルを直接アップロードして編集する場合は、VIP 画像編集 を参照してください。

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

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

参考画像を使った生成

同じ生成エンドポイントを使用し、reference_images を追加します。下の例では Sunburst を使用しており、戻り値は引き続き非同期タスクです:
https://example.com/otter.png を自分の参考画像 URL に置き換え、返されたタスク ID で結果を照会します。

料金

以下は 2026-09-09 時点で確認した標準価格です。1 回につき画像を 1 枚生成し、2 つの通常版モデルの価格は同じです: これら 3 つの価格は lowmediumhighxhighmax のいずれにも適用されます。現在、参考画像の入力に 1 枚あたりの追加費用はありません。アカウント固有の価格や割引が適用される場合があります。最新の価格は モデル料金ページ とアカウントの実際の設定を基準とします。

VIP 版との違い

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