結論から言うと、APIYI で画像をまとめて生成する場合、通常のタスクではまず gpt-image-2.5-all をデフォルトで使い、Default グループを利用します。回数課金トークンでも従量課金トークンでも呼び出せ、表示価格は1枚0.025ドルです。固定サイズや4Kを指定したいときは、モデル名を gpt-image-2.5-vip のような -vip モデルに切り替えます。表示価格は1枚0.03ドルです。ただし -all の専用ページには、-vip の4Kは安定性が変動するため4Kの第一選択にはしない、と明記されています。公式の quality 設定、マスクによる部分再描画、任意の有効サイズが必要な場合は公式API中継を利用します。新規プロジェクトでは gpt-image-2.6-flare（速度優先）と gpt-image-2.6-sunburst（編集と精度優先）を優先して検討してください。
フォールバックは2つのケースに分かれます。公式API中継が Default グループで429を返し続ける場合、または飽和している場合は、トークングループを image2Enterprise に切り替えてください。モデル名は変更不要です。公式リバースで ChatGPT Web版や Adobe 本家の障害が発生したときは、同じリバース回線に対して何度もバックオフを繰り返さず、モデル名を公式API中継のモデルに変更し、トークンが「従量優先」になっていることを確認してください。また、そのまま再試行してはいけないエラーが2種類あります。コンテンツ安全ポリシーによる拒否とパラメータエラーです。n パラメータにも注意してください。-all では n 倍の課金になりますが、返される画像は1枚だけです。
GPT画像チャネルの4つの名称とは
同じGPT画像モデルでも、一覧上ではいくつかのサフィックス付きで表示されます。それぞれが上流のソースと課金方式を表しています。このうち「企业分组」はモデルではなく、トークン上のルーティングオプションです。以下、ドキュメントの用語に沿って順に説明します。
- 官转：OpenAI Images APIへの公式直結で、ドキュメントにはリクエストとレスポンスがOpenAI公式と同一であると明記されています。価格一覧表にある官转の画像モデルは
gpt-image-2.6-flare、gpt-image-2.6-sunburst、gpt-image-2.5-flare、gpt-image-2.5-sunburst、および両者の日付スナップショットgpt-image-2.5-flare-2026-09-08とgpt-image-2.5-sunburst-2026-09-08、さらに前世代のgpt-image-2です。ドキュメントでは、テキストから画像生成にはflareを、編集や複数画像の融合にはsunburstを優先するよう推奨しています。本番環境では日付スナップショットを固定しておけば、エイリアスの参照先が変わるのを防げます。 - 官逆 -all：ChatGPT Web版をリバースしたものです。
gpt-image-2-allとgpt-image-2.5-allは同価格・同挙動で、相互に置き換え可能です。これはChatGPT Web版がすでにImages 2.5へ全面的にアップグレード済みで、gpt-image-2-allが出力するのも2.5の画像だからです。ドキュメントでは、新規プロジェクトではgpt-image-2.5-allをそのまま使うことを推奨しています。 - 官逆 -vip：Adobeのリバースライン（Firefly）で、モデルは
gpt-image-2-vip、gpt-image-2.5-flare-vip、gpt-image-2.5-sunburst-vipです。エイリアスgpt-image-2.5-vipはgpt-image-2.5-sunburst-vipを指します。 - 企业分组
image2Enterprise：官转におけるOpenAI上流の企業向けフォールバックグループです。FAQでは、Google Vertexではなく、生成時間を短縮する加速ラインでもないと明確に説明されています。役割は、デフォルトグループが混雑したときに別のリソースプールを提供することですが、上流が常に利用可能であることを保証するものではありません。
もう1つ、フォールバックだと誤解されやすいグループに image2_OSS があります。これは1倍（追加料金なし）のグループで、用途はただ1つ、返却URLを保証してbase64への降格を防ぐことです。安定性を高めるものではなく、-all と -vip に適用されます。
2.6 は現在、官转バージョンのみです。2026-11-10 の価格一覧表と価格取得APIのいずれにも、gpt-image-2.6-all、gpt-image-2.6-vip あるいは類似の名前は存在しません。モデルと価格はプラットフォームのモデル一覧を基準にしてください。
シーン別にデフォルトの画像チャネルを選ぶ：価格と機能の対照表
チャネルを選ぶときは、まず次の3つのポイントを確認します。公式の画質グレードが必要か、サイズの要件がどれだけ厳しいか、コストを1枚あたりで上限固定したいかどうかです。以下の順番で判断するとよいでしょう。
- バッチ画像生成、1枚あたりのコストを上限固定、サイズの長辺が512〜1536の範囲：
gpt-image-2.5-allを使います。検収基準は、返された画像の実際の幅・高さが想定どおりであること、そしてコンソールの毎回の課金額が「単価 × 呼び出し回数」と一致することです。 - 30段階の中から固定サイズを指定したい、または2K・4Kが必要：-vipモデルに切り替え、
sizeを明示的に渡します。検収基準は、リクエストパラメータだけで判断せず、返された画像の実際の幅・高さを基準にすることです。 - 公式の
quality、maskによる部分的な再描画、透明背景、任意の有効サイズが必要、またはOpenAIのフィールドと揃えたい：公式転送（官転）を使います。新規プロジェクトでは2.6を使い、挙動を固定したいときは日付付きの2.5スナップショットを使います。検収基準は、リクエストフィールドが対象モデルの公式パラメータ表と一致し、400エラーが発生しないことです。
画像チャネル価格対照表
以下の課金と表示価格は価格一覧表（2026-11-09 更新）によるもので、すべて割引前の表示価格です。チャージ時の10%〜20%のボーナスが加わると実際の請求額はさらに下がります。最終的な金額はコンソールでご確認ください。完全なモデル名と価格は docs.apiyi.com/models をご覧ください。
| モデル | チャネル性質 | 課金 | 表示価格（割引前） | 利用可能なグループ |
|---|---|---|---|---|
gpt-image-2.6-flare / gpt-image-2.6-sunburst |
公式転送（2026-11-05 公開） | 従量課金 | 100万トークンあたり：テキスト入力 5、画像入力 8、出力 30 ドル | Default、image2Enterprise、image2_OSS、SVIP |
gpt-image-2.5-flare / gpt-image-2.5-sunburst および 2026-09-08 スナップショット |
公式転送 | 従量課金 | 同上、キャッシュ読み込みはテキスト 1.25、画像 2 ドル | Default、image2Enterprise、image2_OSS、SVIP |
gpt-image-2 |
公式転送（前世代） | 従量課金 | 同上 | Default、image2Enterprise、image2_OSS、SVIP |
gpt-image-2.5-all / gpt-image-2-all |
公式リバース ChatGPT Web版 | リクエスト単位 | 0.025 ドル/回 | Default、image2_OSS、SVIP |
gpt-image-2.5-vip など 4 つの -vip 名 |
公式リバース Adobe Firefly | リクエスト単位 | 0.03 ドル/回 | Default、image2_OSS、SVIP |
価格APIと価格一覧表には 1 か所食い違いがあり、分けて見る必要があります。 価格APIでは、gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst の quota_type が 1、model_price が 0.2 です。一方、gpt-image-2.6-flare、gpt-image-2.6-sunburst、および 2 つの 2026-09-08 スナップショットは quota_type が 0、model_price が 0 です。価格一覧表では、これらの公式転送モデルはすべて従量課金と記載されています。本記事の表示価格は価格一覧表の従量課金ベースに従い、0.2 をリクエスト単価としては扱いません。注文前に、コンソールでそのグループの実際の割引後価格をご確認ください。-all の 0.025 と -vip の 0.03 は 2 つの情報源で一致しているため、リクエスト単価として使えます。
公式転送の 1 枚あたりのコストは出力トークン数によって決まります。比較ページ（ドキュメントの記述）が示す典型的なレンジは 1 枚あたり約 0.03〜0.2 ドルで、プロンプトが長いほど、size と quality が高いほどコストが上がります。ドキュメントには 2026-09-09 の概算例があり、1024 の正方形画像を 2.5 の xhigh で生成すると約 0.094 ドル（出力 3122 トークン）、max では約 0.211 ドル（出力 7024 トークン）で、通常 0.001 ドル未満の入力は含みません。ドキュメントの結論は、1K の low スケッチなら公式転送が必ずしも高いとは限らず、中〜高画質こそ 0.025〜0.03 ドルの公式リバースが割安になる領域だというものです。
もう 1 つ、古い価格について注意点があります。ヘルプセンターの 2026-04-25 の古い記事では gpt-image-2-all を 0.03 ドル/回と記載していますが、それは値下げ前のデータです。-all は 2026-10-10 に 0.025 ドルへ値下げされ、2 つの -all 名も同時に調整されました。ドキュメントが示す値下げ理由は、-all のほうが -vip より安定しており、-vip はメーカー側のリスク管理の影響で変動が大きいものの、現在も保守中で通常どおり利用可能だというものです。
画像チャネル機能比較表
| 機能 | 公式リバース -all | 公式リバース -vip | 公式転送 |
|---|---|---|---|
size |
専用ページ：長辺 512〜1536 の一般的な幅×高さ。16 の倍数でないものも含む。2K は明示的なサポート対象には含まれない | 30 パターン（10 種類のアスペクト比 × 1K/2K/4K）。images エンドポイントでのみ有効 | 任意の有効なサイズ。辺長は 16 の倍数、アスペクト比は 3:1 以下。プリセットには 3840×2160 を含む |
quality |
非対応 | チャネルの挙動に依存し、保証なし。2.5 の 2 モデルは 2026-09-10 の再テストで max まで確認、gpt-image-2-vip は high まで |
公式が保証するグレード。xhigh/max は 2.5 の 2 モデル限定（比較ページ） |
n |
非対応。指定しても n 倍で課金されます | 非対応。1 回 1 枚 | 対応 |
| マスク | 画像全体の再描画のみ | 画像全体の再描画のみ | mask による部分再描画に対応 |
| 透明背景 | background なし。プロンプトに記述するのみ |
alpha PNG を出力可能。ドキュメントでは保証なし | 2.5 は対応。gpt-image-2 は提供終了 |
| 速度（ドキュメント記載） | 専用ページ約 30〜60 秒、比較ページ約 90 秒 | gpt-image-2-vip 90〜150 秒、flare-vip 22〜138 秒、sunburst-vip 37〜120 秒 |
2026-09-09 時点で 2.5-flare 1K low は約 10 秒、sunburst は約 14 秒。gpt-image-2 は 100〜120 秒 |
-all の速度については、2 つのドキュメントで記述が異なります。専用ページは約 30〜60 秒、比較ページは約 90 秒です。本記事では両方の数値を併記し、平均は取りません。-all の size もドキュメント間で記載が同期していません。専用ページには「size に対応済み」とあり、比較ページには非対応と書かれています。本記事では専用ページの記載を優先します。専用ページでは、1536 の正方形画像は補間されている可能性があり、ネイティブなディテールを示すものではないとも説明されています。2.6 の「生成速度 50% 向上、Flare の低画質で最速 6 秒」は、2026-11-05 のリアルタイム更新で伝えられた公式発表によるもので、プラットフォームの再テストデータではありません。2.6 の新しいパラメータ（complexity、SVG、GIF など）は OpenAI 公式ドキュメントを基準とし、2.5 のパラメータ表をそのまま適用することはできません。
4K のニーズが多い場合は、-all 専用ページでもう 1 つの選択肢として、APIYI 上の Nano Banana が挙げられています。料金一覧表では、nano-banana-pro と gemini-3-pro-image シリーズが 1 回 0.09 ドル、nano-banana-2 と gemini-3.1-flash-image が 1 回 0.055 ドルです。このルートのエンタープライズグループは NanoBananaEnterprise と NanoBananaReverse で、image2Enterprise と混用できません。
画像チャネルのトークンタイプとグループ優先度の設定方法
多くのエラーは実はチャネル自体の問題ではなく、トークンタイプやグループの設定ミスが原因です。すべてのチャネルは同じBase URL https://api.apiyi.com/v1 を使用します。エンドポイントは /v1/images/generations と /v1/images/edits を推奨します。トークンタイプのルールで特に覚えておくべきは1つだけです。公式転送には必ず「従量優先」を使う。回数課金トークンで公式転送を呼び出すと、課金方式が一致しないため拒否されます。-all と -vip は「回数課金」でも「従量優先」でも構いません。
| グループ | 倍率（料金API 2026-11-10） | 対象チャネル | 用途 | 注意 |
|---|---|---|---|---|
Default |
1 | 公式転送、-all、-vip | デフォルトの第一選択 | 公式転送はピーク時に同時接続が逼迫し、429が出ることがある |
image2Enterprise |
1.2 | 公式転送のみ | OpenAI上流のエンタープライズバックアップ | 高速化ラインでもVertexでもない。-all と -vip はこのグループに含まれない |
image2_OSS |
1 | 公式転送、-all、-vip | URL出力を保証 | 安定性は向上しない。URLは約24時間で失効 |
SVIP |
APIでは1、コンソールのトークンページを優先 | 公式転送、-all、-vip | コンソールの説明に従う | 2026-10-29から期間限定倍率キャンペーン終了 |
企業グループの1.2倍について、ドキュメントでは「3000ドルの一括チャージ大口顧客への20%加算後、ほぼ公式サイトの原価に等しくなる」ように設定しており、プラットフォームは税務コストを計上していない、と説明されています。このグループでどのモデルが見えるかについて、FAQ本文の表には gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2 が記載されています。価格一覧表と料金APIの enable_groups では2.6の2モデルも含まれていることが示されていますが、FAQの表はまだ同期されていません。このグループに別途申請が必要かはドキュメントに記載がありません。選択できない場合はコンソールの表示に従ってください。
推奨の設定方法は「1つのトークンで2種類のモデルをカバーする」です。1つのトークンにはデフォルトグループを1つ、フォールバックグループを最大2つ設定できます。ドキュメントの設定方法に従い、第一優先度を image2Enterprise、デフォルトグループを Default にします。これにより公式転送のリクエストは優先的に企業グループを通り、-all と -vip は企業グループに含まれないため Default に留まり、正常に画像を生成します。具体的な操作は、api.apiyi.com/token を開き、トークンを編集し、グループを選択して保存するだけです。コードの変更は不要です。検収基準は、同じリクエストで公式転送モデルと -all モデルをそれぞれ1回呼び出し、両方とも画像が生成でき、コンソールで公式転送の分が1.2倍で課金されていることです。
URLに強く依存する業務は別途対応が必要です。デフォルトグループでは、2026-07時点のドキュメント記録として、response_format を指定しないと b64_json が返ります。明示的に response_format を url にするとリンクを取得できますが、デフォルトグループは出力形式を保証しません。このような業務ではトークンを image2_OSS に切り替え、同時に明示的に url を指定し、リンクを取得したらすぐにダウンロードして転存してください。検収基準は、レスポンスに url フィールドがあり、転存後のファイルが開けることです。
画像生成時に429、飽和、ベンダー障害が起きたときのフォールバック方法
同じエラーでも、その背景にある原因はまったく異なる場合があります。そのため最初のステップは、エラーボディ内の error.message を読み、それから対処方法を決めることです。-vip 専用ページでは、429を「パラメータ拒否」と「グループ飽和」の2種類に分けています。-all 専用ページでは、429を「レート制限またはクォータ不足」と大まかに説明しています。リアルタイム速報には、ChatGPTウェブ版とOpenAI上流という2種類のベンダー障害も記録されています。以下の表は、これらの状況を「どんなエラーが出たら、まず何をするか」という形で整理したものです。
| 表示される内容 | 判断 | まず行うこと | 受け入れ基準 |
|---|---|---|---|
| 公式中継がDefault上で429が継続、または飽和の表示 | デフォルトグループの輻輳 | api.apiyi.com/token でグループを image2Enterprise に切り替える、またはその優先度を上げる（モデル名は変更しない） |
同じリクエストで画像生成でき、課金が1.2倍になる |
-vipが429を返し、messageが quality must be one of… のような内容 |
パラメータ拒否 | パラメータを変更する。そのままリトライしない | 変更後の最初のリクエストで成功する |
| -vipが429を返し、messageが「現在のグループ上流負荷が飽和」 | 一時的な飽和 | 指数バックオフでリトライし、同時にリアルタイム速報を確認 | 限られた回数で回復。回復しなければ公式中継に切り替え |
| -all/-vipで当日集中的にエラー、リアルタイム速報にベンダー障害の告知あり | ChatGPTウェブまたはAdobeのベンダー障害 | バックオフを中止し、モデル名を変えて公式中継に切り替え | 公式中継のリクエストが成功し、トークンが従量優先である |
公式中継のエンタープライズグループが The server had an error while processing your request. を返す |
OpenAI上流障害 | 1〜2回リトライ。それでも不可なら逆方向中継に切り替え | -all に切り替えた後、画像生成できる |
| 401 | トークンの問題 | トークンを確認する。リトライしない | 正しいトークンに変更して回復 |
gpt-image-2 で background を transparent にして400が返る |
公式がその機能を停止済み | 透過背景は2.5公式中継とpngまたはwebpの組み合わせに変更 | 返却画像にアルファチャンネルが付く |
ベンダー障害を疑う場合は、まず docs.apiyi.com/live で当日に対応する告知がないかを確認し、それからバックオフするかチャンネルを切り替えるかを決めます。逆方向中継から公式中継への切り替えは簡単です。APIYI 上で同じトークンを使い、モデル名だけを変更すれば完了します。比較ページの原文は「model名を変更するだけで公式中継に切り替えられる」です。ただし、次の2つの前提を項目ごとに確認する必要があります。
- トークン種別：トークンが「従量優先」であることを確認してください。回数課金のトークンの場合、リクエストは拒否されます。
- 対象モデルに合わせたフィールドの削減：
gpt-image-2に切り替える際は、xhigh、max のティアと透過背景を外します。-all から持ち込んだ16の倍数でないサイズは、16の倍数に変更し、比率が3:1を超えないようにします。逆方向に公式中継から-allに戻す場合は、quality、n、aspect_ratio、maskを削除します。 - タイムアウト：公式中継の低画質・中画質は240秒、highとxhighは300秒、maxおよび
gpt-image-2のhighは600秒をフォールバックとして設定します。-all と -vip は保守的に300秒に設定します。入力画像はまず1.5MB以内に圧縮してください。
2026年4月から11月までの過去告知に基づく判断表
以下は「どのような障害が起き、当時どう対応したか」を示すための事例です。2026-11-10 時点の現状を表すものではありません。現在飽和しているかどうかは、その時点のエラーボディとリアルタイムの状況で判断してください。
| 日付 | イベント（過去の告知） | 当時の対応 | 現在の使い方 |
|---|---|---|---|
| 2026-04-29 | 公式中継のデフォルトグループで依然として 429 が発生。image2Enterprise のみ安定しており、-all と -vip も安定していた | 公式中継の企業グループを使用 | 「公式中継デフォルトグループの輻輳」の典型例として |
| 2026-05-07 | 公式中継の企業グループでも server error が返り、根本原因は OpenAI 上流 | 上流の復旧を待つか、チャネルを切り替える | 企業グループでも上流が常に利用可能とは限らない |
| 2026-05-13 | デフォルトグループが飽和。image2Enterprise では引き続き画像生成可能 | 企業グループに切り替え | 優先度設定の構成を裏付ける |
| 2026-05-23 | デフォルトグループにリソースが追加され、ドキュメントには「わざわざ企業グループへ切り替える必要はない」と記載 | Default に戻す | 輻輳は一時的なもの |
| 2026-09-21 | 2.5 の公式中継デフォルトグループは同時実行数が逼迫し、企業グループは安定 | 企業グループに切り替え | 同上 |
| 2026-10-15 | gpt-image-2-vip の負荷が過大。-all は ChatGPT Web のベンダー側障害によりエラー。gpt-image-2 の透明背景は提供終了（比較ページでは 2026-09-30 と記載） |
公式リバースはまず公式中継でフォールバック。透明背景は 2.5 の公式中継に変更 | ベンダー側障害時はチャネルを切り替えるべきで、固執しない |
| 2026-11-05 | 2.6 の公式中継が提供開始、Default グループが利用可能 | 新規プロジェクトで利用可能 | これはリリース告知であり、障害告知ではない |
画像生成のエラー：再試行すべきケースとそうでないケース
再試行すべきかどうかの判断基準はただ一つ、エラーの原因が時間の経過とともに自然に解消するかどうかです。負荷由来の 429、5xx、タイムアウトは自然回復する可能性があるため、限られた回数のバックオフ付き再試行を行えます。一方、パラメータエラー、トークンエラー、コンテンツ拒否は自然には解消しません。そのまま再試行しても時間を無駄にするだけで、余分に課金されることもあります。2026-08-25 の運用記録にある「429 は再試行可、コンテンツ安全は再試行不要」という方針も、この基準と一致しています。
- バックオフ付き再試行が可能：負荷由来の 429 には指数バックオフを使います。5xx は 1～2 回再試行します。タイムアウトの場合は、まずクライアント側のタイムアウトを推奨値に設定します。調査に役立つよう、レスポンスヘッダーの
request-idを記録しておきましょう。-vip のドキュメントには、RPM 500 以内ならまず並行処理の問題を考える必要はないと記載されています。 - 修正してから再送信：パラメータが拒否された場合は、まずパラメータを修正します。401 ならまずトークンを確認します。400 なら対象モデルのフィールド表と照合します。認証失敗とパラメータ検証失敗は課金されません。
- 自動再試行は不要：コンテンツ拒否には 2 種類あります。1 つは「期待どおりに画像が生成されませんでした。プロンプトを調整して再試行してください」のような明確なエラーを返すケースです。これは課金されないため、プロンプトを修正すべきです。もう 1 つは 200 を返すものの、レスポンス本文が「このリクエストには対応できません」のようなソフト拒否になっているケースです。プロトコル上は正常な返却として扱われ、課金されます。提供元でもプロトコル層で事前に判別することはできません。同じプロンプトを自動で再送信しないでください。
質問：-all に n=4 を渡したのに、なぜ1枚しか取得できず、しかも4回分課金されたのですか？
-all は n を受け付けませんが、渡してしまうと n 倍の課金が発生します。専用ページの例では n=3 で 0.075 ドル課金され、それでも返ってくる画像は1枚だけです。N 枚必要なときは、N 回並列で呼び出してください。合格基準は「コンソール上の課金回数が、実際に取得できた画像枚数と等しいこと」です。
質問：比較ページには -all は size を受け付けないと書かれていますが、実際は渡せるのですか？
-all 専用ページの記述を優先してください。size は渡せます。明示的に渡した size はプロンプト内のサイズ記述より優先され、渡さない場合や auto を渡した場合は元の動作を維持します。比較ページはまだ更新が反映されていないだけです。
Q：企業グループを使うと画像生成が速くなりますか？
いいえ。FAQにもはっきり書かれていますが、これは高速化用の回線ではなく、デフォルトグループが混雑しているときに別のリソースプールを提供するだけの役割です。公式転送モデルはDefaultグループに置けば問題ありません。
Q：料金APIにある公式転送の0.2は従量課金の単価ですか？
そう解釈すべきではありません。料金一覧表では従量課金と表示されており、本記事も従量課金を基準にしています。APIは日付のない一部のエイリアスに対して model_price 0.2 を返しますが、この2つの基準は一致していないため、注文前にコンソールで実際の割引後価格を確認してください。
質問：2.6 に -all や -vip バージョンはありますか？
2026-11-10 時点の価格一覧表および料金APIには存在せず、本記事でも提供開始時期についての推測は行いません。
そのまま使えるデフォルト設定
- モデル名：
gpt-image-2.5-all。サイズ指定や 4K が必要な場合はgpt-image-2.5-vipに変更します。公式パラメータが必要な場合はgpt-image-2.6-flareまたはgpt-image-2.6-sunburstに変更します - グループ：第一優先は
image2Enterprise、デフォルトグループはDefault。URL に強く依存する業務では別途トークンを作成し、image2_OSSを使用します - トークンタイプ：従量課金優先（官転・官逆のどちらでも呼び出せます）
- タイムアウト秒数：-all/-vip は 300 に設定。官転は低画質・中画質が 240、high/xhigh が 300、max が 600
- Base URL：
https://api.apiyi.com/v1
この設定で運用を開始したら、普段は 2 点だけに注意を払えば十分です。エラーレスポンス内の error.message に何が書かれているか、そして当日のリアルタイム情報に関連する告知が出ていないか。上記の 2 つの表を参照すれば、バックオフしてリトライすべきか、リクエストを修正すべきか、それとも経路を切り替えるべきかを判断できます。
作者：APIYI 技術チーム
技術交流：本文でカバーされていないエラーに遭遇した場合は、APIYI 公式サイトのトップページからお気軽にお問い合わせください。その際、request-idと完全なエラーレスポンスを添えてください。
