OpenRouter：轻松集成多家AI大模型的统一接口平台指南

想象一下，你已经在系统中集成了 OpenAI API，但现在你希望通过 Google Gemini 和 Anthropic API 扩展能力。你会为每个服务商单独创建和管理账户，使用不同的 SDK，让代码变得更加复杂吗？还是更倾向于只用一行代码就能访问任意厂商的大语言模型（LLM）的统一解决方案？

本教程将带你了解 OpenRouter——一个旨在简化开发者工作流程的平台，它为多家 AI 模型提供统一接口。你将学会如何设置 OpenRouter，如何通过 Python 的 requests 库及 OpenAI 客户端访问模型，并发现 OpenRouter 如何提升你的开发效率。

OpenRouter: A Unified Interface for LLMs

OpenRouter 简介

OpenRouter 是一个统一的 API 平台，开发者可以通过它访问 OpenAI、Anthropic、Google、Meta、Mistral 等领先 AI 提供商的多款大语言模型（LLM）。它为这些模型提供了标准化的接口，极大简化了多服务商集成的流程。OpenRouter 会自动管理容错，确保高可用性，并选择最具性价比的方案，节省时间和资源。只需几行代码，开发者即可通过自己喜欢的 SDK 或框架快速接入，操作简便、易于实现。

OpenRouter：LLM 的统一接口

OpenRouter 的设置

访问 OpenRouter 官网并注册账户。
注册完成后，进入 API 区域生成你的 API Key。
出于安全与便捷考虑，建议将 API Key 保存为系统环境变量，这样便可在脚本中安全调用，无需将敏感信息硬编码进代码。

OpenRouter：LLM 的统一接口

OpenRouter 像一个 AI 模型的集市，你可以在这里浏览、选择各类模型，查找需要的模型，复制 API 调用代码，并直接在终端或应用中测试。

OpenRouter：LLM 的统一接口

使用 OpenRouter

你可以通过 Python、OpenAI 客户端、TypeScript，甚至 cURL 命令与 OpenRouter 交互。本节将重点介绍如何使用 Python requests 库与 OpenAI 客户端接入 OpenRouter API，并演示其如何简化集成流程。

使用 requests 库访问 OpenRouter

Python requests 库是与 OpenRouter API 交互的简单有效方式。以下示例展示了如何向 OpenRouter 服务器发送请求，为 qwen2.5-vl-72b-instruct 模型同时提供文本和图片输入：

from IPython.display import display, Markdown
import requests
import json
import osAPI_KEY = os.environ["OPENROUTER"]
response = requests.post(url="https://openrouter.ai/api/v1/chat/completions",headers={"Authorization": f"Bearer {API_KEY}","Content-Type": "application/json",},data=json.dumps({"model": "qwen/qwen2.5-vl-72b-instruct:free","messages": [{"role": "user","content": [{"type": "text","text": "Explain the image."},{"type": "image_url","image_url": {"url": "https://www.familyhandyman.com/wp-content/uploads/2018/02/handcrafted-log-home.jpg"}}]}],})
)# 解析 JSON 响应
result = response.json()# 提取并展示模型回复内容
output = result["choices"][0]["message"]["content"]
display(Markdown(output))

你会得到快速且准确的响应。

OpenRouter：LLM 的统一接口

使用 OpenAI 客户端访问 OpenRouter

如果你已经熟悉 OpenAI 客户端，也可以用它访问 OpenRouter API。首先，确保已安装 openai 客户端：

pip install openai

然后，使用以下代码向 OpenRouter 服务器发送请求——此处我们调用的是 deepseek-chat-v3-0324 模型：

from openai import OpenAIclient = OpenAI(base_url="https://openrouter.ai/api/v1",api_key=os.environ["OPENROUTER"],
)completion = client.chat.completions.create(model="deepseek/deepseek-chat-v3-0324:free",messages=[{"role": "user","content": "Create beautiful ASCII art."}]
)output = completion.choices[0].message.content
display(Markdown(output))

通过相同的 URL 和 API Key 成功访问了模型——只需更改模型名即可切换任意模型。