クイックスタート

API キーを作成する

サインインして API キーでキーを作成します。最初に表示されたときに保存してください。請求でクレジットを追加します。

サーバー環境に SEEDROUTER_API_KEY を設定してください。Python の例には requests パッケージが必要です。

タスクを送信する

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 を保存し、同じアカウントの API キーで照会します:

curl https://api.seedrouter.ai/v1/tasks/YOUR_TASK_ID \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

ステータスが processing の間は 3 秒ごとに繰り返してください。completed になったら output.data[].url を読み取ります。failed の場合は error を確認してください。

ポーリングのタイムアウトは生成を取り消しません。タスク ID を保存して照会を再開してください。別の生成リクエストを送信しないでください。

完全なポーリングの例はタスクを、編集・品質・サイズのオプションは GPT Image 2 を参照してください。