Skip to main content
size パラメータが再び利用可能になりました(2026-07-22 更新): size を明示的に渡すと、期待どおり出力寸法がロックされ、このページの 30 サイズ参照表も再び有効になります。注意: size/v1/images/generations/v1/images/edits エンドポイントでのみ動作します — /v1/chat/completions のチャット エンドポイントは size パラメータをサポートしていないため、チャットベースの画像生成では寸法をロックできません。最新の状態は 最新の更新情報 セクションを参照してください。
すべての画像 API は 同期式 です — ポーリングする task ID はなく、クライアントが切断されると、リクエストはまだ課金されていても結果は失われます。このモデルでは十分に長いタイムアウトを設定してください。詳細は Image API の基本事項とベストプラクティス を参照してください。

概要

gpt-image-2-vip は、Codexライン上の GPT画像生成リバースエンジニアリングモデル で、APIYIプラットフォームで利用できます。 gpt-image-2-all と同じ定額の $0.03/image で、リクエスト/レスポンス形式も同一 です。実質的な違いは、vipsizeフィールド を受け付け、30種類の一般的なサイズ(10のアスペクト比 × 3つの解像度レベル: 1K Fast / 2K Recommended / 4K Detail) に対応していることだけで、4Kも含みます。
🎨 位置づけ: 出力サイズを固定したいときは gpt-image-2-vip を使ってください(Eコマースのヒーローショット、ポスターテンプレート、動画サムネイル、4K壁紙など)。model フィールドを gpt-image-2-vip に差し替えて、size フィールドを追加するだけです — それ以外のコード行はすべて gpt-image-2-all と同じです。

テキストから画像生成 API

/v1/images/generations — テキストプロンプト + size で明示的な出力サイズを指定します。

画像編集 API

/v1/images/edits — 編集/融合指示付きの multipart アップロードです。

gpt-image-2-all との主な違い

gpt-image-2-vipgpt-image-2-all はどちらもリバースエンジニアリングされたチャネルで、価格も呼び出しコードも同じです。互いに鏡像のような存在です — 同じリクエストで model フィールドを切り替えるだけで、挙動はほぼ同一です。違いは次のとおりです。
一言での判断: 厳密なサイズは不要で、最速の出力がほしいgpt-image-2-all; 固定サイズまたは 4K が必要gpt-image-2-vip; quality ノブや厳密な OpenAI-API フィールド互換性が必要 → 公式の gpt-image-2 を使ってください。

主な機能

出力サイズ固定

sizeフィールドは30種類の一般的なサイズに対応します — eコマースのヒーロー画像、ポスターテンプレート、4K壁紙などを、すべて正確なピクセルで出力します。

4K高解像度

4K Detailティアは 2880×2880 / 3840×2160 / 3840×1632 などをカバーし、大きな納品物に適しています。

全サイズ一律料金

1K / 2K / 4K はすべて $0.03/画像で、4K の追加料金はありません。

-all と同じ呼び出し形式

リクエスト構造、フィールド、レスポンス形式は gpt-image-2-all と同一です — model 文字列だけでモデルを切り替えられます。

高品質テキスト描画

中国語/英語のテキスト、看板、ポスターテキストを安定して描画 — インフォグラフィックやマーケティング素材に最適です

中国語の説明を翻訳なしでそのまま理解

翻訳なしで中国語の説明をネイティブに理解

自然言語編集

会話形式の説明で編集でき、マスクは不要。複数ターンの反復にも対応します

標準エンドポイント対応

OpenAI Images API の標準エンドポイント /images/generations/images/edits に対応

価格

課金に関する注記:
  • 30種類すべてのサイズで一律 $0.03/image — 4K Detail への追加料金はありません
  • 失敗したリクエストは課金されません(認証失敗、パラメータ検証エラー)
  • N枚の画像が必要な場合は、APIをN回並列で呼び出します

グループ設定

