用途：OpenRouter 提供统一的 LLM 调用接口，位于 300 多个模型之前，接口与 OpenAI 兼容，并带有 OpenRouter 专有扩展（models[]、provider、plugins、reasoning、cache_control、presets、:suffix 快捷后缀）。
鉴权与端点：POST https://openrouter.ai/api/v1/chat/completions，请求头 Authorization: Bearer $OPENROUTER_API_KEY、Content-Type: application/json。可选归属头 HTTP-Referer、X-OpenRouter-Title、X-OpenRouter-Categories 用于榜单排名。API 密钥在 https://openrouter.ai/keys 创建，支持额度上限与 OAuth。
接入路径：原始 HTTP（任意语言）；客户端 SDK（npm 的 @openrouter/sdk、pip 的 openrouter）；Agent SDK（@openrouter/agent，仅 npm/TS，用于多轮循环与工具执行）；也可用 OpenAI SDK 并将 baseURL 设为 https://openrouter.ai/api/v1。资料建议默认使用 OpenRouter SDK。
模型标识：格式为 <provider>/<model>，可用 GET /api/v1/models 列出。后缀快捷方式包括 :nitro（按吞吐排序）、:floor（按价格排序）、:online（启用 web 插件，已弃用）、:free（免费层，有限速与每日上限），可组合。特殊 slug 有 openrouter/auto、openrouter/bodybuilder、@preset/<slug>。
主要能力：流式输出（stream）、工具调用（tools、parallel_tool_calls）、结构化输出（json_object、json_schema）、推理配置（reasoning）、提示缓存、供应商路由与回退（provider、models[]）、多模态（图片、PDF、音频、视频、图像生成、TTS）、插件（web、file-parser、response-healing、context-compression、auto-router）、web 搜索服务工具与用量计费查询。响应包含 usage 与 cost，生成 ID 也在 X-Generation-Id 响应头返回。
限制与注意事项：prompt 与 messages 互斥；工具调用需每轮重复 tools 并追加助手工具调用消息；Anthropic 自动缓存仅路由到 Anthropic；max_tokens 上限为上下文长度减去提示长度；o 系列等模型不返回推理 token；debug.echo_upstream_body 仅限 stream: true 的开发调试；:online 已弃用；流中错误仍为 HTTP 200，需通过分块顶层 error 字段与 finish_reason: "error" 判断；BYOK 密钥始终优先；免费层限速按账号全局计算。错误码包括 400、401、402、403、408、429、502、503。
定价、免费额度具体数值等资料暂未提供。
用法示例（TypeScript SDK）：import OpenRouter from '@openrouter/sdk'; const client = new OpenRouter({ apiKey: process.env.OPENROUTER_API_KEY }); 随后调用 client.chat.send({ model, messages })。Python 使用 from openrouter import OpenRouter，以 OpenRouter(api_key=...) 上下文调用 client.chat.send。
适用场景：需要跨多家模型统一接入、路由回退、工具调用与多模态的开发者与智能体应用。