OpenRouter：统一调用多家 AI 模型的 API 平台

OpenRouter 为开发者提供统一的模型目录与 API 接入层，可从同一接口选择不同 AI 模型和服务提供方。官网当前列出多种文本、图像、视频与音频模型，并提供 API、客户端 SDK 和 Agent SDK 等集成方式。各模型的能力、价格、上下文限制、可用地区与提供方政策并不相同，使用前请查看模型目录、官方文档与价格页面。

主要能力

• **统一 API 与模型目录：**通过 OpenRouter API 查询和调用目录中可用的模型。可在网页目录比较模型说明、价格及上下文信息，也可使用 API 获取模型列表。
• **OpenAI SDK 兼容：**官方文档提供兼容 OpenAI SDK 的接入示例。迁移时仍需配置 OpenRouter 的 API 地址、密钥和模型标识，并确认目标模型支持所需参数；不能假设完全无需改代码。
• **客户端与 Agent SDK：**官方提供 JavaScript/TypeScript 与 Python 客户端 SDK，并提供用于构建带工具调用、对话循环和状态管理智能体的 Agent SDK。具体接口以版本文档为准。
• **模型与提供方路由：**可使用模型或提供方选择及回退选项处理可用性问题。路由行为取决于请求配置、模型端点和账户计划；它不等于每个请求都会自动选择最低价格或保证不中断。
• **按模型计费与计划：**费用按所用模型的公开推理价格计算；标准及团队等计划的服务费、访问模型、预算工具与其他权益可能不同。价格和计划会调整，发起请求前应核对当前页面。
• **数据策略设置：**平台文档说明不同模型提供方有各自的数据保留和训练政策，并提供账户或单次请求层面的筛选设置。敏感内容应先核对所选提供方规则和账户隐私选项。

开始使用

1. 创建账户并查看当前计划、模型目录、计费说明和数据政策。
2. 在控制台创建 API Key，将其存放在环境变量或密钥管理器中；不要提交到代码仓库、客户端应用或日志。
3. 选择模型并阅读其输入、输出、工具调用和多模态要求。使用 OpenAI SDK 时按官方说明设置 baseURL、API Key 和模型名。
4. 先用非敏感样例验证请求结构、费用记录、错误处理和可选回退，再接入真实业务数据。
5. 设置预算或密钥限额，并定期检查用量、计费和提供方策略。

适用场景与边界

OpenRouter 适合希望从一个 API 管理多个模型选项的应用开发者，也可用于比较模型、构建聊天或智能体工作流，以及调用支持的图像、音频等模型。工具调用、结构化输出和多模态能力取决于具体模型与端点。统一接口可以减少部分接入差异，但不能消除各模型的参数、价格、限额和行为差异，也不保证固定延迟、准确率或可用性。

请求内容会根据所选模型和路由发送给相应提供方。OpenRouter 的数据处理设置与模型提供方自身的数据政策是不同环节；上传代码、客户资料或个人信息前，请检查数据保留、训练使用、区域处理和日志选项。AI 输出应经过应用侧的安全检查和事实核对。计费按实际模型及服务条件变化，错误处理和回退也应纳入成本与测试设计。

常见问题

OpenRouter 是什么？

它是一个多模型 API 平台，提供模型目录、统一 API 以及 SDK 等开发工具。具体模型和端点以当前目录为准。

可以直接使用 OpenAI SDK 吗？

官方文档提供兼容接入方式，通常需配置 OpenRouter 的 baseURL、API Key 和模型名。仍应检查模型能力与请求参数是否兼容。

使用费用如何计算？

模型推理费用按目录所示的模型价格计费，平台计划可能另有服务费或权益。价格和规则会变化，请以实时价格页面及账户记录为准。

OpenRouter 会怎样处理请求数据？

平台与各模型提供方分别有数据处理政策。请在账户设置中查看日志、数据使用和提供方筛选选项，并阅读所选模型提供方的保留政策。