gpt-image-2-vipDefault グループ上にあります — 追加のグループは不要です。リバースチャンネルには現在安定した供給があるため、公式リレー gpt-image-2 のようなエンタープライズグループへのフォールバックの話はありません。

決定的なURL出力が必要ですか → image2_OSS グループに切り替えてください

2026年7月にデフォルトグループで計測したところ、gpt-image-2-vip(および gpt-image-2-all)は b64_json を返します。response_format を省略した場合は、画像URLを取得するには response_format: "url" を明示的に渡してください。デフォルトグループの出力形式は保証されません — これまで高負荷時には url が既定で、b64_json にフォールバックしており、チャネルのバージョンによっても変更されてきました。 ビジネスがURL出力に依存している場合(URLをそのままデータベースに書き込む、フロントエンドでURLからレンダリングする、base64 は受け入れられないなど)は、トークンのグループを image2_OSS に切り替えてください。これは 決定的なURL出力 のために特別に設計されたグループで、1倍のレート倍率(追加料金なし) で、リバースモデル gpt-image-2-vipgpt-image-2-all の両方に有効です。応答には常に画像URLが含まれ、base64 にフォールバックすることはありません。
トークン作成画面: 課金モードは従量課金を先に、グループ image2_OSS(1倍のレート倍率)、画像URLを出力するグループ、gpt-image-2-all と gpt-image-2-vip に適しています

Token creation: set billing mode to "pay-as-you-go first" and pick the image2_OSS group (1x) — use it when you need deterministic URL output

上級編(gpt-image-2-all と 公式リレー gpt-image-2 も使う場合): トークンがこの3モデルすべてをカバーするなら、トークンのグループ優先順位を次のように設定してください。
  • 第一優先: image2Enterprise(1.2倍のエンタープライズグループ、公式リレー専用の安定レーン)
  • デフォルトのフォールバック: Default(2つのリバースモデルはどちらもここにあり、モデルごとにルーティングされます)
結果として、公式リレー gpt-image-2 は安定性のためにエンタープライズレーンを使い、2つのリバースモデルはデフォルトグループにとどまります。1つの token で3つすべてをカバーでき、干渉はありません。
📖 image2Enterprise グループについて: /en/live/2026-04/image2-enterprise-stable

技術仕様

⏰ 画像URLの有効期限: 約1日(デフォルト)urlフィールドはurlモード応答内のR2 CDNリンクで、約24時間で期限切れになります — それ以降のリクエストは404になります。長期保存が必要な画像は、生成後できるだけ早くダウンロードして自分のストレージに保存するか、b64_json応答形式を使用してください。

エンドポイント

gpt-image-2-vip は、gpt-image-2-all とまったく同じ 2 つのエンドポイントに対応しています。必要に応じて、model フィールドを入れ替えて、size を追加するだけです:
OpenAI Images API を使う/v1/images/generations + /v1/images/edits)ことをおすすめします。理由は 2 つあります:
  1. より安定: Images API チャネルの上流リソース供給がより豊富なため、呼び出し成功率が高いです
  2. 公式リレーとの互換性が高く、切り替えが簡単: 呼び出し方法や size のようなパラメータは公式リレー gpt-image-2 と完全に互換です。リバースチャネルがレート制限の揺らぎに遭遇した場合でも、model の名前を入れ替えるだけでコード変更は不要です
チャットベースのエンドポイント(/v1/chat/completions、現在は非推奨)もあります。詳細は下の FAQ をご覧ください。
ドメインの選択肢: api.apiyi.com がメインドメインです。b.apiyi.com / vip.apiyi.com のような代替ゲートウェイドメインも使用できます。レスポンスの挙動は同一です。

対応サイズ(30サイズの完全版表)

gpt-image-2-vip10種類のアスペクト比 × 3つの解像度ティア = 30サイズ をサポートします。size: "WIDTHxHEIGHT"(小文字ASCIIのx)をリクエストボディに直接指定してください。

