GetRouter文档
  • 简体中文

    • Base URL 与协议

    Base URL 是 GetRouter 集成中最容易配置错误的项目。不同 SDK 会自动追加不同路径；有些工具要求填写 Base URL，有些则要求完整 Endpoint。

    快速选择

    使用方式应填写的值客户端通常追加
    OpenAI SDK、Chat Completions、Responseshttps://getrouter.ai/v1/chat/completions、/responses 等
    Anthropic SDK、Claude Codehttps://getrouter.ai/v1/messages
    Gemini 原生 SDK / APIhttps://getrouter.ai/v1beta/models/...
    要求完整 Chat Endpoint 的工具https://getrouter.ai/v1/chat/completions不再追加路径
    不要对所有工具都填写同一个 URL

    字段叫 Base URL、API Host、Endpoint 或 Proxy URL 时，含义可能不同。请优先使用对应的集成指南。

    OpenAI 兼容协议

    OpenAI SDK 的 base_url / baseURL 应包含 /v1：

    https://getrouter.ai/v1

    常用公开路径包括：

    GET  /v1/models
POST /v1/chat/completions
POST /v1/responses
POST /v1/embeddings
POST /v1/images/generations
POST /v1/audio/transcriptions
POST /v1/audio/speech
POST /v1/rerank

    认证方式：

    Authorization: Bearer YOUR_API_KEY

    Anthropic Messages 协议

    Anthropic SDK 和 Claude Code 通常从服务根地址自动拼接 /v1/messages：

    https://getrouter.ai

    认证方式：

    x-api-key: YOUR_API_KEY

    不要把 Claude Code 的 ANTHROPIC_BASE_URL 设置为 https://getrouter.ai/v1，否则某些版本会形成重复路径。

    Gemini 兼容协议

    Gemini 原生请求从服务根地址开始：

    https://getrouter.ai

    常见认证方式：

    x-goog-api-key: YOUR_API_KEY

    也支持使用查询参数：

    ?key=YOUR_API_KEY

    如何判断填错了 URL

    实际请求或错误原因修复
    /v1/v1/chat/completionsBase URL 和客户端都添加了 /v1去掉其中一个 /v1
    /chat/completions工具未添加 /v1改用完整 Endpoint 或包含 /v1 的 Base URL
    /v1/responses/responses把完整路径填入了 Base URL改为 https://getrouter.ai/v1
    Claude 请求 404Claude 客户端路径拼接不正确使用服务根地址 https://getrouter.ai

    如果工具能显示调试日志，请以最终发出的请求 URL为准，而不是只看设置字段名称。