SuperAPI AI 工具集

omniroute-chat

编程与开发

查看项目

更新于 11-05 16:18

技能介绍

OmniRoute Chat 是 OmniRoute 提供的聊天与代码生成能力,用于向 OmniRoute 网关发起大模型请求。使用前需配置环境变量 OMNIROUTE_URL 和 OMNIROUTE_KEY,具体设置步骤参见入口 SKILL 文档。

主要能力

接口格式:提供三种请求端点。POST $OMNIROUTE_URL/v1/chat/completions 使用 OpenAI 格式;POST $OMNIROUTE_URL/v1/messages 使用 Anthropic Messages 格式;POST $OMNIROUTE_URL/v1/responses 对应 OpenAI Responses API。

流式输出:OpenAI 格式示例中通过 stream 参数开启,资料中描述了 SSE 流式能力,但未给出更多细节。

组合与自动回退:auto、cost-optimized、subscription 等组合可在多个提供商之间自动回退。

模型发现:可通过 curl $OMNIROUTE_URL/v1/models | jq '.data[].id' 查看可用模型列表。

工具调用:支持 OpenAI tools 数组与 Anthropic tools 块。工具结果通过 RTK 自动压缩,资料列出 47 个过滤器,包括 git-diff、grep、test-jest、terraform-plan、docker-logs 等,可节省 20-40% token;单次请求可通过 X-Omniroute-Rtk: off 请求头关闭该压缩。

推理与思考:Anthropic 扩展思考与 OpenAI Responses 的 reasoning 块会原样转发,并通过 reasoning cache 自动缓存。

使用方式

先配置 OMNIROUTE_URL 与 OMNIROUTE_KEY。以 OpenAI 格式为例,向 $OMNIROUTE_URL/v1/chat/completions 发送 POST 请求,携带 Authorization: Bearer $OMNIROUTE_KEY 与 Content-Type: application/json,请求体中指定 model、messages 以及可选的 stream。Anthropic 格式请求需额外携带 anthropic-version: 2023-06-01 请求头,并在请求体中指定 model、max_tokens 与 messages。资料中的示例模型为 claude-opus-4-7。

错误处理

401 表示 API 密钥无效;400 invalid_model 表示模型不在注册表中,可检查 /v1/models;503 circuit_open 表示提供商熔断器被触发,可稍后重试或改用组合;429 rate_limited 需遵循 Retry-After,并考虑使用组合实现自动回退。

限制与未提供信息

资料未说明收费、价格、速率上限、支持的具体模型全集、RTK 压缩的启用条件细节以及部署要求;这些信息暂未提供。