SuperAPI AI 工具集

routerbase-model-gateway

智能体与模型

查看项目

更新于 10-15 20:33

技能介绍

用途:该技能用于把现有 OpenAI SDK 或 OpenAI 兼容集成迁移到 RouterBase,作为聊天、图像、视频、音频、语音和嵌入工作负载的模型网关;也用于选择模型 ID、设计回退方案、排查鉴权与端点问题,以及编写集成文档和冒烟测试清单。

主要能力:识别目标技术栈与 AI 客户端应放置的位置;将 base URL 配置为 https://routerbase.com/v1;使用 ROUTERBASE_API_KEY 作为服务端密钥;在所选模型无特殊要求时保持 OpenAI 兼容的请求结构;产出主模型与回退模型方案及验证步骤;区分同步的聊天/图像流程与异步的视频/音频任务。

使用方式:优先复用用户已有的 OpenAI 兼容 SDK,只改 base URL、把密钥放入环境配置并保持标准请求负载。示例:import OpenAI from "openai"; const client = new OpenAI({ apiKey: process.env.ROUTERBASE_API_KEY, baseURL: process.env.ROUTERBASE_BASE_URL || "https://routerbase.com/v1" }); 推荐模型时按“用途、主模型、回退模型、原因、验证”表格输出。模型 ID、价格与可用性应视为实时数据,无法查询实时目录时须标注示例并说明上线前需核实的内容。

排查清单:鉴权(缺少密钥、环境错误、服务端密钥未加载)、端点(缺少 /v1、媒体端点错误、客户端仍指向其他提供商)、模型 ID(不可用、拼写错误、账户未启用、模态不支持)、请求结构(不支持的字段、无效内容部分、工具 schema 错误、模型专属参数不匹配)、流式(未正确消费 SSE 或 SDK 分块)、JSON 模式(缺少 response_format 或下游无 schema 校验)、异步媒体(任务 ID 未持久化、轮询无超时、临时 URL 过期前未存储)。

限制与护栏:不得粘贴、推断、打印或记录真实 API 密钥,不得把密钥放入浏览器代码、移动应用、截图或公开仓库;不要盲目重试鉴权、无效模型、校验或策略错误;不得声称示例模型 ID、价格或可用性为永久事实;需验证模型对流式、工具调用、JSON 模式、视觉、上下文长度、媒体大小和异步行为的支持;医疗、法律、金融、安全、合规等高影响场景须人工复核。输出应包含目标端点、必需环境变量、需改动或新建的文件、最小请求示例、模型路由表、回退与重试行为、验证或冒烟测试步骤,以及需对照 RouterBase 实时文档或账户核实的事项。