1K 高速 — 下書きと低コストの反復

2K 推奨 — デフォルトのティア(本番出力の大半)

4K 詳細 — 大型納品物

30サイズすべてで均一料金: $0.03/画像。4K Detail に追加料金はありません。
ティアの選び方:
  • 1K 高速 — 下書き、サムネイル、A/Bテスト。最速で出力できます(価格は均一ですが、反復サイクルは短くなります)。
  • 2K 推奨デフォルトのティア。eコマースのヒーローショット、ポスター、インフォグラフィックなど、本番出力の大半をカバーします。
  • 4K 詳細 — 印刷、大型ディスプレイ、動画サムネイル、デスクトップ / 屋外向け大型フォーマット。
最小呼び出し例size のみを指定し、quality は指定しないでください):

ベストプラクティス

1

入力画像は 1.5MB 未満に圧縮してください(画像編集 / 複数画像融合)

アップロードする各画像は 1.5MB 未満 に圧縮してください(JPEG 品質 80-90 / 解像度を下げる)。複数画像融合でも、画像ごとに同じ上限を適用します。まれに発生する shell_api_error / Unknown error のレスポンスは、ほとんどの場合、入力が大きすぎることが原因です — 圧縮すると成功率とレイテンシが目に見えて改善します。出力解像度は入力サイズではなく size フィールドで決まります — 入力を小さくしても速くなるだけで、品質は下がりません。4K / 8K を prompt に詰め込んでも 4K 画像にはなりません。解像度は prompt の飾りではなく、size で決まります。
2

成果物に応じてサイズ階層を選ぶ

1K Fast は下書き向け、2K Recommended は本番向け、4K Detail は印刷 / 大型ディスプレイ向けです。料金は一律です — 必要に応じて選んでください。
3

サイズには小文字の ASCII x を使う

"size": "1536x1024" を送信してください — 1536×1024 ではなく、大文字の X でもありません。
4

quality や n は渡さない

quality は受け付けられません。n は 1 回の呼び出しにつき 1 枚しか返しません — 複数画像が必要な場合は並列で呼び出してください。
5

300s のタイムアウトを使う

通常の生成は 90–150s ですが、画像のアップロード / ダウンロード時間やピーク時のテールレイテンシでさらに長くなります。保守的な基準として 300s を設定してください。
6

必要に応じてレスポンス形式を選ぶ

直接の Web 表示には b64_json を使い、サーバー側での保存 / 転送には url を使ってください。
7

コードは -all で共有する

同じコードで両方に対応できます — 必要に応じて modelgpt-image-2-allgpt-image-2-vip の間で切り替えてください。サイズを固定したい場合は vip を使い、最速で反復したい場合は -all に戻してください。

エラーコードとリトライ

クライアントの推奨設定:
  • Request timeout は 300秒から にしてください(保守的です。通常は90〜150秒ですが、4K Detail + ピーク時のロングテールではさらに長くなります)
  • 5xx と timeout には 指数バックオフ を使用してください(2〜3回のリトライを推奨します)
  • デバッグ用に request-id response header をログに記録してください

よくある質問

はい、ほぼ同じです。 両方のエンドポイント(/v1/images/generations, /v1/images/edits)は、リクエストフィールド、レスポンスフィールド、そして b64_json の prefix 挙動を共有しています。違いは次の 2 点だけです。
  1. model フィールド: gpt-image-2-vipgpt-image-2-all
  2. size フィールド: vip は 30サイズセットを受け付けますが、-all は size を拒否します(サイズは代わりに prompt に入ります)
