API Reference
快速上手
提交你的第一個影像任務並取得結果。
建立 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 期間，每三秒重複查詢一次。狀態變為 completed 後，讀取 output.data[].url。若為 failed，請檢查 error。
輪詢逾時並不會取消生成。請儲存任務 ID 並繼續查詢，不要再提交一次生成請求。
完整的輪詢範例請參見任務，編輯、品質和尺寸選項請參見 GPT Image 2。