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。