GPT Image 2 API のパラメータ：サイズ、解像度、アスペクト比、品質
画像を左右する GPT Image 2 API のパラメータを解説。モデル名、サイズと解像度、アスペクト比、4K の制限、品質、出力形式、誤った値で返るエラーまで。
Markdown で読むGPT Image 2 API では、モデル名を model に、出力サイズを size に WIDTHxHEIGHT のピクセル値で、品質を quality（low、medium、high、auto）に指定します。resolution や aspect_ratio というフィールドはありません。4K の 16:9 画像が欲しければ "size": "3840x2160" を送ります。サイズは 16 の倍数で、両辺とも 3840 ピクセル以下、比率は 1:3〜3:1、総ピクセル数は 655,360〜8,294,400 の範囲に収める必要があります。
このガイドでは、画像を変えるパラメータごとに、送るべき正確な値と、誤った値で返るエラーを取り上げます。以下のエラーはすべて本番の API で確認したものです。
API での GPT Image 2 のモデル名は？
gpt-image-2 または gpt-image-2-official を使います。どちらも同じモデルで、フィールドも同じです。gpt-image-2 は納品した画像 1 枚ごとの固定料金、gpt-image-2-official は各生成で報告されたトークンに応じた課金です。
見出しに出てくる名前はモデル ID として使えません。gpt-image-2.0、GPT Image 2、chatgpt-images-2 はいずれも HTTP 400、エラーコード 20002 を返します。
解像度とアスペクト比はどう指定しますか？
size にピクセル単位で指定します。希望するアスペクト比とピクセル数の目安を決め、そこから求めた幅と高さを送ります:
| アスペクト比 | 約 1K | 約 2K | 4K |
|---|---|---|---|
| 1:1 | 1024x1024 | 2048x2048 | 2880x2880 |
| 3:2 | 1248x832 | 2496x1664 | 3504x2336 |
| 2:3 | 832x1248 | 1664x2496 | 2336x3504 |
| 4:3 | 1152x864 | 2304x1728 | 3264x2448 |
| 3:4 | 864x1152 | 1728x2304 | 2448x3264 |
| 16:9 | 1280x720 | 2560x1440 | 3840x2160 |
| 9:16 | 720x1280 | 1440x2560 | 2160x3840 |
| 21:9 | 1456x624 | 3024x1296 | 3808x1632 |
| 3:1 | 1728x576 | 3504x1168 | 3840x1280 |
これは、Playground で比率と 1K・2K・4K のプリセットを選んだときに使われる換算と同じです。正方形の 4K が 2880x2880 止まりなのは、3840 ピクセルの正方形では総ピクセル数の上限を超えてしまうためです。
size: "auto" はサイズの決定をモデルに任せます。これがデフォルトで便利ですが、出力をレイアウトや他の出力と揃える必要がある場合は、明示的なサイズを指定してください。
OpenAI は 2560×1440 を超える出力を実験的なものとしています。ここでは制限内であれば受け付けますが、キャンバスが大きいからといってディテールが増える保証はありません。
拒否される size の値は？
| 送った値 | 失敗する理由 | レスポンス |
|---|---|---|
"size": "16:9" | 比率はサイズではない | 400 20001、メッセージが size を示す |
"size": "4096x2304" | 辺が 3840 を超える | 400 20001、メッセージが size を示す |
"size": "1000x1000" | 16 の倍数ではない | 400 20001、メッセージが size を示す |
"size": "3840x1024" | 3:1 より横長 | 400 20001、メッセージが size を示す |
"resolution": "4k" | 不明なフィールド | 400 20001、フィールド名なし |
"aspect_ratio": "16:9" | 不明なフィールド | 400 20001、フィールド名なし |
最後の 2 行に注意してください。不明なフィールドは拒否されますが、エラーはそのフィールド名を示しません。20001 と汎用メッセージ “Check the parameters against the API documentation” が返ったら、resolution、aspect_ratio、response_format のような API が受け付けないフィールドがないか探してください。
品質はどれを選ぶべきですか？
quality は low、medium、high、auto を受け付けます。上の段階ほど時間がかかり、細かなディテールを保持します。xhigh と max は GPT Image 2.5 専用で、GPT Image 2 に送ると 20001 が返り、メッセージに quality が示されます。
実践的な進め方は次のとおりです。構図がまだ変わっている間は low で下書きし、質感や小さな文字は medium で確認し、最終版は high で生成します。gpt-image-2 ではどの段階でも料金は同じです。gpt-image-2-official では上の段階ほど報告される出力トークンが増えるため、コストも上がります。具体的な数値は料金ガイドで示しています。
auto は段階の選択をモデルに任せます。実行結果を比較するときは明示的な値を指定してください。そうしないと、「同じ」はずの 2 つのリクエストが異なる段階で生成される可能性があります。
出力形式と背景は何で制御しますか？
output_format：png（デフォルト）またはjpeg。WebP 出力は提供していません。webpを送ると20001が返り、メッセージにoutput_formatが示されます。output_compression：0〜100、jpegのときのみ。background：auto、opaque、transparent。透過にはpngが必要です。jpegでtransparentを指定すると20001が返り、メッセージにbackgroundが示されます。n：1 リクエストあたり 1〜10 枚。課金されるのは納品された画像の枚数です。moderation：autoまたはlow。
参照画像とマスクはどう渡しますか？
ファイルや base64 ではなく、必ず URL で渡します。images は {"image_url": "https://..."} 形式のオブジェクトを 1〜16 個受け付け、これを送るとリクエストが編集になります。mask は同じ形式のオブジェクトを 1 つ受け付けます。1 枚目の参照画像と同じサイズの PNG で、透明な部分が変更する範囲を示します。ファイルの制限はリファレンスに記載しています。
よくある質問
GPT Image 2 は 4K に対応していますか？
はい、上記の制限内で対応しています。16:9 なら 3840x2160、9:16 なら 2160x3840 が最大のフレームで、正方形の最大は 2880x2880 です。
ピクセルの代わりにアスペクト比を送れますか？
API には送れません。上の表か Playground を使って、先に比率を WIDTHxHEIGHT のサイズに換算してください。Playground は送信前に正確なサイズを表示します。
サイズと品質のデフォルトは？
どちらもデフォルトは auto で、選択はモデルに任されます。予測どおりの出力が必要な場合は、明示的な値を送ってください。
ピクセルで送り、品質を指定し、エラーメッセージを読む
パラメータの問題は、ほぼすべてが次の 3 つのいずれかです。比率をサイズとして送った、API が受け付けないフィールドを送った、値が制限を外れている。1 つ目と 3 つ目ではエラーメッセージがフィールド名を示し、フィールド名のない汎用メッセージは 2 つ目を示します。連携作業中は、このページを GPT Image 2 API リファレンスと並べて手元に置いてください。
