Skip to Content
モデルの使い方GPT Image概要

GPT Image ファミリー

OpenAI の画像生成モデルです。gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2 の 3 つがあり、いずれも OpenAI 互換 API で呼び出します。

このシリーズの内容はすべて実際の API で検証しており、コード例はすべてそのまま実行して動作を確認しています。最終確認日：2026-09-30。

目的別ガイド

テキストから画像生成 テキストのプロンプトから画像を生成します。画像編集・複数画像の合成 1 枚または複数の画像をアップロードし、プロンプトで編集・合成します。インペインティング マスクで範囲を指定し、その部分だけを描き直します。手持ちのツールで画像生成 コードは不要です。Cherry Studio や LobeHub ではいくつかの設定を入力し、Claude Code や Codex ではプロンプトを 1 つコピーするだけです。

これらのエンドポイントに共通するリクエスト構造とレスポンスフィールドは Images API を参照してください。

どのモデルを使うか

gpt-image-2.5-flareテキストから画像
  • 日常的な生成やバッチ生成向け、高速
  • 品質ティア 6 段階：low〜max
Azure · OpenAI
gpt-image-2.5-sunburst編集
  • 画像の編集・合成向け、再現度を重視
  • 品質ティア 6 段階：low〜max
Azure · OpenAI
gpt-image-2前世代
  • 既存プロジェクトでは引き続き利用可能
  • 品質ティア 4 段階、xhigh・max なし
Azure · OpenAI

gpt-image-2 から 2.5 に移行する場合は、品質ティアを選び直してください。下記の品質と価格を参照してください。どちらのプロバイダーもテキストからの画像生成と編集に対応しており、ゲートウェイが自動でルーティングします。

モデル ID（そのままコピーしてください）
テキストから画像openai/gpt-image-2.5-flare日常的な生成やバッチ生成向け、高速
編集openai/gpt-image-2.5-sunburst画像の編集・合成向け、再現度を重視
前世代openai/gpt-image-2xhigh・max ティアなし

品質（quality）と価格

quality は価格に最も大きく影響します。上位のティアほど料金が高く、時間もかかります。

OpenAI 公式の参考価格（1 枚あたり、出力画像のみ。プロンプトと参照画像は含みません）：

ティアgpt-image-2 · 1024×1024gpt-image-2 · 1024×1536 または 1536×1024
low$0.006$0.005
medium$0.053$0.041
high$0.211$0.165

2.5 の 2 モデルについて、OpenAI は 1 枚あたりの価格表を公開しておらず、単価のみを示しています。出力画像トークンは 100 万あたり $30、参照画像の入力トークンは 100 万あたり $8、テキスト入力トークンは 100 万あたり $5 です。OpenAI の計算例では、1024×1024 の low で出力トークンは 196、約 $0.00588 です。その他のティアやサイズは公式の計算ツール で見積もってください。

以上は OpenAI の公式データであり、実際の課金は各レスポンスの usage に従います。OfoxAI のリアルタイム価格（割引を含む）はモデルページ を参照してください。

各モデルが対応するティア：

ティア2.5（flare、sunburst）gpt-image-2
low / medium / high対応対応
xhigh / max対応非対応、400 を返す
auto または省略モデルが決定。medium と同じではありません。明示的に指定してください同左

standard と hd（DALL·E の旧値）は非対応で、400 を返します。

所要時間とタイムアウト（timeout）

API は同期型で、画像の生成が完了してからレスポンスが返されます。クライアントが途中で切断すると画像は失われますが、リクエストは課金されます。

リクエスト送信生成中（数分かかる場合があります）画像を返却
60 / 120 秒 よくあるデフォルト値：生成途中で接続が切れ、画像は失われますが課金されます
600 秒 推奨値：画像が返るまで待機できます

クライアントのタイムアウトは 600 秒に設定してください。 所要時間はモデル、品質、サイズによって変わります。高品質・大サイズ・編集のリクエストは数分かかる場合があり、よくある 60 秒や 120 秒のデフォルトタイムアウトでは足りません。

サイズ（size）

