Claude Opus 5.5 が SeedRouter で利用できます

Codex や Claude Code などのコーディングエージェントで GPT Image 2 を使う

Codex や Claude Code などのエージェントに、あなたの API キーで GPT Image 2 の画像を生成させる方法。有料リクエストの前に毎回確認する再利用可能なプロンプト付き。

Markdown で読む

Codex や Claude Code のようなコーディングエージェントは、API を直接呼び出して GPT Image 2 の画像を生成できます。API キーを環境変数に設定し、以下のプロンプトをエージェントに渡せば、エージェントがリクエストを組み立ててあなたに見せ、承認後に送信し、タスクをポーリングして、画像をプロジェクトに保存します。プラグインは不要です。シェルコマンドや短いスクリプトを実行できるエージェントなら、API を呼び出せます。

SeedRouter は MCP サーバーやパッケージ化されたスキルを提供していません。このガイドのプロンプトが連携のすべてです。お使いのエージェントで、再利用可能な指示として保存できます。

エージェントが作業を始める前に必要なものは?

必要なものは 3 つです:

  1. 環境変数に設定した API キー。 API キーのページで作成し、エージェントが動くシェルで export してください。エージェントはそこからキーを読み込みます。キーの貼り付けをあなたに求めることがあってはいけません。
  2. ネットワークアクセス。 エージェントは https://api.seedrouter.ai を呼び出すため、この作業ではサンドボックスで外部へのリクエストを許可する必要があります。
  3. クレジット。 リクエストは残高から支払われるので、最初の実行の前にチャージしてください。
export SEEDROUTER_API_KEY="your-key"

エージェントにはどのプロンプトを渡すべきですか?

作業の最初にこれを貼り付け、角かっこ内の目標を埋めてください。API が受け付けるフィールドを正確に列挙しているのでエージェントがパラメータを捏造せず、課金が発生する前に必ずあなたの承認を待つようになります:

Use the SeedRouter API to generate a gpt-image-2 image for me.

Security: read SEEDROUTER_API_KEY from my local environment. Never ask me to paste it and never expose it in code, prompts, logs, or output.

Goal:
- Use case: [product / social / concept art / UI mockup]
- Subject and style: [subject, composition, lighting, style]
- Size: [auto | 1024x1024 | 1536x1024 | 1024x1536 | WIDTHxHEIGHT]
- Quality: [auto | low | medium | high]
- Number of images: [1-10]
- Acceptance criteria: [e.g. no text in the image, consistent product, clean background]

Request fields this endpoint accepts, and nothing else:
  model (required, "gpt-image-2"), prompt (required, up to 32000 chars),
  n (1-10, default 1), size (default auto; a custom WIDTHxHEIGHT must have
  both sides divisible by 16, neither edge over 3840, total pixels between
  655360 and 8294400, and keep a ratio between
  1:3 and 3:1), quality (auto|low|medium|high, default auto),
  background (auto|opaque|transparent, default auto; transparent requires
  output_format png), output_format (png|jpeg, default png),
  output_compression (0-100, default 100, jpeg only),
  moderation (auto|low, default auto), user (your own identifier).
For editing use /v1/images/generations with images: [{image_url: "https://..."}]
(up to 16) and optional mask: {image_url: "https://..."}. Mask requires images.
Inputs must be URLs, not base64 or multipart files. stream and partial_images
are not supported because delivery is asynchronous.

Before any paid request, show me the model id, the exact request body and the
estimated cost, then wait for my explicit approval.

After approval:
1. POST https://api.seedrouter.ai/v1/images/generations with the body above and
   an Authorization: Bearer $SEEDROUTER_API_KEY header.
2. Save the task id from the response "id" field. The response is
   {"id": "...", "status": "processing"} — the image is not in it.
3. Poll https://api.seedrouter.ai/v1/tasks/{task_id} with the same header every
   5-10 seconds until status is "completed" or "failed". Do not retry forever;
   if you stop waiting, preserve the task id and report that it is still pending.
   A polling timeout is not a failed task. Never submit a duplicate just to check status.
4. On success, download every URL in output.data[].url, return the local paths,
   the task id, and the parameters used. The response carries no cost field.
5. On failure, keep the task id, explain the reason and what to change, and do
   not retry without my approval. A task that ends failed is not charged.

いちばん重要なのは承認のステップです。自分の判断で再試行するエージェントは、同じ有料リクエストを何度も送信しかねません。設定を信頼できるようになっても、この指示は残しておいてください。

Codex ではどう使いますか?

プロジェクトで Codex を開き、目標を埋めたプロンプトを貼り付けます。再利用したい場合は、Codex がリポジトリ用に読み込む指示ファイルであるプロジェクトの AGENTS.md に、「画像の生成」のような見出しを付けてプロンプトを追加してください。そうすれば「料金ページのヒーロー画像を作って」と頼むだけで、Codex が保存された手順に従います。

Codex がネットワークアクセスのないサンドボックスで動いている場合、API には到達できません。生成を頼む前に、そのセッションでネットワークアクセスを許可してください。

Claude Code ではどう使いますか?

同じプロンプトが Claude Code でも使えます。再利用するには、プロジェクトの CLAUDE.md に保存するか、スキルとして保存します。スキルは、指示にプロンプトを含む SKILL.md ファイルを置いたフォルダです。こうしておけば、画像を頼んだときに Claude Code がそれを読み込みます。Claude Code を起動するターミナルで SEEDROUTER_API_KEY が export されていることを確認してください。

うまくいくエージェントの実行とは?

  1. あなたが画像の内容と配置先を説明します。
  2. エージェントがモデル ID、正確なリクエストボディ、見積もりコストを示し、待機します。
  3. あなたが承認します。エージェントは 1 回だけ送信し、タスク ID を報告します。
  4. タスクが完了するまでポーリングし、画像をプロジェクトにダウンロードして、ファイルパスを伝えます。

実行が途中で止まっても、タスク ID は有効なままです。生成し直すのではなく、その ID のポーリングを再開するようエージェントに頼んでください。2 回目の送信は 2 回目の課金になります。失敗で終わったタスクは課金されません。

よくある質問

SeedRouter 製の GPT Image 2 MCP サーバーやスキルはありますか?

ありません。API そのものが連携手段であり、上のプロンプトがエージェントの呼び出しに必要なものをすべて与えます。再利用したい場合は、ご自身のエージェントでプロンプトをスキルや指示ファイルとして保存してください。

エージェントはプロジェクト内の既存画像を編集できますか?

画像が公開 HTTPS URL でアクセスできるなら、できます。API は参照画像とマスクをローカルファイルではなく URL で受け取るため、先にアップロードするか、画像のホスト先をエージェントに伝えてください。

エージェントにはどのモデルを使わせるべきですか?

納品した画像 1 枚ごとの固定料金なら gpt-image-2、各生成で報告されたトークンで支払うなら gpt-image-2-official です。切り替えるにはプロンプト内のモデルを書き換えてください。最新の料金はモデルページに掲載しています。

人間の判断をループに残す

キーは環境変数で、フィールドはプロンプトで、最終判断は承認ステップでエージェントに渡してください。この組み合わせにより、Codex や Claude Code は想定外の課金なしにプロジェクト内で画像を生成できます。プロンプトを拡張したい場合は、GPT Image 2 API リファレンスにすべてのフィールドが載っています。

関連ガイド