用途:通过 OmniRoute 进行聊天与代码生成,兼容 OpenAI 与 Anthropic 两种请求格式,适合需要多提供商统一入口的对话、代码补全与工具调用场景。
主要能力:提供 POST $OMNIROUTE_URL/v1/chat/completions(OpenAI 格式)、POST $OMNIROUTE_URL/v1/messages(Anthropic Messages 格式)、POST $OMNIROUTE_URL/v1/responses(OpenAI Responses API)三个端点。支持 SSE 流式输出;组合(如 auto、cost-optimized、subscription)可在多个提供商间自动回退。支持 OpenAI tools 数组与 Anthropic tools 块,工具结果经 RTK 自动压缩(47 个过滤器,如 git-diff、grep、test-jest、terraform-plan、docker-logs 等),可节省 20-40% 令牌,可用请求头 X-Omniroute-Rtk: off 关闭。Anthropic 扩展思考与 OpenAI Responses 推理块原样转发,并通过推理缓存自动缓存。
使用方式:需先配置 OMNIROUTE_URL 与 OMNIROUTE_KEY(见入口 SKILL 的安装说明)。可用 curl $OMNIROUTE_URL/v1/models | jq '.data[].id' 发现可用模型。OpenAI 格式示例:curl -X POST $OMNIROUTE_URL/v1/chat/completions -H "Authorization: Bearer $OMNIROUTE_KEY" -H "Content-Type: application/json" -d '{"model":"claude-opus-4-7","messages":[{"role":"user","content":"Refactor this function"}],"stream":true}'。Anthropic 格式需额外加 -H "anthropic-version: 2023-06-01",并传 max_tokens。
错误处理:401 表示 API 密钥无效;400 invalid_model 表示模型不在注册表中,需查 /v1/models;503 circuit_open 表示提供商熔断器触发,可稍后重试或改用组合;429 rate_limited 需遵循 Retry-After,或使用组合自动回退。
限制:具体可用模型、计费与配额资料暂未提供;RTK 压缩效果与推理缓存行为以实际环境为准。