size には任意の 幅x高さ を指定できますが、以下の 4 つのルールをすべて満たす必要があります。1 つでも満たさない場合は 400 を返します。

16 の倍数
  • 幅と高さがどちらも 16 で割り切れる
✗ 1000x1000
長辺 ≤ 3840
  • どの辺も 3840 を超えない
✗ 4096x4096
アスペクト比 ≤ 3:1
  • 1:3 から 3:1 の範囲内
✗ 3200x1024
ピクセル数 ≥ 655,360
  • 総ピクセル数が 655,360 以上
✗ 768x768 → ✓ 1024x768

省略または auto：モデルがサイズを決定します。1024×1024 になるとは限らず、参照画像と一致するとも限りません。実測では、テキストからの生成と編集のどちらも 1254×1254 が返されました。サイズを固定したい場合は明示的に指定してください。

公式に記載されている上限は 3840×2160 で、2560×1440 を超えるサイズは実験的扱いです。

技術仕様

項目仕様
レスポンス同期型。画像は data[0].b64_json に素の base64 として格納
出力サイズ4 つの制約の範囲内で幅と高さを自由に指定、最大 3840×2160
品質ティア品質と価格を参照
出力形式png（デフォルト）、jpeg、webp
1 回あたりの枚数1〜10 枚、デフォルト 1
参照画像1 枚あたり ≤ 15 MB、1 リクエストあたり ≤ 50 MB。アップロード制限を参照
タイムアウトクライアントのタイムアウトを 600 秒に設定。所要時間とタイムアウトを参照

プロバイダーの指定

通常は指定する必要はありません。コンテンツ審査に関する要件がある場合に指定してください。プロバイダーごとに審査基準が異なり、たとえば gpt-image-2 は Azure では厳しめ、OpenAI では比較的ゆるやかです。

指定しない（推奨）
リクエスト→OfoxAI ゲートウェイ→AzureOpenAI

ゲートウェイが Azure と OpenAI の中から利用可能なプロバイダーを自動で選択します。

プロバイダーを指定
リクエストopenai→OfoxAI ゲートウェイ→AzureOpenAI

リクエストはそのプロバイダーにのみ送信されます。利用できない場合も、他のプロバイダーには切り替わりません。

プロバイダーの指定方法
ヘッダーX-OfoxAI-Provider-Type: openaiテキストからの生成と編集の両方で有効。値は azure_foundry、openai
リクエストボディ"extra_body": { "provider": { "type": "openai" } }テキストからの生成のみ。編集は multipart アップロードのため、ヘッダーのみ使用可能

詳細はプロバイダールーティングを参照してください。

よくあるエラー

エラー原因対処法
moderation_blocked（Your request was rejected by the safety system）プロンプトまたは参照画像が上流の安全システムでブロックされたプロンプトまたは参照画像を変更して再試行してください。そのまま再試行しても結果は変わりません。審査に関する要件がある場合はプロバイダーの指定を検討してください
タイムアウト、504、524、Request timed out生成が終わる前に、クライアントまたは中間プロキシ（Nginx、Vercel、Cloudflare など）がタイムアウトしたクライアントとプロキシのタイムアウトを 600 秒に設定してください。所要時間とタイムアウトを参照
404 model_not_foundモデル ID のスペルミスまたは大文字・小文字の誤り（例：GPT-Image-2）このページからモデル ID をコピーし、すべて小文字で指定してください
provider_type_unavailable手動で指定したプロバイダーがこのモデルを提供していないプロバイダーのパラメーターを削除し、ゲートウェイにルーティングさせてください
unknown provider typeヘッダーのプロバイダー名のスペルミススペルを確認してください
Invalid sizeサイズが 4 つのルールのいずれかに違反しているサイズを参照
does not support quality 'xhigh'gpt-image-2 に xhigh または max を送信したhigh を使うか、2.5 に切り替えてください
Invalid value: 'standard'quality に standard または hd を指定したlow〜max を使用してください
Invalid image file or mode参照画像またはマスクの形式が正しくない標準的な PNG または JPEG として書き出し直してください
Invalid file 'image[0]': unsupported mimetypeアップロードしたファイルが画像ではないPNG、JPEG、WebP のいずれかの画像をアップロードしてください
does not support the 'input_fidelity' parameter編集リクエストに input_fidelity が含まれている削除してください。2.5 モデルと gpt-image-2 は常に高忠実度で参照画像を処理します
Transparent background is not supported for JPEG output formatjpeg 出力で透明背景を指定したpng または webp を使用してください
Unknown parameterこのファミリーが対応していないパラメーター削除してください
429 rate_limit_exceeded1 分あたり 100 リクエスト（チーム単位）を超えた時間をおいて再試行してください。キーを増やしても上限は上がりません

