GPT Image 2.6 APIチュートリアル：ドラフト、最終版、移行時の注意点

GPT Image 2.5から2.6へ基本的な画像生成リクエストを移行する場合、変更するのはモデル IDだけです。エンドポイント、トークン単価、推奨サイズ3種類はすべて同じです。注意が必要なのは、2.5にはあって2.6にはないBatch、OpenAIの2.5と2.6の資料で説明が異なるResponses画像ツール、そしてOpenAIのImage APIではドキュメント化されているものの、AIHubMixの公開パラメータースキーマにはまだ含まれていない各種コントロール（complexity、SVG、GIF、markup）です。

このチュートリアルでは、1536x1024の見出し付き商品ポスターを例に、AIHubMixでの一連の作業を紹介します。まず低コストのFlareドラフトを3枚生成して1枚を選び、Sunburstで最終版を作成します。各ステップの費用も示します。また、明確なエラーにならず、気づかないうちに失敗する移行時の問題も取り上げます。

変わらない点

2.6のモデルはgpt-image-2.6-sunburstとgpt-image-2.6-flareです。どちらもv1/images/generationsとv1/images/edits経由で呼び出します。単体のgpt-image-2.6というエイリアスはありません。テキスト入力は100万トークンあたり$5、画像入力は$8、画像出力は$30で、2.5およびGPT Image 2とまったく同じです。

つまり、Image APIを中心に構築されたパイプラインなら、リクエストの形式はそのまま使えます。変わるのはモデル文字列だけで、新モデルを使いたい場合に限ります。AIHubMixのモデルページによると、シリーズ全体で50%高速化したという点が、初日から切り替える主な理由です。

移行時の注意点

Batchは廃止

2.5が明確に優れている機能はこれです。GPT Image 2.5のモデルページにはv1/batchがサポート対象として記載されており、Batchでは画像出力の料金が100万トークンあたり$30ではなく$15になります。GPT Image 2.6のモデルページではBatchは非対応とされ、Batchの料金表にも2.6のモデルはどちらも掲載されていません。

夜間に画像生成ジョブを実行している場合は、2.6に移行しないでください。2.5を使い続けるか、処理を分けて、対話的なドラフト生成には2.6、バッチレンダリングには2.5を使いましょう。AIHubMixの画像ドキュメントにはBatchエンドポイントが記載されていないため、この判断が当てはまるのはOpenAIへの直接呼び出しのみです。

Responsesを使うパイプラインは要確認

OpenAI自身の資料では、2.5について説明が食い違っています。9月の変更履歴にはImage APIと並んでResponses APIの画像生成ツールが記載されていますが、2.5のモデルページではResponsesは非対応となっています。2.6についてはより明確です。モデルページではResponsesは非対応とされ、11月の変更履歴にはv1/images/generationsとv1/images/editsのみが記載されています。

Responses経由で2.5を呼び出しているコードがある場合は、モデル IDを変更する前にスモークテストを追加してください。ここでの失敗は明確に表れますが、テストしている場合に限ります。別のモデルへ気づかないうちにフォールバックするパイプラインは、400エラーよりも厄介です。

新しいコントロールはImage API専用

画像生成ガイドでは、complexity、markupによる編集、SVG出力、アニメーションGIF出力がImage APIの機能として紹介されています。Responses画像ツールではいずれも利用できず、SVGとGIFは生成専用のため、/v1/images/editsではどちらも使えません。

それぞれに固有の制約があります。SVGではn=1が必須で、ストリーミング、部分画像、output_compression、prompt_rewriterはサポートされません。GIFではframe_count（デフォルトは9）とframe_duration_ms（デフォルトは200）を使います。こちらも生成専用で、ストリーミング、部分画像、カスタムのoutput_compression、prompt_rewriterには対応していません。markup編集では、元画像を最初の入力画像として指定し、同じ寸法の透明PNGを別途用意する必要があります。どちらの画像も16,777,216ピクセルを超えてはならず、markupファイルの上限は50 MBです。markupをmaskまたはprompt_rewriterと併用しないでください。

SVGには、さらに料金上のルールがあります。参照画像には画像モデルの料金が、SVGの作成に使うトークンには作成モデルの料金がかかります。合計額は両方に左右されるため、通常の画像1枚あたりの見積もりではカバーできません。

品質とサイズの資料に食い違い

2.5について、OpenAIはauto以外に5段階の品質レベルを明記しています。low、medium、high、xhigh、maxです。2.6については、ガイドの料金計算ツールでは両世代に同じ5段階が掲載されていますが、APIリファレンスでxhighとmaxが指定されているのは2.5のスナップショットのみです。また、以下の費用の出典であるAIHubMixの画像1枚あたりの料金表にはlow、medium、high、autoだけが掲載されています。

