快速开始
快速开始
三分钟跑通第一次调用:创建 API Key、用 curl 验证、再把 SDK 的 base_url 指向网关。
接入只有三件事:拿 Key、换 base_url、选模型。没有 TokRouter 专属的 SDK 或配置文件。
1. 创建 API Key
登录控制台后进入「令牌」页,点击「创建令牌」。令牌只在创建时完整显示一次,请当场复制到安全的地方。
- 令牌形如
sk-xxxxxxxx - 令牌可以设额度上限与过期时间;需要按项目隔离时,一个项目建一个令牌
- 丢失后无法找回,只能删除重建
Key 放在哪里
不要写进前端代码或提交到仓库。用环境变量注入,例如 TOKROUTER_API_KEY。
2. 用 curl 验证
export TOKROUTER_API_KEY="sk-你的令牌"
curl https://api.tokrouter.dev/v1/chat/completions \
-H "Authorization: Bearer $TOKROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4-mini",
"messages": [{"role": "user", "content": "只回复两个字:成功"}]
}'返回体是标准的 OpenAI Chat Completions 结构(choices[0].message.content)。
401 先看这三处
Authorization头是不是Bearer sk-…,缺少Bearer前缀会 401;- 令牌是否已过期或被禁用(控制台「令牌」页有状态);
- 是否把控制台账号密码当成 Key 用了 —— 两者不是一回事。
3. 换成 SDK 的 base_url
OpenAI Python:
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["TOKROUTER_API_KEY"],
base_url="https://api.tokrouter.dev/v1",
)
resp = client.chat.completions.create(
model="claude-opus-5-5", # 用 OpenAI SDK 调 Claude 也可以
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)OpenAI Node:
import OpenAI from 'openai'
const client = new OpenAI({
apiKey: process.env.TOKROUTER_API_KEY,
baseURL: 'https://api.tokrouter.dev/v1',
})Anthropic SDK、Gemini、DashScope 的接法见协议接入与SDK 列表。
4. 选模型
模型 id 直接用厂商原名,列表与价格见模型。也可以编程拉取当前可用的模型:
curl https://api.tokrouter.dev/v1/models \
-H "Authorization: Bearer $TOKROUTER_API_KEY"