エラーの全体像はエラーハンドリングを参照してください。

エラーメッセージの原文

実測で得られたメッセージの全文です。検索や照合にご利用ください。

Invalid size '1000x1000'. Width and height must both be divisible by 16.
Invalid size '4096x4096'. The longest edge must be less than or equal to 3840.
Invalid size '3200x1024'. The maximum supported aspect ratio is 3:1.
Invalid size '768x768'. Requested resolution is below the current minimum pixel budget.
The model 'gpt-image-2' does not support quality 'xhigh'.
Invalid value: 'standard'. Supported values are: 'low', 'medium', 'high', and 'auto'.
Invalid 'n': integer above maximum value. Expected a value <= 10, but got 11 instead.
Unknown parameter: 'style'.
The model 'gpt-image-2.5-sunburst' does not support the 'input_fidelity' parameter.
Transparent background is not supported for JPEG output format
Invalid file 'image[0]': unsupported mimetype ('text/plain; charset=utf-8'). Supported file formats are 'image/jpeg', 'image/png', and 'image/webp'.
unknown provider type in X-OfoxAI-Provider-Type header
Model 'GPT-Image-2' not found
Invalid image file or mode for image 1

Invalid value: 'standard' に列挙されている値は不完全な点に注意してください。2.5 モデルは xhigh と max にも対応しています。このページのティア表を正としてください。

効果のないパラメーター

以下のパラメーターはエラーにはなりませんが、このファミリーでは何の効果もありません。リクエストは成功し、通常どおり課金されます。

パラメーター理由
mask（テキストからの生成）編集エンドポイントでのみ有効
response_formatDALL·E の旧パラメーター。このファミリーは常に base64（b64_json）を返します。OpenAI に直接呼び出すと Unknown parameter: 'response_format' が返りますが、OfoxAI 経由では無視されます
input_fidelity（テキストからの生成）gpt-image-1.5 用のパラメーター。注意：編集エンドポイントに送ると 400 を返します
input_imagesQwen 画像ファミリー用のパラメーター

エラーにならないことは、効果があることを意味しません。たとえば style はそのまま拒否されますが、上記のパラメーターは黙って無視されます。

公式ドキュメント

OpenAI のドキュメントは、OpenAI に直接呼び出した場合の動作を説明しています。OfoxAI 経由で呼び出す場合は、このシリーズの実測結果が優先されます。たとえば、価格はレスポンスの usage とモデルページに従います。

よくある質問

GPT Image 2.5 は任意のサイズに対応していますか？

4 つのルールを満たせば任意のサイズを指定できます。幅と高さが 16 で割り切れること、長辺が 3840 以下であること、アスペクト比が 1:3 から 3:1 の範囲内であること、総ピクセル数が 655,360 以上であることです。1 つでも満たさない場合は 400 を返します。たとえば 768x768 はピクセル数が不足するため拒否されますが、1024x768 は使用できます。

size を省略するとどのサイズになりますか？

モデルが決定します。1024x1024 になるとは限らず、参照画像と一致するとも限りません。実測では、テキストからの生成と編集のどちらも 1254x1254 が返されました。サイズを固定したい場合は明示的に指定してください。

gpt-image-2 は xhigh や max の品質に対応していますか？

対応していません。どちらも 400 を返します。xhigh と max に対応しているのは gpt-image-2.5-flare と gpt-image-2.5-sunburst のみです。gpt-image-2 で指定できるのは low、medium、high、auto です。