現時点で2.6に安全に使えるのはlow、medium、high、autoです。サイズにも同じ注意が必要です。カスタムのWIDTHxHEIGHT値はGPT Image 2と2.5向けにドキュメント化されていますが、2.6のガイドが推奨しているのは1024x1024、1536x1024、1024x1536です。2.6のドキュメント間で記述が統一されるまでは、推奨された3種類のサイズを使ってください。

1.5からの移行では、1024x1024の高品質出力が割高

GPT Image 1.5と1-miniは2026年12月1日に廃止され、後継モデルとして2.5が指定されています。主に1024x1024の高品質で生成している場合、移行コストは安くありません。OpenAIの1.5の料金表では高品質が$0.133ですが、AIHubMixによる2.6の見積もりは$0.211で、約59%高くなります。mediumは$0.034から$0.053に上がり、lowは逆に$0.009から$0.006に下がります。1536x1024の場合、1.5のhighは$0.200なので、2.6の$0.165のほうが安くなります。

2.6に決める前に、同じ構成で2.5も試してください。トークン単価は同じなので、2つの2.xモデルの違いはトークン消費量であり、価格表の単価ではありません。

AIHubMix経由で2.6を呼び出す

AIHubMixでは2.6の両モデルを利用でき、料金は公式価格と同じです。AIHubMixの画像生成ドキュメントでは、新しいエンドポイントPOST https://aihubmix.com/ai/v1/images/generationsを案内しています。受け付けるパラメーターはmodel、prompt、n、size、output_format、image、images、mask、async、extra、および2つのwebhookフィールドです。

重要なのは、品質を指定する場所です。/ai/v1/images/generationsにはトップレベルのqualityフィールドがありません。extraの中に指定します。

curl -s https://aihubmix.com/ai/v1/images/generations \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-flare",
    "prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline",
    "size": "1024x1024",
    "n": 3,
    "extra": { "quality": "low" }
  }'

レスポンスには1つ以上の出力URLが含まれます。URLの有効期間は短く、およそ30分です。次のAuthorization: Bearer $AIHUBMIX_API_KEYヘッダーを使ってダウンロードする必要があります。

curl -s -H "Authorization: Bearer $AIHUBMIX_API_KEY" "<output-url>" -o draft-1.png

AIHubMixのドキュメントでは、新規連携には/ai/v1を推奨しています。OpenAI互換の/v1エンドポイントでは最新モデルがまだサポートされていない可能性があり、旧版の画像リファレンスに記載されているモデルはgpt-image-2、gpt-image-1.5、gpt-image-1-miniとDALL·Eモデルで、2.6は含まれていません。モデル別のスキーマには2.6向けの/v1/images/generationsの記載もありますが、AIHubMixが2.6用としてドキュメント化しているのは/ai/v1で、非同期タスクとwebhookにも対応するエンドポイントです。

スキーマで公開されていない機能

AIHubMixが公開している2.6のスキーマで、output_formatに指定できるのはpng、jpeg、webpのみです。complexity、markup、frame_count、frame_duration_msはなく、svgやgifの出力にも対応していません。スキーマは認証なしでhttps://aihubmix.com/call/schema/models/gpt-image-2.6-flare/endpointsから確認できます。ゲートウェイ経由でこれらの機能を使う前に、必ず確認してください。

これはスキーマの不足であり、実際に動作しないと確認されたわけではありません。OpenAI側では機能がドキュメント化されており、ゲートウェイでも今後追加される可能性があります。スキーマに記載されるまでは、SVG、GIF、markupを使う処理はOpenAIへの直接呼び出しとして計画してください。

想定されるエラー

ステータス	意味	対処方法
400	パラメーターエラー。多くの場合、プロバイダーから引き継がれたエラー	プロンプト、サイズ、nを確認する
401	キーがない、または無効	Authorizationヘッダーを確認する
402	クォータ不足	クレジットを追加する
403	アクセス許可がない	アカウント、キーの権限、IP制限を確認する
429	レート制限中	時間をおいて再試行する
503	リクエストを処理できるチャネルがない	モデル IDを確認し、しばらくしてから再試行する

AIHubMixのエラーボディにはtidというトレース IDが含まれています。サポートへの問い合わせに備えて保存し、400エラーが返された場合は同じ内容で再試行しないでください。これは/ai/v1の仕様です。旧版の/v1エンドポイントでは、クォータ不足は403 insufficient_user_quotaとして報告されます。

ワークフロー：ドラフト3枚から最終版1枚へ

商品画像と見出しを組み合わせたポスターを作成します。プロンプトは固定し、モデル、サイズ、品質だけを変更します。

ステップ1 — Flareでドラフトを作成。1024x1024、低品質、n=3で1回リクエストすると、異なる方向性の画像を3枚生成できます。画像1枚あたりの推定費用は$0.006なので、このステップの費用は$0.018です。

