GPT-Image のパラメーターと API の違い

画像生成・編集 API における GPT-Image シリーズのパラメーターの違いと使い方を確認します。

選択したモデルに合わせて生成・編集・出力パラメーターを調整してください。完全なリクエストとレスポンスの構造は、画像を生成と画像を編集を参照してください。

対象モデル

モデル	対応 API
gpt-image-2.6-sunburst新着 gpt-image-2.6-flare新着 gpt-image-2.5-sunburst gpt-image-2.5-flare gpt-image-2 gpt-image-1.5	OpenAI Images：画像生成、画像編集

生成パラメーターの違い

フィールド	違い
`quality`	2.6 と 2.5 は `auto/low/medium/high/xhigh/max`、2 と 1.5 は `auto/low/medium/high` に対応します。いずれもデフォルトは `auto` です
`size`	1.5 は `auto`、`1024x1024`、`1024x1536`、`1536x1024` に対応します。2 と 2.5 はカスタム寸法に対応し、各辺は 16 の倍数かつ 3840 以下、縦横比は 1:3～3:1、総ピクセル数は 655360～8294400 です。3686400 ピクセルを超えるサイズは実験的です
`size` (2.6)	`auto` またはカスタム寸法に対応します。幅と高さは 16 の倍数、縦横比は 1:3～3:1 にしてください。GIF にはフレーム数と総ピクセル予算の制限もあるため、静止画のサイズ設定をそのまま使わないでください
`complexity`	2.6 は `low/medium/high` に対応し、デフォルトは `high` です。生成前の計画に使う計算量を制御し、`quality` は描画の細かさを制御します。それぞれ独立して設定します
`background`	透過背景には `transparent` を明示し、ラスター出力には `png` または `webp` を使います。JPEG はアルファチャンネルを保持しません。2 の透過背景は公式のプレビュー機能です

編集パラメーターの違い

フィールド	違い
`input_fidelity`	1.5 は `low/high` に対応し、デフォルトは `low` です。入力の細部を保つには `high` を選びます。2 は常に高忠実度で処理するため、このフィールドを省略します。2.6 でも省略し、1.5 の設定を新しいモデルにそのまま適用しないでください
`markup`	2.5 と 2.6 はマークアップによる編集に対応します。向きの補正後の最初の入力画像と同じ寸法で、透明部分を含む PNG オーバーレイを用意し、変更内容をプロンプトで説明します
`mask`, `markup`	どちらか一方を指定します。複数画像の場合は最初の画像に適用されます。マスクは透明部分で編集領域を指定し、マークアップは丸や矢印などで編集位置を示します
`output_format`	編集結果には `png/jpeg/webp` を使います。SVG、GIF 出力には画像生成 API を使ってください

出力形式の違い

フィールド	違い
`output_format`	対象の全モデルが `png/jpeg/webp` に対応し、デフォルトは `png` です。2.6 の画像生成は `svg/gif` にも対応します
`output_compression`	`jpeg/webp` 専用で、範囲は `0～100` です。PNG、SVG、GIF では省略します
SVG	2.6 の画像生成で `output_format: "svg"` と `n: 1` を指定し、ストリーミングや中間画像は使いません。`data[0].b64_json` をデコードして `.svg` として保存します。内容は UTF-8 XML です
`svg`	最上位の画像 `model` とは別に、SVG を記述するモデルを選びます。SVG モデル選択が有効な場合のみ `svg.model` を指定し、それ以外ではオブジェクト全体を省略します。`svg.reasoning` と画像の `complexity` は独立した制御です
GIF	2.6 の画像生成で `output_format: "gif"` を指定し、ストリーミング、中間画像、独自の圧縮設定は使いません。`data[].b64_json` をデコードして `.gif` として保存します
`frame_count`	GIF 専用で `2～16` フレーム、デフォルトは `9` です。フレーム数、各フレームの寸法、`n` は総ピクセル予算を共有するため、超える場合はいずれかを減らします
`frame_duration_ms`	GIF 専用で `20～2000` ミリ秒、デフォルトは `200` です。10 ミリ秒単位に丸めます

リクエスト例

MODEL_ID をプラットフォームが提供する完全なモデル ID に置き換えてください。以下の生成・SVG・GIF の例は 2.6、マークアップ編集の例は 2.5 または 2.6 を使います。

curl 'https://api.agtcloud.ai/v1/images/generations' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "MODEL_ID",
    "prompt": "OPEN TODAY を見出しにした、読みやすい文字配置のシンプルなカフェ開店ポスター",
    "quality": "medium",
    "complexity": "high",
    "size": "1024x1024",
    "output_format": "png"
  }'