GPT Image 2.5 の quality に hd や standard を指定できますか？

できません。400 を返します。有効な値は low、medium、high、xhigh、max、auto です。省略した場合はモデルがティアを決定します（実測では low）。品質を安定させたい場合は明示的に指定してください。

gpt-image-2 / GPT Image 2.5 API のタイムアウトはどのくらいに設定すべきですか？

クライアントのタイムアウトは 600 秒に設定してください。所要時間はモデル、品質、サイズによって変わり、高品質・大サイズ・編集のリクエストは数分かかる場合があります。

GPT Image で moderation_blocked（Your request was rejected by the safety system）エラーが出た場合の対処法は？

プロンプトまたは参照画像が上流の安全システムでブロックされています。実在の人物、著作権のあるキャラクター、センシティブな内容でよく発生します。プロンプトまたは参照画像を変更して再試行してください。そのまま再試行しても結果は変わりません。レスポンスの error.moderation_details で、ブロックが入力段階と出力段階のどちらで発生したかを確認できます。プロバイダーごとに審査基準が異なるため、審査に関する要件がある場合はプロバイダーの指定を検討してください。

GPT Image で Unknown parameter: response_format エラーが出た場合の対処法は？

response_format は DALL·E の旧パラメーターです。GPT Image は base64（data[0].b64_json）のみを返し、画像 URL は提供しません。response_format を削除し、output_format で png、jpeg、webp を指定してください。OfoxAI 経由ではこのパラメーターは無視され、エラーにはなりません。

gpt-image を呼び出すと「Your organization must be verified」と表示される場合はどうすればよいですか？

これは OpenAI に直接アクセスする際に求められる組織認証です。OfoxAI 経由であれば、ご自身で組織認証を行う必要はありません。OfoxAI の API キーで gpt-image-2.5-flare、gpt-image-2.5-sunburst、gpt-image-2 を呼び出せます。

GPT Image のリクエストがタイムアウトする、または 504 や 524 が返る場合はどうすればよいですか？

API は同期型で、高品質・大サイズ・編集のリクエストは数分かかる場合があります。クライアントのタイムアウトを 600 秒に設定し、Nginx、Vercel、Cloudflare などの中間プロキシのタイムアウトも確認してください。これらのデフォルト値は 60〜100 秒程度であることが多いです。

GPT Image で does not support the input_fidelity parameter エラーが出た場合の対処法は？

GPT Image 2.5 と gpt-image-2 は常に高忠実度で参照画像を処理するため、編集エンドポイントは input_fidelity を受け付けません。削除してください。このパラメーターは gpt-image-1.5 にのみ適用されます。

GPT Image で Invalid size エラーが出た場合の対処法は？

サイズが 4 つのルールのいずれかに違反しており、どのルールかはメッセージに示されます。divisible by 16 は幅または高さが 16 の倍数でないこと、longest edge は長辺が 3840 を超えていること、aspect ratio はアスペクト比が 3:1 を超えていること、minimum pixel budget は総ピクセル数が 655,360 未満であること（例：768x768）を意味します。1024x768、1024x1024、1536x1024 など、4 つすべてを満たすサイズを使用してください。

GPT Image で 1 枚生成するといくらかかりますか？

トークン単位で課金され、品質ティアの影響が最も大きくなります。OpenAI 公式の参考価格では、gpt-image-2 で 1024x1024 の画像を生成する場合、low で約 $0.006、medium で約 $0.053、high で約 $0.211 です。2.5 の 2 モデルは出力画像トークンが 100 万あたり $30 で、1024x1024 の low は約 $0.006 です。実際の課金はレスポンスの usage に従います。OfoxAI のリアルタイム価格はモデルページを参照してください。

GPT Image 2.5 で編集する際にプロバイダーを指定する必要はありますか？

必要ありません。Azure と OpenAI のどちらも 2.5 の編集エンドポイントを提供しており、ゲートウェイが自動でルーティングします。

Last updated on
テキストから画像生成