平台指南
快速入门
从零到一个可用的 API 调用，大约五分钟。
UnoRouter 将来自 OpenAI、Anthropic、Google、DeepSeek、Qwen 以及 50 多家其他提供商的 200 多个模型置于一个兼容 OpenAI 的端点之后。只需集成一次，之后更换模型只要改一个字符串即可。许多模型完全免费，无需信用卡。
你也可以完全跳过 API：内置聊天无需注册即可运行免费模型，而你的对话会留在你的浏览器中。
将任何兼容 OpenAI 的客户端指向这两个值：
| 变量 | 值 |
|---|---|
BASE_URL | https://api.unorouter.com/v1 |
API_KEY | 你在令牌页面创建的密钥 |
使用原生线路协议的工具改用裸域名：Claude Code 设置 ANTHROPIC_BASE_URL，Gemini CLI 设置 GOOGLE_GEMINI_BASE_URL，均不带 /v1 后缀。每份集成指南都会给出确切的值。
注册后打开 Tokens 页面创建密钥。密钥只显示一次，请妥善保存。
过期时间、消费上限、模型白名单、IP 限制和提供方分组固定见： 账户与计费
没有密钥时，你仍可以作为访客在免费模型上使用内置聊天。API 请求始终需要密钥。
将 YOUR_API_KEY 替换为你刚创建的密钥（如果你已登录，下方已自动填好）：
bash
curl https://api.unorouter.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gpt-oss-120b:free",
"messages": [{ "role": "user", "content": "Hello!" }]
}'带 :free 后缀的模型不收费。选择目录中的任何其他模型即可动用你的余额。
任何 OpenAI SDK 都可无需改动直接使用，只需设置 base URL 和你的密钥：
Python
python
from openai import OpenAI
client = OpenAI(
base_url="https://api.unorouter.com/v1",
api_key="YOUR_API_KEY",
)
completion = client.chat.completions.create(
model="gpt-oss-120b:free",
messages=[{"role": "user", "content": "Hello!"}],
)
print(completion.choices[0].message.content)Node.js
typescript
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.unorouter.com/v1",
apiKey: "YOUR_API_KEY",
});
const completion = await client.chat.completions.create({
model: "gpt-oss-120b:free",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(completion.choices[0].message.content);