MCP 服务器

使用 API 密钥，将 Claude Code、Cursor、Codex、VS Code 和其他 MCP 客户端连接到 SeedRouter 的图像和视频模型。

SeedRouter 运行着一个远程 Model Context Protocol 服务器。AI 智能体可以通过它列出图像和视频模型、读取模型的请求结构和价格、提交生成任务并获取结果，无需你编写接入代码。

https://api.seedrouter.ai/v1/mcp

传输方式： Streamable HTTP，无状态。服务器支持协议版本 2026-07-28，也支持以 initialize 握手开始的早期版本，最早可追溯到 2024-11-05。
认证： 将你的 SeedRouter API 密钥作为 Bearer 令牌发送，即 Authorization: Bearer YOUR_API_KEY。在 API 密钥页面创建密钥；详见认证。
计费： 与 HTTP API 相同。每次 submit_task 调用相当于向对应的任务端点发送一次请求，计费方式也相同。

仅支持通过 OAuth 登录、且没有自定义请求头输入字段的客户端，目前还无法连接。

连接客户端

API 密钥页面提供通过 MCP 连接按钮，可为以下各客户端的配置填入你的一把密钥。

Claude Code

claude mcp add --transport http seedrouter https://api.seedrouter.ai/v1/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

Cursor

添加到 ~/.cursor/mcp.json，或项目中的 .cursor/mcp.json：

{
  "mcpServers": {
    "seedrouter": {
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

Codex CLI

Codex 从环境变量中读取密钥：

export SEEDROUTER_API_KEY=YOUR_API_KEY
codex mcp add seedrouter --url https://api.seedrouter.ai/v1/mcp \
  --bearer-token-env-var SEEDROUTER_API_KEY

Codex 保存的是变量名，而非密钥。请在已设置 SEEDROUTER_API_KEY 的 shell 中启动 Codex，例如在 shell 配置文件中导出该变量。

VS Code

添加到 .vscode/mcp.json：

{
  "servers": {
    "seedrouter": {
      "type": "http",
      "url": "https://api.seedrouter.ai/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

其他支持远程 Streamable HTTP 服务器和自定义 Authorization 请求头的客户端，也采用相同的配置方式。

工具

工具	用途	是否从余额扣费
`list_models`	列出 `submit_task` 接受的模型 ID，并附上各模型的文档链接。可选参数 `endpoint`：`images` 或 `videos`。	否
`get_model_schema`	返回模型请求体的 JSON Schema。JSON Schema 无法表达的规则，例如条件性要求和跨字段限制，由 API 强制执行，并在模型文档页中说明。	否
`get_pricing`	返回模型当前以美元计价的公开价格，数据来自计费所用的同一套实时费率，包含适用的模型价格档位。	否
`submit_task`	提交一个任务：传入 `model` 和 `input`，后者为 `get_model_schema` 描述的请求体。返回任务 ID。	是，每次创建任务的调用都会扣费
`get_task`	返回任务状态和输出。可选参数 `wait_seconds`（0–50）可在任务仍在运行时于服务端等待。	否
`get_balance`	返回密钥所属账号的剩余余额，单位为美元。	否

submit_task 不具有幂等性。重试调用会再创建一个任务并再次扣费，因此，在重试未收到结果的调用前，请先检查 get_task、get_balance 或你的任务历史。

典型流程

调用 list_models，传入 endpoint: "images"。
对选定的模型调用 get_model_schema。
如需先查看费率，可调用 get_pricing。
调用 submit_task，传入 model 和符合结构要求的 input。
调用 get_task，传入 wait_seconds: 50；在 status 为 processing 时重复调用，然后读取 output。Seedance 任务会先报告 queued 和 running，再变为 succeeded。

与 HTTP API 一样，生成过程是异步的：任务一旦受理，submit_task 就会返回。wait_seconds 让智能体无需循环轮询，但较长的视频仍可能需要多次调用 get_task。如果等待期间的状态查询因限流或服务器错误等临时原因失败，get_task 会返回最后一次的 processing 结果，而非错误；请再次调用。

沿用 HTTP API 的规则

参考图片、视频和音频必须使用公开的 http(s) URL。不接受 Base64 输入。
HTTP API 返回响应时，其响应体会原样作为工具结果返回，使用相同的错误码。请求到达 HTTP API 之前发生的错误，例如未知模型或无效的工具参数，会以纯文本错误消息返回。若密钥在 MCP 端点本身被拒绝，则返回 HTTP 401。
失败的任务不计费。
默认情况下，一个账号最多可同时运行 50 个图像和视频任务。在运行中的任务完成前，继续提交会返回 HTTP 429 和错误码 30002；详见通过 AI 智能体使用 SeedRouter。
模型 ID 和参数以各模型的文档为准。模型在 API 上线后，就会出现在 list_models 中。
MCP 不提供文本模型。请通过文本端点调用，或按在 SeedRouter 上运行编程智能体中的说明，使用文本模型运行编程智能体。

On this page