1 枚あたり定額の GPT Image 2 API

1. キーを作成する

   サインアップして $5 からチャージし、API キーでキーを作成します。画像モデルは gpt-value チャネルグループで提供しているため、自動のキーか、このグループに紐付けたキーを使ってください。

2. OpenAI SDK の接続先を Lovely Router にする

   ベース URL を https://lovelyrouter.com/v1 に設定します。リクエストは OpenAI の定義どおりに渡されるため、公式 SDK はそのまま動きます。

3. 画像を生成する

   POST /v1/images/generations は画像ができるまで接続を保持し、b64_json に base64 で返します。

   cURLPythonNode.js

   Shell

   curl https://lovelyrouter.com/v1/images/generations \
     -H "Authorization: Bearer $LOVELY_API_KEY" \
     -H "content-type: application/json" \
     -d '{
       "model": "gpt-image-2",
       "prompt": "A watercolor painting of a red fox in a snowy birch forest at dawn",
       "size": "1024x1024",
       "quality": "medium"
     }' | jq -r '.data[0].b64_json' | base64 --decode > fox.png

画像 1 枚の生成には通常 40 秒から 2 分かかり、これにキューでの待ち時間が加わります。ゲートウェイは 9 分以内に応答するため、HTTP クライアントのタイムアウトは 10 分以上にしてください。response_format: "url" は無視され、画像は常に base64 で返されます。

編集するとき、またはモデルに参考画像（商品、ロゴ、人物、スタイル）を渡すときは、最大 16 枚の画像と、必要に応じて mask を、いずれかのモデルを指定して POST /v1/images/edits に送ります。multipart/form-data のファイルでも、JSON の URL でもかまいません。編集の料金は生成と同じです。

curl https://lovelyrouter.com/v1/images/edits \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -F model=gpt-image-2 \
  -F image=@fox.png \
  -F prompt="Make it night with a full moon" | jq -r '.data[0].b64_json' | base64 --decode > fox-night.png

画像リクエストはすべてキューに入り、空きができ次第生成が始まります。そのため、一度に大量のリクエストが来ても失敗せず、順番を待ちます。各アカウントで、キュー待ちまたは生成中の画像は同時に 20 枚までです。数分間も接続を開いたままにしたくない場合は、画像ジョブを使ってください。

# Submit: returns 202 with the job id and its queue_position
curl https://lovelyrouter.com/v1/images/jobs \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{"model": "gpt-image-2", "prompt": "A red fox in a snowy birch forest", "size": "1536x1024"}'

# Wait up to 60 seconds for it, then download the file
curl "https://lovelyrouter.com/v1/images/jobs/img_8c1f0e2a9b7d4f3e6a5c2b1d?wait=60" \
  -H "Authorization: Bearer $LOVELY_API_KEY"
curl -o fox.png https://lovelyrouter.com/v1/images/jobs/img_8c1f0e2a9b7d4f3e6a5c2b1d/content \
  -H "Authorization: Bearer $LOVELY_API_KEY"

ジョブには生成と同じフィールドを指定します。入力画像を付けると、編集のジョブになります。完了したジョブの画像は 7 日間取得できます。最近のジョブの一覧を取得したり、キュー待ちのジョブをキャンセルしたりもできます。同期リクエストが 9 分経っても完了しない場合は、x-lovely-image-job ヘッダーにジョブ ID を付けて 504 が返されます。画像の生成は続くため、ジョブとして受け取れます。

コードを書かずにプロンプトや編集を試すには、プレイグラウンドを Images に切り替えます。プレイグラウンドは画像ジョブを使って動作します。

エージェントも画像を作れます。MCP サーバーには generate_image ツールがあり、GPT Image 2.5（使えない場合は GPT Image 2）を、同じ 1 枚あたりの料金で使います。参考画像も URL で渡せます。応答には、キーなしで 24 時間使えるダウンロードリンクと、ファイルを保存する curl コマンドが含まれます。まだ完成していない画像は get_image で待てます。Claude Code にサーバーを追加するには、次のようにします。

claude mcp add --transport http lovely-tools https://lovelyrouter.com/mcp \
  --header "Authorization: Bearer $LOVELY_API_KEY"

あとは、たとえば次のように頼みます。「灯台の夕暮れを描いた 1536x1024 のヒーロー画像をフラットなイラスト風で生成し、public/hero.png に保存して」

生成でも編集でも、サイズや品質にかかわらず 1 枚 $0.04 の定額です。レスポンスの usage オブジェクトは参考情報で、料金には影響しません。

画像を送信すると、その料金が残高から確保され、画像が完成した時点で精算されます。リクエストが拒否された場合、ジョブをキャンセルした場合、画像が生成されなかった場合は課金されません。画像が生成された後は、届く前にクライアントの接続が切れても課金されます。サブスクリプションはありません。同じ残高で使えるほかのプロダクトについては料金を参照してください。