GPT-Image
OpenAI の画像モデル 4 種、アスペクト比のデフォルトの決まり方、そして quality が効くのが GPT-Image-2 Pro だけである理由。
GPT-Image は ListenHub における OpenAI のモデルファミリーで、gpt-image-2 はカタログのデフォルト —
model を省略したときに使われるモデルです。4 つとも共通の画像エンドポイントで動作します。エンドポイント、
リクエストスキーマ、非同期の流れ、エラーコードについては
画像生成の概要 を参照してください。本ページで扱うのは
GPT-Image 固有の内容だけです。
モデル
| モデル | 表示名 | 主な用途 |
|---|---|---|
gpt-image-2 (デフォルト) | GPT-Image-2 | プロンプト追従性が高く、サイズごとの固定料金 |
gpt-image-2.5-flare | GPT-Image-2.5 Flare | 同じ料金と制限で使える別のビジュアルスタイル |
gpt-image-2.5-sunburst | GPT-Image-2.5 Sunburst | 同じ料金と制限で使える 3 つ目のスタイル |
gpt-image-2-official | GPT-Image-2 Pro | quality が効く唯一のモデル。料金はトークン単位 |
4 つとも provider: "openai" を指定します。Flare と Sunburst の料金と制限は gpt-image-2 と同一です —
この 3 つのどれを選ぶかで変わるのは出力の見た目であり、コストや制約ではありません。
制限
| 制限項目 | gpt-image-2、…-2.5-flare、…-2.5-sunburst | gpt-image-2-official |
|---|---|---|
| 画像サイズ | 1K、2K、4K | 1K、2K、4K |
| アスペクト比 | 標準 10 種 | 標準 10 種 |
| デフォルトのアスペクト比 | スキーマ由来の 1:1（下記参照） | スキーマ由来の 1:1（下記参照） |
| 参照画像 | 最大 4 件 | 最大 4 件 |
quality | 無視されます | low、medium、high |
| サブスクリプションの要否 | なし | 4K または quality: high にはサブスクリプションが必要 |
バリデータが比率を代わりに差し替えることが一度もない唯一のファミリーが GPT-Image です — ただし
リクエストスキーマは差し替えます。imageConfig.aspectRatio のデフォルト値は 1:1 なので、モデル
自身の選択に到達するには imageConfig オブジェクト全体を省略するしかありません。imageConfig を
送りつつ aspectRatio を付けなければ、返ってくるのは正方形の画像です。極端な比率（1:4、4:1、
1:8、8:1）を送ると、code: 26019 と対応する比率の一覧をメッセージに含む 400 が返ります。
参照画像は 1 リクエストあたり 4 件までです。超えると GPT-Image-2 supports at most 4 reference images
とともに 400 が返ります。
quality パラメータ
imageConfig.quality は low、medium、high を受け付けますが、指定した品質でレンダリングされるのは
gpt-image-2-official だけです。
gpt-image-2、gpt-image-2.5-flare、gpt-image-2.5-sunburst に quality を送ってもエラーには
なりません — 値は黙って破棄されます。estimate-credits はこれを warnings 配列の警告
quality_ignored_for_gpt_image_2_lite として返します。品質セレクタを表示するプロダクトでは、選択した
モデルが無視するコントロールを提示しないよう、この配列を読んでください。
料金とサブスクリプションの要否
lite の 3 モデルは画像サイズごとの固定クレジットコストで課金され
（pricing.mode は fixed、pricingVersion は gpt-image-2-lite-fixed-2026-06-15）、
requiresSubscription を設定することはありません。
gpt-image-2-official は推定トークン数から課金されるため（pricing.mode は token-estimate）、コストは
プロンプトの長さ、出力の寸法、指定した品質、そして参照画像の枚数に応じて変動します — API 上では各参照画像は
一律のレートで数えられます。OpenAPI のこの経路が送るのは枚数であり、画像ごとの寸法ではないからです。また、
画像カタログ全体の中で requiresSubscription: true を設定する唯一の構成でもあります — 4K の場合、または quality: high
の場合です。サブスクリプションのないアカウントにいずれかの選択肢を提示する前に、見積もりのこのフィールドを
確認してください。
gpt-image-2 には 1K と 2K で使える無料枠リソースがあり、Flare と Sunburst は 1 つの枠
（gpt-image-2.5）を共有します。gpt-image-2-official にはどのサイズでも無料枠はありません。
例
curl -X POST "https://api.marswave.ai/openapi/v1/images/generation/estimate-credits" \
-H "Authorization: Bearer $LISTENHUB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2-official",
"prompt": "A product hero shot of a matte black espresso machine on concrete",
"imageConfig": { "imageSize": "4K", "aspectRatio": "16:9", "quality": "high" }
}'レスポンスの requiresSubscription はこの構成に有効なサブスクリプションが必要かどうかを、credits は
かかるコストを示します。レスポンス全体の形式は
画像生成の概要 を参照してください。