実践的なパターン: 1つのコードベースに if model == 'vip': payload['size'] = ... スイッチを用意してください。
gpt-image-2-vip は Codex のリバースチャネルを使っています — 典型的には 90〜150 秒で、公式の gpt-image-2(100〜120 秒)と同程度であり、ChatGPT-web-line gpt-image-2-all(30〜60 秒)より遅いです。レイテンシーに敏感なワークロードでは、gpt-image-2-all を優先し、vip は固定サイズまたは 4K が必要なときだけ使ってください。
はい — 30サイズセットに従ってください。 リスト外のサイズは upstream の invalid_request_error を引き起こす可能性があります。納品物に最も近いティアを選んでください。
症状: 4K Detail ティア(例: 3840x2160 / 2880x2880)では、status_code: 500 エラーが発生しやすく、上流は invalid_request_error を返します。
根本原因: OpenAI の計算リソースの変動 — リクエストパラメータの問題ではありません。同じペイロードは通常 2K では通ります。Codex のリバースチャネルは 4K のような大きな出力により敏感で、特にピーク時間帯に起こりやすくなります。対策(コスト効率順):
  1. 2K Recommended を優先する(例: 2048x1360 / 2048x2048)— 成功率が大幅に高く、料金は同じ $0.03/image
  2. 入力画像数を減らす: img2img / multi-image fusion では、Codex のリバースチャネルが大量の入力負荷に弱く、4K の失敗率がさらに上がります。各入力画像を 1.5MB 未満に事前圧縮するのも有効です
  3. 4K を確実にしたい場合 — 公式プロキシ gpt-image-2 + image2Enterprise グループ に切り替えてください。公式プロキシの 4K は高め(約 $0.3+/image)ですが、かなり安定しており、4K 納品が絶対条件の場面に適しています。
📖 現場メモ: /en/live/2026-05/gpt-image-2-vip-4k-tips
はい、強く推奨します。 各入力画像を 1.5MB 未満(JPEG 品質 80-90 / 解像度縮小)に圧縮してください。散発的な shell_api_error / Unknown error 応答は、過大な入力が最も多い原因であり、圧縮すると成功率とレイテンシーが目に見えて改善します。注: 1.5MB は信頼性と速度のための推奨上限であり、上の FAQ にある 10MB はゲートウェイのハード上限です。圧縮で品質が落ちる心配はありません — 出力解像度は size パラメータで決まり、入力サイズでは決まりません。入力を小さくすると、単に処理が速くなるだけです。prompt に 4K / 8K を詰め込んでも、実際に 4K 出力にはなりません。 prompt に 8K ultra HD と書いていても、size1024x1024 に設定していれば、出力は依然として 1K 品質の画像になります。4K にするには size フィールドで設定してください — 1K / 2K / 4K は 30サイズセット全体で一律 $0.03/image です。📖 出典: /en/live/2026-05/gpt-image-2-vip-unknown-error
追加料金はありません。 4K Detail ティア(3840x2160 / 2880x2880 など)も、1K や 2K と同じ $0.03/image です。
いいえ。 このモデルは 1 回の呼び出しにつき 1 枚の画像を返します。複数画像が必要な場合は、繰り返し / 同時呼び出し を使ってください。⚠️ 重要: リクエストで n=3 を渡すと、課金は 0.03 × 3 = $0.09 になりますが、実際に返る画像は 1 枚だけです。無駄な課金を避けるため、n フィールドは外してください。
これは、同期的な chat 風レスポンスを使うリバースエンジニアリング済みチャネルです。結果は異なる課金ルールを持つ 2 つのケースに分かれます。1) HTTP 5xx が返る → 課金されません上流のコンテンツポリシーがリクエストを厳格にブロックすると、次のようになります。
これらのハードエラーは課金されません。ユーザーに prompt の調整を依頼して再試行してください。2) HTTP 200 で text の「ソフト拒否」→ 課金されますモデルが会話の中でソフト拒否する場合(例: 「I can’t do that」, 「すみません、このリクエストには…が含まれます」)、プロトコル上は通常の chat completion に見えるため、課金されます。リバースチャネルはプロトコル層では「拒否テキスト」と「画像出力」を信頼性高く区別できません。なぜソフト拒否を単純に免除できないのかすべてのソフト拒否を自動で免除すると、プラットフォームが失敗した上流呼び出しをすべて負担することになります。さらに重要なのは、上流のコンテンツ安全性を頻繁に引き起こすと、供給元アカウントが BAN されるリスクも高まることです。これは実際の供給側コストであり、完全には消せません。統合側への推奨事項
  • 事前フィルタとユーザー警告: フロントエンドまたはゲートウェイでキーワード / シナリオフィルタ(実在の人物名、著作権キャラクター、センシティブな話題)を追加し、「有名人 / IP 系の話題は失敗することがあり、上流のポリシーにより課金される場合があります。」のような UI ヒントを表示してください。これにより無駄な課金を大幅に減らせます。
  • コンシューマー向け製品では月次補填: コンシューマー向け製品では、ユーザー入力を完全には制御できないことを理解しています。月間支出が十分大きい($1000+/month)場合は、ログを月次でまとめて(短レイテンシーの呼び出しは通常ソフト拒否です)サポートに連絡し、一度限りの手動クレジットを依頼できます。呼び出しごとに異議申し立てをする必要はありません。
