OpenRouter

一套统一 API 聚合上百家模型：自动处理回退，并可用 OpenAI SDK 作为 drop-in。

它是做什么的

OpenRouter 提供单一入口访问大量第三方模型。官方 Quickstart 强调：统一 API、自动 fallback，并可选更优成本路由。集成方式包括直接 HTTP、官方 Client SDK、Agent SDK；也可用 OpenAI SDK，把 baseURL / base_url 指到 https://openrouter.ai/api/v1。请求与响应 schema 接近 OpenAI Chat API，并在跨厂商间做归一化，适合「少改业务代码换模型」。

它解决的是「模型太多、协议太散」：账号与账单在一处，业务侧主要换 model slug；具体能力（工具调用、结构化输出等）仍取决于上游模型是否支持。上线前用 Models API 或官网过滤一遍所需参数能力。

要点

• OpenAI 兼容：核心路径 POST /api/v1/chat/completions；支持流式；OpenAI SDK 改 base URL + Key 即可。
• 模型目录：在 models 浏览，或 GET /api/v1/models 拉取 slug；可用文档中的 latest 类别名跟随旗舰版本。
• 路由能力：支持模型列表回退、provider 路由等（见官方 Model Routing / Provider Routing）。
• 可选头：HTTP-Referer、X-OpenRouter-Title 用于应用归属 / 排行榜展示（可选）。
• 价格：以官网模型页实时展示为准，本页不抄价目；同一能力常有多家上游，可用路由策略做成本与可用性权衡。

适合谁

• 经常换模型，不想为每家单独适配协议
• 需要统一入口做原型、对比或多供应商兜底
• 已有 OpenAI 客户端生态，希望 drop-in 切换
• 希望由托管方处理多供应商路由与账单汇总，而不是自己运维网关

官方入口

• 官网
• 文档 Quickstart
• API 概览
• 模型列表

建议怎么用

注册拿 Key → 用 curl 或 OpenAI SDK 打通 /chat/completions → 在 models 页选定 slug 并做 A/B。可选填应用归属头，便于在官网排行看到自己的应用。生产再配置 fallback / provider 偏好，并关注各模型速率限制与数据策略差异。若要自建网关、虚拟 Key、团队预算与日志，改用或叠加 LiteLLM。