GetRouter文档
  • 简体中文

    • 协议与 URL 规则

    工具能否接入 GetRouter，取决于三个条件：它允许自定义 API Key、允许自定义服务地址，并且使用 GetRouter 已公开支持的协议。

    协议矩阵

    协议GetRouter Base URL认证典型最终路径常见工具
    OpenAI Chat Completionshttps://getrouter.ai/v1Bearer/v1/chat/completionsChatbox、Cherry Studio、Cline
    OpenAI Responseshttps://getrouter.ai/v1Bearer/v1/responsesCodex、OpenClaw
    Anthropic Messageshttps://getrouter.aix-api-key/v1/messagesClaude Code、Anthropic SDK
    Gemini-compatiblehttps://getrouter.aix-goog-api-key 或 ?key=/v1beta/models/...Gemini CLI、Google GenAI SDK
    完整 Chat Endpoint完整 URLBearer/v1/chat/completions部分只提供 Endpoint 输入框的客户端

    自动拼接的四种模式

    模式 A：追加资源路径

    工具接收 https://getrouter.ai/v1，再追加 /chat/completions 或 /responses。OpenAI SDK 属于这一类。

    模式 B：追加协议版本和资源路径

    工具接收 https://getrouter.ai，再追加 /v1/messages 或 /v1beta/models/...。Claude 和 Gemini 原生客户端常见。

    模式 C：要求完整 Endpoint

    工具不会再拼接路径，应填写：

    https://getrouter.ai/v1/chat/completions

    模式 D：字段名称不准确

    部分 GUI 把完整 Endpoint 也叫“API Host”或“Base URL”。必须以工具文档和实际网络日志为准。

    能力兼容不是二元结果

    一个工具“能聊天”不代表以下能力都可用：

    • 流式输出；
    • Tool Calling / Function Calling；
    • 图片输入；
    • JSON / Structured Output；
    • Responses 事件；
    • Prompt Caching；
    • 推理参数；
    • 异步媒体任务。

    请对所需能力逐项验证，并在模型目录确认模型能力。

    无法自定义服务地址的工具

    如果工具只接受厂商官方账号登录，或固定请求官方域名，就不能通过普通设置接入 GetRouter。不要使用浏览器扩展、Hosts 劫持或不透明代理绕过限制，这会带来凭据和稳定性风险。