📖 関連: 500 エラーは通常コンテンツポリシーに引っかかったケースです(課金されません)
まず判定してから処理してください。 2026 年 7 月時点の検証では、返される b64_jsondata: プレフィックスのない生の base64 です。ファイルに書き出すにはデコードし、描画前に自分でプレフィックスを付けても構いません。以前のバージョンにはプレフィックスが含まれていました。コードに startsWith('data:') チェックを追加してください。プレフィックスがある場合は、値をそのまま img src として使い、ない場合は先にデコードするかプレフィックスを付けてください。これにより、プレフィックスの二重付与や、プレフィックス付き文字列をデコードして壊れた画像にしてしまうことを防げます。
推奨は 1画像あたり ≤ 10MB、フォーマットは png / jpg / webp です。大きすぎる画像はゲートウェイの制限に達する場合があります。複数画像融合の各画像もこの制限を満たす必要があります。
url フィールドの url モードのレスポンスは、約 1 日(24 時間)で失効する R2 CDN リンクです。それ以降のリクエストは 404 になります。強く推奨します: 生成後すぐに、生成画像を 自前のオブジェクトストレージ(S3 / OSS / R2)、CDN、または database にダウンロードして永続化してください。
いいえ。このモデルは画像を一括で返し、streaming はサポートされていません。レイテンシーが重要な場合は、クライアント側で「生成中…」の進捗表示を出し、300s timeout(控えめ設定)を構成してください。
はい。base_urlhttps://api.apiyi.com/v1 に向け、api_key に APIYI token を設定してください。client.images.generate(model="gpt-image-2-vip", size="2048x1360", prompt=...) はそのまま動作します。
はい、このエンドポイントはまだ動作しますが、もはや推奨されません — 代わりに /v1/images/generations/v1/images/edits を使ってください(より安定しており、同じコードは公式リレーの gpt-image-2 でも使えます)。chat ベースのスタイルが有効なのは、2 つのシナリオだけです。マルチターンの反復編集、またはオンライン画像 URL を直接渡す場合です。画像の意図があいまいなとき、モデルは画像ではなくプレーンテキストを返すことがあります(「画像を生成してください:」のような固定プレフィックスを prompt の先頭に付けると、意図を強められます)。全パラメータは chat ベースの API リファレンス をご覧ください。
quality ノブ(low/medium/high)、マスクベースのローカルリペイント、または OpenAI API のフィールド互換性を厳密に求める場合は、gpt-image-2 を使ってください。公式版とリバース版の比較 もご覧ください。

関連ドキュメント

gpt-image-2-vip は逆向き実装のチャネル(Codex 系列)です。挙動は一致していますが、課金/機能は公式版と完全には一致しない場合があります。完全な公式 API 互換性が必要な場合は、gpt-image-2 を使用してください。