概览 | SeedRouter Docs

SeedRouter 通过同一个 API、同一个 API 密钥提供图像、视频、音频和文本模型。图像、视频和音频模型以异步任务运行：提交请求后会拿到一个任务 ID，再轮询获取结果。文本模型直接返回答案，请求格式与该模型厂商的官方格式一致。

基础 URL

https://api.seedrouter.ai

请使用 HTTPS，请求体为 JSON。音频端点改用 multipart/form-data 上传文件。

每个请求（包括任务查询）都以 Bearer 令牌的形式发送你的密钥：

Authorization: Bearer YOUR_API_KEY

Anthropic Messages 端点也接受放在 x-api-key 中的密钥，并需同时带上 anthropic-version 请求头。详见认证。

方法	路径	用途
POST	`/v1/images/generations`	提交图像生成或编辑任务：GPT Image、Nano Banana 和 Midjourney。
POST	`/v1/videos/generations`	提交视频任务：Seedance 2.5 和 2.0（ModelArk 请求体）、Veo 3.1、Kling 3.0、MiniMax H3 和 SD Video。
POST	`/v1/audio/transcriptions`	提交音频文件，用 Whisper-1 转写。
POST	`/v1/audio/translations`	提交音频文件，用 Whisper-1 翻译成英文。
GET	`/v1/tasks/{id}`	读取图像、视频或音频任务的状态与结果。

参考图片、视频和音频以 URL 形式放在请求体中。图像请求包含输入图片时即为编辑。各模型的参考文档列出了其支持的参数。

方法	路径	请求格式
POST	`/v1/chat/completions`	OpenAI Chat Completions
POST	`/v1/responses`	OpenAI Responses
POST	`/v1/messages`	Anthropic Messages
POST	`/v1beta/models/{model}:generateContent`	Google Gemini
POST	`/v1beta/models/{model}:streamGenerateContent`	Google Gemini（流式）
GET	`/v1/models`	列出可用模型

并非每个文本模型都支持所有格式，模型的 API 参考会写明它接受哪些格式。例如 Claude Opus 5.5 支持 Chat Completions、Responses 和 Messages，而 Gemini 文本模型使用 /v1beta 路径。

提交请求。响应是一个任务，而不是生成好的文件：请保存它的 id。
轮询该任务，直到它进入最终状态。/v1/tasks/{id} 上的任务会先显示 processing，然后变为 completed 或 failed。
读取结果。图像位于 output.data[].url，视频位于 output.video_url，Whisper 的输出位于 output.url。所有结果链接都指向 SeedRouter 的存储。

任务失败时，请检查 error.code 与 error.message。失败的任务不计费。目前没有任务完成的 webhook，请按 Webhooks 中的说明轮询任务。

文本请求在同一个响应中返回模型的回答，响应结构与厂商官方一致。将 stream 设为 true，或对 Gemini 使用 :streamGenerateContent，即可接收服务器发送事件（SSE）。文本模型按 token 计费。