用途:OpenRouter 提供 OpenAI 兼容的 API,地址为 https://openrouter.ai/api/v1,可把提示词路由到数百个 LLM。使用 Bearer token 认证,model 字段接受厂商前缀的模型标识,例如 anthropic/claude-3.5-sonnet、meta-llama/llama-3.1-70b-instruct、google/gemini-1.5-pro。请求与响应结构与 chat/completions 一致,现有 OpenAI 客户端库可直接使用。
主要能力与用法:基本对话把请求体写入 /tmp/openrouter_request.json 后调用 curl -s -X POST "https://openrouter.ai/api/v1/chat/completions" -H "Authorization: Bearer $OPENROUTER_TOKEN" -H "Content-Type: application/json" -d @/tmp/openrouter_request.json。列出模型用 curl -s "https://openrouter.ai/api/v1/models"。流式输出需在请求体加 "stream": true 并用 curl -sN 调用同一端点。查询额度用 curl -s "https://openrouter.ai/api/v1/credits"。可设置 route: "fallback",主提供方不可用时自动重试备用提供方。
可选请求头:HTTP-Referer 与 X-Title 为可选但推荐,OpenRouter 会在排行榜展示它们。
限制与排障:定价按模型计费,大批量调用前应查看 https://openrouter.ai/models 的当前费率。请求失败时可运行 zero doctor check-connector --env-name OPENROUTER_TOKEN 或 zero doctor check-connector --url https://openrouter.ai/api/v1/chat/completions --method POST 排查。资料未提供免费额度、具体价格与速率限制信息。