Skip to main content
POST
GPT-Image-2.5 VIP 画像生成と編集
VIP 版は POST /v1/images/generations で画像タスクを作成し、タスク ID を返します。タスク完了後、照会エンドポイントで画像 URL を取得します。VIP 版と通常版の共通点は、どちらも非同期タスクを使用することです。違いはモデル名、size の形式、課金方法です。 gpt-image-2.5-vip はドキュメント上のシリーズ名です。呼び出し時は表の完全なモデル名を使用してください。
通常版も非同期タスクを使用しますが、解像度ごとの課金と比率形式の size を使用します。独立した GPT-Image-2.5 ドキュメント を参照してください。VIP 版はピクセルサイズを使用し、実際の token で精算されます。
中国本土のユーザー向け: 中国本土のユーザーは https://toapis.cn を API エンドポイント(Base URL)としてご利用ください。本ドキュメント内の例では https://toapis.comhttps://toapis.cn に置き換えてください。
API Key は コンソール で作成できます。

クイックスタート

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

生成リクエストパラメータ

string
必須
Bearer YOUR_TOAPIS_API_KEY で認証します。
string
必須
gpt-image-2.5-flare-vip または gpt-image-2.5-sunburst-vip
string
必須
画像の説明。編集時は保持する内容と変更する内容を記述します。
string
デフォルト:"high"
lowmediumhighxhighmax の 5 段階に対応し、デフォルトは high です。小文字の値を使用します。quality は生成品質と実際の出力 token に影響します。同じ quality の画像でも、サイズや内容によって費用が異なる場合があります。
string
デフォルト:"1024x1024"
出力ピクセルサイズ。幅x高さ 形式を使用します。例:1024x10241536x10241024x15361280x1024上流が許可するカスタムピクセルサイズに対応しており、上記の例に限りません。有効なサイズ範囲はエンドポイントのバリデーションに従います。VIP の例では 1:1 のような比率値は使用せず、resolution を別途指定する必要もありません。
string
背景の任意パラメータ. "transparent" を指定すると透明背景の画像を生成します. 省略すると通常の画像生成になります.テキストからの生成と参考画像編集の両方で使用できます.
integer
デフォルト:1
1 リクエストにつき 1 を使用し、画像を 1 枚生成します。

透明背景

生成リクエストに "background": "transparent" を追加すると透明背景の画像を取得できます. 省略すると通常の生成になります.
完了後は通常どおりタスク ID で照会し, result.data から画像 URL を取得します.

参考画像編集

編集には POST /v1/images/edits を使用し、リクエストは multipart/form-data です。ローカル画像を image ファイルフィールドに設定し、modelpromptqualitysizen も合わせて送信します。編集も非同期タスクで、送信後にタスク ID を返します。照会方法は生成と同じです。 下の例では Sunburst VIP を使用し、otter.png のカワウソに黄色いマフラーを追加します:
multipart の Content-Type と boundary は curl に自動設定させます。レスポンスのタスク ID を使って照会エンドポイントをポーリングし、result.data から編集後の画像 URL を読み取ります。 Flare VIP も同じ編集方法に対応しています。model を gpt-image-2.5-flare-vip に変更するだけです。参考画像の入力には画像入力 token の費用が発生します。

token 料金

以下は 2026-09-09 時点で確認した標準価格です。2 つの VIP モデルで同じで、公式の token 単価の 8 割で課金されます: 5 段階の quality は上記の token 単価を共通で使用します。VIP には quality ごとに固定された 1 枚あたりの価格はなく、タスク完了後に実際の usage で精算されます。タスク送信時には先に事前引き落としが行われ、完了後に実際のテキストと画像の token で精算され、差額は返金または追加請求されます。呼び出し前には十分なアカウント残高と API Key の枠が必要です。 費用の計算式(単位は USD):
たとえば low 画質の 1024x1024 のテキストから画像生成 1 回には、27 個のテキスト入力 token と 196 個の画像出力 token が含まれ、費用は次のとおりです:
参考画像編集 1 回の実測では、21 個のテキスト入力 token、1024 個の画像入力 token、196 個の画像出力 token でした。計算式による金額は 0.0113416で、プラットフォームの枠の最小単位で四捨五入した後の実請求額は0.0113416 で、プラットフォームの枠の最小単位で四捨五入した後の実請求額は 0.011342 です。これらは特定のリクエストの例であり、同じ画質での 1 枚あたりの固定費用を示すものではありません。 アカウント固有の価格や割引が適用される場合があります。最新の価格は モデル料金ページ とアカウントの実際の設定を基準とします。最終的な請求額は使用ログで確認できます。

通常版からの切り替え

  1. 完全なモデル名を対応する -vip モデル名に変更します。
  2. size を比率からピクセルサイズに変更し、resolution を省略します。
  3. テキストから画像生成と参考画像編集のいずれもタスク ID で結果をポーリングし、result.data から画像 URL を読み取ります。
  4. 参考画像編集では /v1/images/edits を使って画像ファイルをアップロードします。
  5. 実際の token で費用を見積もります。
通常版のタスク送信と照会の例は GPT-Image-2.5 ドキュメント を参照してください。