工具快速开始

大多数 AI 工具需要以下 GetRouter 配置:

Provider 名称: GetRouter
API Key:       YOUR_API_KEY
Base URL:      https://getrouter.ai/v1
模型:           MODEL_ID

通用配置流程

  1. 打开工具的 ProvidersModelsAPI 设置。
  2. 选择 OpenAI-compatibleCustom OpenAICustom Provider
  3. 填写 GetRouter API Key。
  4. 填写工具要求的 Base URL。
  5. 粘贴模型页面中的准确模型 ID。
  6. 保存 Provider。
  7. 发送一条简短测试消息。
Warning

上面的通用 Base URL 适用于 OpenAI 兼容工具。Codex、Claude 兼容工具和 Gemini 兼容工具可能需要其他协议或额外配置,请使用集成指南中的专用文档。

判断工具需要什么

请检查工具的 Provider 设置或文档:

工具字段通常填写
OpenAI Base URL / API Hosthttps://getrouter.ai/v1
完整 Chat Completions 接口https://getrouter.ai/v1/chat/completions
Responses 接口https://getrouter.ai/v1/responses
Claude Messages 接口https://getrouter.ai/v1/messages
Gemini API Roothttps://getrouter.ai,并按照工具要求配置 Gemini 路径

如果工具已经自动添加路径,就不要再次添加。

验证连接

先用一个短文本请求验证。成功后,再测试实际需要的高级能力,例如流式输出、推理、Tool Calling、视觉或媒体生成。

如果工具能加载模型但无法发送消息,所选模型可能不支持该工具使用的协议。

推荐的 Key 规划

每个工具使用独立 API Key:

Codex Laptop
OpenClaw Home
Chat Client
Automation

这样可以分别识别用量,并在不影响其他工具的情况下撤销某个接入。

排查清单

  • 删除 API Key 前后的空格。
  • 检查工具是否自动添加 /v1
  • 确认工具实际调用 /chat/completions/responses 还是 /messages
  • 使用模型页面中的准确模型 ID。
  • 如果工具只在启动时读取环境变量,请重启工具。
  • 查看对应的集成指南

下一步