平台指南

快速入门

从零到一个可用的 API 调用，大约五分钟。

UnoRouter 的工作方式

UnoRouter 将来自 OpenAI、Anthropic、Google、DeepSeek、Qwen 以及 50 多家其他提供商的 200 多个模型置于一个兼容 OpenAI 的端点之后。只需集成一次，之后更换模型只要改一个字符串即可。许多模型完全免费，无需信用卡。

你也可以完全跳过 API：内置聊天无需注册即可运行免费模型，而你的对话会留在你的浏览器中。

Base URL

将任何兼容 OpenAI 的客户端指向这两个值：

变量	值
`BASE_URL`	`https://api.unorouter.com/v1`
`API_KEY`	你在令牌页面创建的密钥

使用原生线路协议的工具改用裸域名：Claude Code 设置 ANTHROPIC_BASE_URL，Gemini CLI 设置 GOOGLE_GEMINI_BASE_URL，均不带 /v1 后缀。每份集成指南都会给出确切的值。

创建 API 密钥

注册后打开令牌页面并创建一个密钥。给它取个名字；你还可以设置到期日期、支出上限、允许的模型以及 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!" }]
  }'

登录以自动填入您的 API 密钥

带 :free 后缀的模型不收费。选择目录中的任何其他模型即可动用你的余额。

使用官方 SDK

任何 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)

登录以自动填入您的 API 密钥

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);

登录以自动填入您的 API 密钥

后续步骤

集成标签页提供 30 多款应用的即复制即用配置：SillyTavern、JanitorAI、Claude Code、Cline 等。聊天标签页记录了内置的角色扮演聊天。

在模型页面浏览所有模型和实时价格，在排行榜查看社区实测的免费模型可靠性，在状态页面查看提供商的运行状况。