size パラメータが再び利用可能になりました(2026-07-22 更新): size を明示的に渡すと、期待どおり出力寸法がロックされ、このページの 30 サイズ参照表も再び有効になります。注意: size は /v1/images/generations と /v1/images/edits エンドポイントでのみ動作します — /v1/chat/completions のチャット エンドポイントは size パラメータをサポートしていないため、チャットベースの画像生成では寸法をロックできません。最新の状態は 最新の更新情報 セクションを参照してください。概要
gpt-image-2-vip は、Codexライン上の GPT画像生成リバースエンジニアリングモデル で、APIYIプラットフォームで利用できます。gpt-image-2-all と同じ定額の $0.03/image で、リクエスト/レスポンス形式も同一 です。実質的な違いは、vip が sizeフィールド を受け付け、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-vip と gpt-image-2-all はどちらもリバースエンジニアリングされたチャネルで、価格も呼び出しコードも同じです。互いに鏡像のような存在です — 同じリクエストで model フィールドを切り替えるだけで、挙動はほぼ同一です。違いは次のとおりです。
主な機能
出力サイズ固定
sizeフィールドは30種類の一般的なサイズに対応します — eコマースのヒーロー画像、ポスターテンプレート、4K壁紙などを、すべて正確なピクセルで出力します。4K高解像度
全サイズ一律料金
-all と同じ呼び出し形式
gpt-image-2-all と同一です — model 文字列だけでモデルを切り替えられます。高品質テキスト描画
中国語の説明を翻訳なしでそのまま理解
自然言語編集
標準エンドポイント対応
/images/generations と /images/edits に対応価格
- 30種類すべてのサイズで一律 $0.03/image — 4K Detail への追加料金はありません
- 失敗したリクエストは課金されません(認証失敗、パラメータ検証エラー)
- N枚の画像が必要な場合は、APIをN回並列で呼び出します
グループ設定
gpt-image-2-vip は Default グループ上にあります — 追加のグループは不要です。リバースチャンネルには現在安定した供給があるため、公式リレー 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-vip と gpt-image-2-all の両方に有効です。応答には常に画像URLが含まれ、base64 にフォールバックすることはありません。

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
image2Enterprise グループについて: /en/live/2026-04/image2-enterprise-stable
技術仕様
エンドポイント
gpt-image-2-vip は、gpt-image-2-all とまったく同じ 2 つのエンドポイントに対応しています。必要に応じて、model フィールドを入れ替えて、size を追加するだけです:
対応サイズ(30サイズの完全版表)
gpt-image-2-vipは 10種類のアスペクト比 × 3つの解像度ティア = 30サイズ をサポートします。size: "WIDTHxHEIGHT"(小文字ASCIIのx)をリクエストボディに直接指定してください。
1K 高速 — 下書きと低コストの反復
2K 推奨 — デフォルトのティア(本番出力の大半)
4K 詳細 — 大型納品物
size のみを指定し、quality は指定しないでください):
ベストプラクティス
入力画像は 1.5MB 未満に圧縮してください(画像編集 / 複数画像融合)
shell_api_error / Unknown error のレスポンスは、ほとんどの場合、入力が大きすぎることが原因です — 圧縮すると成功率とレイテンシが目に見えて改善します。出力解像度は入力サイズではなく size フィールドで決まります — 入力を小さくしても速くなるだけで、品質は下がりません。4K / 8K を prompt に詰め込んでも 4K 画像にはなりません。解像度は prompt の飾りではなく、size で決まります。成果物に応じてサイズ階層を選ぶ
サイズには小文字の ASCII x を使う
"size": "1536x1024" を送信してください — 1536×1024 ではなく、大文字の X でもありません。quality や n は渡さない
quality は受け付けられません。n は 1 回の呼び出しにつき 1 枚しか返しません — 複数画像が必要な場合は並列で呼び出してください。300s のタイムアウトを使う
必要に応じてレスポンス形式を選ぶ
b64_json を使い、サーバー側での保存 / 転送には url を使ってください。コードは -all で共有する
model を gpt-image-2-all と gpt-image-2-vip の間で切り替えてください。サイズを固定したい場合は vip を使い、最速で反復したい場合は -all に戻してください。エラーコードとリトライ
- Request timeout は 300秒から にしてください(保守的です。通常は90〜150秒ですが、4K Detail + ピーク時のロングテールではさらに長くなります)
- 5xx と timeout には 指数バックオフ を使用してください(2〜3回のリトライを推奨します)
- デバッグ用に
request-idresponse header をログに記録してください
よくある質問
vip と -all でコードを共用できますか?
vip と -all でコードを共用できますか?
/v1/images/generations, /v1/images/edits)は、リクエストフィールド、レスポンスフィールド、そして b64_json の prefix 挙動を共有しています。違いは次の 2 点だけです。modelフィールド:gpt-image-2-vip↔gpt-image-2-allsizeフィールド: vip は 30サイズセットを受け付けますが、-all はsizeを拒否します(サイズは代わりに prompt に入ります)
if model == 'vip': payload['size'] = ... スイッチを用意してください。vip がこんなに遅いのはなぜですか?
vip がこんなに遅いのはなぜですか?
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 が必要なときだけ使ってください。サイズは表にあるものと完全に一致していなければなりませんか? 1024x768 を送るとどうなりますか?
サイズは表にあるものと完全に一致していなければなりませんか? 1024x768 を送るとどうなりますか?
invalid_request_error を引き起こす可能性があります。納品物に最も近いティアを選んでください。4K が頻繁に 500 を返すのはなぜですか? どうすれば安定して 4K を取得できますか?
4K が頻繁に 500 を返すのはなぜですか? どうすれば安定して 4K を取得できますか?
3840x2160 / 2880x2880)では、status_code: 500 エラーが発生しやすく、上流は invalid_request_error を返します。- 2K Recommended を優先する(例:
2048x1360/2048x2048)— 成功率が大幅に高く、料金は同じ $0.03/image - 入力画像数を減らす: img2img / multi-image fusion では、Codex のリバースチャネルが大量の入力負荷に弱く、4K の失敗率がさらに上がります。各入力画像を 1.5MB 未満に事前圧縮するのも有効です
- 4K を確実にしたい場合 — 公式プロキシ
gpt-image-2+image2Enterpriseグループ に切り替えてください。公式プロキシの 4K は高め(約 $0.3+/image)ですが、かなり安定しており、4K 納品が絶対条件の場面に適しています。
入力画像は圧縮すべきですか? prompt に 4K / 8K と書くと効果がありますか?
入力画像は圧縮すべきですか? prompt に 4K / 8K と書くと効果がありますか?
shell_api_error / Unknown error 応答は、過大な入力が最も多い原因であり、圧縮すると成功率とレイテンシーが目に見えて改善します。注: 1.5MB は信頼性と速度のための推奨上限であり、上の FAQ にある 10MB はゲートウェイのハード上限です。圧縮で品質が落ちる心配はありません — 出力解像度は size パラメータで決まり、入力サイズでは決まりません。入力を小さくすると、単に処理が速くなるだけです。prompt に 4K / 8K を詰め込んでも、実際に 4K 出力にはなりません。 prompt に 8K ultra HD と書いていても、size を 1024x1024 に設定していれば、出力は依然として 1K 品質の画像になります。4K にするには size フィールドで設定してください — 1K / 2K / 4K は 30サイズセット全体で一律 $0.03/image です。📖 出典: /en/live/2026-05/gpt-image-2-vip-unknown-error4K に本当に追加料金はありませんか?
4K に本当に追加料金はありませんか?
3840x2160 / 2880x2880 など)も、1K や 2K と同じ $0.03/image です。n に対応していますか? n=3 を渡すとどうなりますか?
n に対応していますか? n=3 を渡すとどうなりますか?
n=3 を渡すと、課金は 0.03 × 3 = $0.09 になりますが、実際に返る画像は 1 枚だけです。無駄な課金を避けるため、n フィールドは外してください。コンテンツが拒否されたり、モデルが 'I can't do that' と返した場合、課金されますか?
コンテンツが拒否されたり、モデルが 'I can't do that' と返した場合、課金されますか?
- ✅ 事前フィルタとユーザー警告: フロントエンドまたはゲートウェイでキーワード / シナリオフィルタ(実在の人物名、著作権キャラクター、センシティブな話題)を追加し、「有名人 / IP 系の話題は失敗することがあり、上流のポリシーにより課金される場合があります。」のような UI ヒントを表示してください。これにより無駄な課金を大幅に減らせます。
- ✅ コンシューマー向け製品では月次補填: コンシューマー向け製品では、ユーザー入力を完全には制御できないことを理解しています。月間支出が十分大きい($1000+/month)場合は、ログを月次でまとめて(短レイテンシーの呼び出しは通常ソフト拒否です)サポートに連絡し、一度限りの手動クレジットを依頼できます。呼び出しごとに異議申し立てをする必要はありません。
b64_json に data:image/png;base64, プレフィックスを付ける必要がありますか?
b64_json に data:image/png;base64, プレフィックスを付ける必要がありますか?
b64_json は data: プレフィックスのない生の base64 です。ファイルに書き出すにはデコードし、描画前に自分でプレフィックスを付けても構いません。以前のバージョンにはプレフィックスが含まれていました。コードに startsWith('data:') チェックを追加してください。プレフィックスがある場合は、値をそのまま img src として使い、ない場合は先にデコードするかプレフィックスを付けてください。これにより、プレフィックスの二重付与や、プレフィックス付き文字列をデコードして壊れた画像にしてしまうことを防げます。参照画像の最大サイズと対応フォーマットは何ですか?
参照画像の最大サイズと対応フォーマットは何ですか?
png / jpg / webp です。大きすぎる画像はゲートウェイの制限に達する場合があります。複数画像融合の各画像もこの制限を満たす必要があります。返される画像 URL はどのくらい有効ですか? ダウンロードする必要がありますか?
返される画像 URL はどのくらい有効ですか? ダウンロードする必要がありますか?
url フィールドの url モードのレスポンスは、約 1 日(24 時間)で失効する R2 CDN リンクです。それ以降のリクエストは 404 になります。強く推奨します: 生成後すぐに、生成画像を 自前のオブジェクトストレージ(S3 / OSS / R2)、CDN、または database にダウンロードして永続化してください。streaming に対応していますか?
streaming に対応していますか?
公式の OpenAI SDK は使えますか?
公式の OpenAI SDK は使えますか?
base_url を https://api.apiyi.com/v1 に向け、api_key に APIYI token を設定してください。client.images.generate(model="gpt-image-2-vip", size="2048x1360", prompt=...) はそのまま動作します。/v1/chat/completions で引き続き画像を生成できますか?
/v1/chat/completions で引き続き画像を生成できますか?
/v1/images/generations と /v1/images/edits を使ってください(より安定しており、同じコードは公式リレーの gpt-image-2 でも使えます)。chat ベースのスタイルが有効なのは、2 つのシナリオだけです。マルチターンの反復編集、またはオンライン画像 URL を直接渡す場合です。画像の意図があいまいなとき、モデルは画像ではなくプレーンテキストを返すことがあります(「画像を生成してください:」のような固定プレフィックスを prompt の先頭に付けると、意図を強められます)。全パラメータは chat ベースの API リファレンス をご覧ください。公式の gpt-image-2 に切り替えるべきなのはいつですか?
公式の gpt-image-2 に切り替えるべきなのはいつですか?
quality ノブ(low/medium/high)、マスクベースのローカルリペイント、または OpenAI API のフィールド互換性を厳密に求める場合は、gpt-image-2 を使ってください。公式版とリバース版の比較 もご覧ください。関連ドキュメント
- GPT-Image-2-All 概要 - 同価格帯の姉妹モデルで、出力がより速く、サイズ固定が不要な場合に最適です
- ⚖️ 公式版とリバース版の比較 - 公式
gpt-image-2との並列表比較による選定ガイド(-all/-vipをカバー) - Text-to-Image Playground -
/v1/images/generations互換のエンドポイント、sizeを渡して寸法を固定します - Image Editing Playground -
/v1/images/editsの複数画像融合と編集 - GPT-Image-2 公式版 -
qualityパラメータ / マスクベースの再描画 / 厳密な OpenAI API フィールド互換性向け - GPT-Image シリーズ概要 - 公式 GPT-Image 比較
- API マニュアル - 一般的な呼び出し規約
gpt-image-2 を使用してください。