RouterBase API 集成
Overview
使用 routerbase 作为 OpenAI 兼容模型网关接入应用。本技能覆盖 SDK 迁移、base URL 配置、流式输出、tool calling、JSON mode、视觉输入、请求校验、错误处理和凭据安全。
何时使用
当用户提出以下需求时使用本技能:
- 将 OpenAI 兼容 SDK 调用迁移到 RouterBase
- 把
base_url或baseURL设置为https://routerbase.com/v1 - 安全配置 RouterBase API Key,避免泄露密钥
- 实现 chat completions、流式输出、tool calling、JSON mode 或视觉输入
- 为 Python、JavaScript、curl、LangChain、LlamaIndex、Vercel AI SDK、Cursor、Continue 等客户端编写 RouterBase 接入示例
不要使用
以下场景不应使用本技能:
- 发布、记录或保存真实 API Key
- 猜测用户未提供且上游文档没有说明的供应商行为
- 用户只需要模型选择建议时,重写已有可用的供应商集成
使用说明
- 识别用户当前使用的客户端、语言、模型 ID 和部署环境。
- 尽量保留现有 OpenAI 兼容 SDK,只改 base URL、模型和本地密钥配置。
- 示例中使用
<ROUTERBASE_API_KEY>等占位符。 - API Key 必须保留在服务端或本地安全环境中,不写入 git。
- 在建议大范围改动前,优先提供一个小型测试请求。
- 输出校验清单,覆盖预期状态码、响应结构、超时处理和日志脱敏要求。