Claude Opus 5.5 が SeedRouter で利用できます
LogoSeedRouter
すべての記事

GPT Image 2 API キーの取得方法と最初のリクエスト

GPT Image 2 の API キーを取得して安全に保管し、クレジットをチャージして curl・Python・JavaScript で最初のリクエストを送る方法と、よくあるエラーを解説します。

Markdown で読む

はい、GPT Image 2 には API があり、SeedRouter では API キー 1 つで利用できます。サインインして API キーのページでキーを作成し、請求ページでクレジットをチャージしたら、Authorization: Bearer ヘッダーにキーを付けて https://api.seedrouter.ai/v1/images/generations に送信します。キーの全体が表示されるのは作成時の 1 回だけなので、すぐにサーバーの環境変数にコピーしてください。

以下の手順では、アカウントがない状態から画像が完成するまでを順に説明し、最初のリクエストを止める原因の大半を占める 4 つのエラーも取り上げます。

GPT Image 2 の API キーはどう取得しますか？

  1. Google アカウントで SeedRouter にサインインします。
  2. API キーを開いてキーを作成します。production-server のように、どこで動かすかが分かる名前を付けてください。
  3. キーはすぐにコピーしてください。この画面を離れるとマスクされた表示しか見られず、紛失したキーは復元できません。その場合は失効させて新しいキーを作成します。
  4. 請求ページでクレジットをチャージします。キーは作成した時点で有効ですが、リクエストの実行にはクレジットが必要です。

1 つのキーで SeedRouter のすべてのモデルを利用できるため、GPT Image 2 と GPT Image 2.5 で別々のキーを用意する必要はありません。代わりに、環境ごとにキーを分けてください。そうすれば、ステージング用のキーを失効させても本番環境が止まることはありません。

API キーはどこに保管すべきですか？

サーバー上の環境変数に保管し、それ以外の場所には置かないでください:

export SEEDROUTER_API_KEY="your-key"

キーをブラウザの JavaScript、モバイルアプリのバンドル、公開リポジトリに入れてはいけません。キーを読めた人は誰でもあなたのクレジットを使えてしまいます。プロダクトにフロントエンドがある場合は、フロントエンドから自社のバックエンドを呼び出し、バックエンドがキーを使って API を呼び出すようにしてください。

キーが漏洩した場合は、すぐに API キーのページで失効させてください。失効したキーは使えなくなり、そのキーを使ったリクエストは拒否されます。

API キーで最初のリクエストを送るには？

キーを Bearer トークンとして送信します。レスポンスは画像ではなく、タスクへの参照です:

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "An amber glass bottle on a cream background, studio lighting",
    "size": "1024x1024",
    "quality": "low"
  }'

レスポンスの id を保存し、同じヘッダーを付けて status が completed になるまで GET https://api.seedrouter.ai/v1/tasks/{id} をポーリングします。完了したタスクには画像 URL が含まれます。コードでの一連の流れは Python で使う GPT Image 2 API を参照してください。

GPT Image 2 には同じフィールドを受け付ける 2 つのモデル ID があります。gpt-image-2 は納品した画像 1 枚ごとの固定料金、gpt-image-2-official は各生成で報告されたトークンに応じた課金です。キーはどちらでも使えます。最新の料金はモデルページに掲載しています。

新しい API キーでよく起きるエラーは？

エラーコードHTTP意味対処
10001401キーがない、打ち間違い、または失効しているAuthorization ヘッダーでキー全体を送る
20002400model の値が提供中の ID ではないgpt-image-2 または gpt-image-2-official を正確に指定する
20001400フィールドに誤りがある。可能な場合はメッセージがそのフィールドを示す再試行の前にそのフィールドを修正する
30001402アカウントのクレジットが残っていないクレジットをチャージして再送信する

最初のリクエストの失敗は、たいてい 2 つのうっかりミスが原因です。1 つは、文字が欠けていたり余計なスペースが入ったりした状態でキーを貼り付けることで、10001 が返ります。もう 1 つは、モデル ID ではなく gpt-image-2.0 や GPT Image 2 のような見出しのモデル名をコピーすることで、20002 が返ります。どちらも処理が始まる前に拒否されるため、課金はされません。

無料の GPT Image 2 API キーはありますか？

ありません。キーの作成は無料ですが、リクエストは前払いのクレジットから支払われます。支払いが発生しないのは失敗したときです。failed で終わったタスクや、画像が返らなかったタスクには料金がかかりません。クレジットは 1 回ごとのチャージで購入し、有効期限はなく、サブスクリプションもありません。そのため、最初は少額のチャージでも連携を十分にテストできます。

1 つのキーを Python と JavaScript の両方で使えますか？

使えます。キーは HTTP ヘッダーに入る文字列なので、HTTP リクエストを送れる言語ならどれでも使えます。各ランタイムで環境変数から読み込んでください。Python なら os.environ["SEEDROUTER_API_KEY"]、Node.js なら process.env.SEEDROUTER_API_KEY です。JavaScript はサーバー側で動かしてください。同じキーをブラウザのコードに入れると、すべての訪問者に見えてしまいます。

よくある質問

ここで GPT Image 2 を使うのに OpenAI の API キーは必要ですか？

必要ありません。送信する認証情報は SeedRouter のキーだけです。この API で GPT Image 2 を呼び出すために、別のサービスでアカウントを作成・管理する必要はありません。

API キーはいくつ作成できますか？

サーバーやサービスごとに 1 つずつ作れる数です。アカウントあたりの上限は、連携に必要な数を大きく上回ります。各キーは個別に失効させられます。

キーごとの利用額はどこで確認できますか？

使用履歴で確認できます。リクエストごとにモデルと請求額が表示されるので、新しい連携の実績を見積もりと照らし合わせやすくなります。

キーはサーバーに置いて、あとは実装へ

環境ごとにキーを作成し、環境変数に保管して、バックエンドからだけ Bearer トークンとして送信してください。最初のリクエストでタスクの id が返れば、アクセスの準備は完了です。その先は GPT Image 2 API リファレンスがすべてです。

すべての記事

関連ガイド