通过 AI 智能体使用 SeedRouter

智能体可以通过三种方式使用 SeedRouter。这些方式共用相同的 API 密钥、余额、模型和限制，计费方式也相同。

如果要让智能体本身使用 SeedRouter 的文本模型运行，请参阅在 SeedRouter 上运行编程智能体。

只需设置一次密钥

在 API 密钥页面创建密钥并导出为环境变量，让智能体能够读取，同时避免将密钥写入项目文件：

export SEEDROUTER_API_KEY=YOUR_API_KEY

API 密钥页面也提供通过 MCP 连接按钮，可为各 MCP 客户端生成可直接使用的配置。

智能体如何使用 SeedRouter

1. 查找模型：通过 MCP 调用 list_models，或查看 /llms.txt 中的模型列表。每个有落地页的模型都在 https://seedrouter.ai/models/<slug>/llms.txt 提供纯文本摘要，包含参数、价格和示例。
2. 读取输入结构：通过 MCP 调用 get_model_schema，或查看模型文档页。
3. 使用公开的媒体 URL：生成端点只接受以公开 http(s) URL 提供的参考图片、视频和音频。不接受 Base64 输入，因此请先将本地文件托管到可访问的位置。
4. 查看价格：通过 MCP 调用 get_pricing，可在提交任何任务前获取模型当前以美元计价的费率。
5. 提交并等待：先调用 submit_task，再调用 get_task 并传入 wait_seconds: 50，直到任务完成。使用 HTTP 时，向模型端点提交请求，然后约每三秒轮询一次 GET /v1/tasks/{id}。

失败的任务不计费。提交操作不具有幂等性：重试未收到响应的请求，会再创建一个任务并再次扣费，因此请先检查你的任务历史或余额。

需要考虑的限制

请求也可能因短时间内过多而被限流，同样会返回 HTTP 429。遇到 HTTP 429 时，如果有 Retry-After，请按其指定的时间等待；否则采用指数退避，在每次重试时延长等待时间、加入随机抖动，并设置最长等待时间。请依据状态码做出判断，而不是解析错误响应体，因为文本端点会使用各自协议的错误格式。批量任务应维护一个队列，在运行中的任务完成后再提交新任务，而不是一次性全部发送。如需提高限额，请联系 [email protected]。

机器可读的入口