GPT Image 2 · 画像生成

POST/v1/images/generations

リクエストパラメータ

Authorization

Header に Authorization を追加し、値は Bearer の後に API キーを続けます。

Authorization: Bearer ****************

Header パラメータ

Content-Typestring任意

application/json

Acceptstring任意

application/json

Body パラメータapplication/json必須

modelstring必須

モデル ID。`gpt-image-2` に固定

promptstring必須

画像の説明

ninteger任意

生成枚数、デフォルト `1`

sizestring任意

解像度、例 `1024x1024`

qualitystring任意

品質ティア（モデルが対応する場合）

response_formatstring任意

返却形式。`url` は対応するモデル（DALL-E など）のみ有効。OpenAI gpt-image は常に `b64_json` を返し、このフィールドを無視します。

output_formatstring任意

出力画像のエンコード形式（png / jpeg / webp）。OpenAI gpt-image モデルに適用。

output_compressioninteger任意

圧縮レベル 0–100。jpeg / webp のみ有効。

backgroundstring任意

背景タイプ（transparent / opaque / auto）。transparent は png または webp が必要。

moderationstring任意

モデレーション強度（auto / low）。上流でも審査されます。

userstring任意

不正利用検出のため上流へ転送する任意のエンドユーザー識別子。

例

{
  "model": "gpt-image-2",
  "prompt": "雪の中を走るゴールデンレトリバー",
  "n": 1,
  "size": "1024x1024",
  "response_format": "b64_json"
}

{  "model": "gpt-image-2",  "prompt": "雪の中を走るゴールデンレトリバー",  "n": 1,  "size": "1024x1024",  "response_format": "b64_json"}

リクエストコード例

curl https://api.hotrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "雪の中を走るゴールデンレトリバー",
    "n": 1,
    "size": "1024x1024",
    "response_format": "b64_json"
  }'

curl https://api.hotrouter.ai/v1/images/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "gpt-image-2",    "prompt": "雪の中を走るゴールデンレトリバー",    "n": 1,    "size": "1024x1024",    "response_format": "b64_json"  }'

レスポンス

200 · 成功

createdinteger任意

作成タイムスタンプ（秒）

dataarray[object]必須

生成された画像

例

{
  "created": 1730000000,
  "data": [
    {
      "b64_json": "<base64>"
    }
  ]
}

{  "created": 1730000000,  "data": [    {      "b64_json": "<base64>"    }  ]}

GPT Image 2 · 画像生成

リクエストパラメータ

リクエストコード例

レスポンス

On this page