集成指南

本栏目按工具的真实配置方式组织教程,而不是给所有工具套用同一个 Base URL。每篇教程都会说明协议、URL、模型配置、最终请求路径和验证方法。

先选工具类型

类型适合场景推荐教程
AI 编程代理终端内读写代码、执行任务CodexClaude CodeOpenCode
IDE 与编辑器在 VS Code、JetBrains 或编辑器内协作ClineContinueCursorZed
桌面聊天客户端多模型聊天、知识库和多媒体Cherry StudioChatbox
配置管理在多个供应商之间切换CC Switch
SDK 与框架在代码中集成模型OpenAI SDKLangChainLlamaIndex

集成前必须确认

  1. API Keys 为该工具创建独立 Key;
  2. 模型目录复制准确的 MODEL_ID
  3. 确认工具使用 Chat Completions、Responses、Anthropic Messages 还是 Gemini;
  4. 确认设置项要求 Base URL 还是完整 Endpoint;
  5. 先测试短文本,再测试流式、工具调用和图片输入。

统一状态说明

教程中的验证信息分为两层:

  • 配置格式核对:对照工具官方文档确认字段和配置位置;
  • 运行验证:在指定版本中实际连接 GetRouter 完成请求。

如果页面写着“运行验证:待验证”,表示配置已经按官方格式整理,但不应被理解为所有版本和模型组合都经过实机测试。

为什么不能只提供一份通用配置

同样叫 Base URL,工具可能有三种行为:

https://getrouter.ai/v1                 # 工具追加 /chat/completions 或 /responses
https://getrouter.ai                    # 工具追加 /v1/messages 或 /v1beta/...
https://getrouter.ai/v1/chat/completions # 工具不追加任何路径

先阅读协议与 URL 规则,不确定时查看工具日志中的最终请求地址。