OpenRouter API 指南：一个 API 调用主流 AI 模型

一个 API 密钥、一个端点，背后是数百个语言模型。 这就是 OpenRouter API 的卖点——而且它直接兼容 OpenAI 的接口规范，大多数应用只需改一个 base URL 就能接入。本指南带你从零起步，一直到可上生产环境的调用。

你将学到：

• 创建密钥，并用 curl、Python 和 TypeScript 发出第一个请求

• 读懂模型 slug（vendor/model），使用 :free、:nitro、:floor 等变体

• 处理流式输出、速率限制和多模型回退

• 了解平台的成本结构，以及什么时候多模态网关更合适

OpenRouter 的工作原理

模型目录

OpenRouter 收录了来自 OpenAI、Anthropic、Google、Meta、Mistral、DeepSeek、Qwen 等厂商的数百个模型，每个模型页面都标注了按 token 计费的价格和上下文规格 ^[1]。

请求的流转过程

你的请求先到达统一端点，路由器为该模型选择一个上游供应商（很多模型有多个供应商），执行后再把响应规范化为 OpenAI 格式。默认情况下，供应商选择会在价格和可用性之间做平衡 ^[2]。

费用几何

推理按供应商官方定价计费，不加价；平台在你购买额度时收取 5.5%（最低 $0.80） 的手续费，免费模型限制为每天 50 次请求（购买过 $10+ 额度后为每天 1,000 次）^[3]。

快速上手

1. 创建账号和密钥

注册账号，买一小包额度（同时也会解锁更高的免费额度上限），然后在控制台生成密钥。密钥是 bearer token——务必只放在服务端。

2. 用 curl 发第一个请求

curl https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5.2",
    "messages": [{"role": "user", "content": "Hello from the unified API"}]
  }'

3. Python 和 TypeScript

官方的 OpenAI SDK 可以直接使用：

from openai import OpenAI

client = OpenAI(
    base_url="https://openrouter.ai/api/v1",
    api_key="sk-or-...",
)

resp = client.chat.completions.create(
    model="google/gemini-2.5-pro",
    messages=[{"role": "user", "content": "Three taglines for a coffee app"}],
)

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://openrouter.ai/api/v1",
  apiKey: process.env.OPENROUTER_API_KEY,
});

模型 slug 与变体

读懂 slug

模型 ID 遵循 vendor/model-name 格式，例如 anthropic/claude-sonnet-4.5 或 deepseek/deepseek-chat。模型页面上显示的字符串，就是 API 期望的字符串，一字不差。

后缀变体

变体只是路由提示，不是不同的权重——同一个模型，不同的供应商选择 ^[2]。

挑选模型

按价格、上下文窗口和模态筛选目录，然后用你自己的任务做基准测试。务实的阶梯是：用 :free 变体做原型，用中端模型上线，把前沿模型留给最难的 10% 请求。

生产环境注意事项

流式输出

设置 "stream": true 并消费 server-sent events——与 OpenAI 的流式规范完全一致，现有的流式 UI 代码无需改动。

速率限制与重试

限额随你的额度余额扩展，而非固定档位；遇到 429 应触发指数退避。对于免费模型，请按每天 50/1,000 的上限做预算 ^[3]。

回退

传入一个按优先级排列的 models 数组，遇到错误或速率限制时，路由器会在服务端自动重试下一个模型 ^[4]：

{
  "model": "openai/gpt-5.2",
  "models": ["anthropic/claude-sonnet-4.5", "deepseek/deepseek-chat"],
  "messages": [{ "role": "user", "content": "..." }]
}

当你需要的不止是语言模型

OpenRouter 统一的是文本。一旦路线图上出现"生成一张商品图"或"加一段视频"，你就又回到了逐个厂商对接的老路——除非你的网关原生覆盖这些模态。

一个覆盖媒体模型的统一 API

APIMart 把同样的"一把钥匙"模式应用到 500+ 模型上，涵盖聊天、图像（GPT-Image-2）、视频（Sora 2、Kling、Veo）和音频（Suno）。

低于官方定价，而非照价转售

模型定价约比官方价格低 20%，每个模型的原价与折扣价都公示在价格页面上——无需再单独计算手续费。

同一份代码即插即用

端点兼容 OpenAI，所以上面的快速上手代码只需换 base URL 和密钥即可运行。你的模型注册表和回退逻辑可以原封不动地迁移过来。

小结

把 OpenAI SDK 指向统一端点，用 vendor/model slug 引用模型，在乎成本或速度时使用 :floor 或 :nitro，上生产前加上 models 回退数组，并记住真实成本是官方定价加上 5.5% 的充值手续费 ^[3]。如果你的应用还需要图像、视频或音频，那就直接从一个已经覆盖这些能力的网关开始。