ステップ2 — 1枚選ぶ。ワークフローの中で低コストな部分であり、モデルの速度が最も活きる部分でもあります。1回の呼び出しでドラフトを3枚作るのは、予算をかけすぎる使い方ではなく、一般的な範囲です。

ステップ3 — Sunburstで最終版をレンダリング。選んだ構図をもとにプロンプトを調整し、1536x1024、高品質で生成します。画像1枚あたりの推定費用は$0.165で、この工程が最も高くつきます。最終版1枚の費用はドラフト1枚の約28倍、ドラフト3枚の工程全体の約9倍です。

curl -s https://aihubmix.com/ai/v1/images/generations \
  -H "Authorization: Bearer $AIHUBMIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst",
    "prompt": "A minimal poster: a single ceramic coffee mug on a pale sand background, soft morning light, large empty space at the top for a headline. Refined studio product photography, subtle shadow, no text",
    "size": "1536x1024",
    "n": 1,
    "extra": { "quality": "high" }
  }'

ステップ4 — 合計。ドラフトの推定費用$0.018に最終版の$0.165を加えると、出力画像4枚で合計$0.183です。最終版をmedium品質で生成すれば$0.041となり、実行全体で$0.059です。この程度のプロンプト長なら、入力テキストのトークン料金は1セント未満です。編集の場合は、100万トークンあたり$8の画像入力料金が追加されます。

この金額から、2つのモデル間に費用差がないことがわかります。AIHubMixの画像1枚あたりの見積もりが一致しているため、同じ4枚を2.5で生成しても料金は同じです。2.6を使う理由はドラフト作成を高速化できること、そして将来的にSVGやGIFの処理をOpenAIに移せることです。料金が安くなるわけではありません。

移行チェックリスト

新モデルを使いたい箇所ではgpt-image-2.5-sunburstとgpt-image-2.5-flareを2.6のモデル IDに置き換え、Batchジョブは2.5のままにする。
Responses画像ツールを使っているパイプラインがないか確認する。2.6でドキュメント化されているのはImage APIのみ。
2.6のドキュメントが整うまでは、品質をlow、medium、high、autoに限定し、サイズも推奨された3種類にする。
AIHubMixの/ai/v1では、品質をextraに指定します。2.6では、AIHubMixが新規連携に推奨するパス/ai/v1を使用してください。
出力URLは、Bearerヘッダーを付けて30分以内にダウンロードしてください。
スキーマに記載されるまでは、complexity、markup、SVG、GIFがAIHubMixで使えると想定しないでください。
1.5を使用している場合は、12月1日の廃止に備えて予算を確保し、高品質の料金を再確認してください。

よくある質問

GPT Image 2.6ではエンドポイントを変更する必要がありますか？
OpenAI APIでは不要です。2.5と同じv1/images/generationsとv1/images/editsを使用し、変更するのはモデル IDだけです。AIHubMixでは、前述のとおり/ai/v1/images/generationsを使用してください。

GPT Image 2.6は2.5より安いですか？
いいえ。トークン料金は同じです。テキスト入力トークンは100万あたり$5、画像入力トークンは100万あたり$8、画像出力トークンは100万あたり$30です。

GPT Image 2.6でBatchを使えないのはなぜですか？
OpenAIの2.6モデルページではBatchは非対応と記載されており、Batchの料金表には2.5は掲載されていますが、2.6は掲載されていません。Batchは、2.5が引き続き有力な選択肢となる最も明確なワークフローです。

AIHubMixで品質を設定するにはどうすればよいですか？
2.6では、/ai/v1/images/generationsのextra.qualityに指定します。OpenAI互換の/v1/images/generationsにはトップレベルのqualityフィールドがありますが、AIHubMixは新規連携に/ai/v1を推奨しています。2.6では/ai/v1を使用してください。

AIHubMix経由でSVGやGIFを生成できますか？
現行のスキーマによるとできません。スキーマに記載されているのはpng、jpeg、webpで、complexity、markup、フレーム数、SVG/GIF出力は含まれていません。これらはOpenAIのImage APIではドキュメント化されていますが、ゲートウェイ経由で利用する前にスキーマを確認してください。

AIHubMixの出力URLはどれくらい有効ですか？
約30分です。同じBearerトークンを使ってダウンロードし、ファイルはご自身で保存してください。

GPT Image 1.5はどうなりますか？
2026年12月1日に廃止されます。OpenAIは後継として2.5を挙げていますが、1024x1024の高品質では、2.6は1.5より画像1枚あたりの料金が高く、1536x1024では安くなります。

続けて読む：GPT Image 2.6シリーズ

比較記事では料金表、速度に関する主張、そして2.5が依然として優れている点を取り上げています。移行するかどうかをまだ決めていない場合は、まずこちらをご覧ください。
GPT Image 2.6と2.5を比較：アップグレードする価値はある？