快速接入
5 分钟跑通 TokOne 的第一次 API 调用。TokOne 是一个 AI API 网关，提供 OpenAI、Anthropic、Gemini 兼容接口，无需分别申请各家账号。
关于 API Key 与分组
不同模型属于不同的分组（OpenAI / Anthropic / Gemini 等），你需要在控制台【API 密钥】页面中为对应分组分别创建 API Key。换句话说，访问不同协议的模型时请使用该分组对应的 Key，而不是用同一个 Key 打通所有协议。
1. 准备工作
开始前你需要：
- 一个 TokOne 账号，并在控制台为你要使用的分组创建对应的 API Key（形如
sk-xxxxxxxx）。 - 账户中有可用余额。
- 你的 API Base URL。本文示例统一使用
https://api.tokone.ai，请替换为你实际部署或被分配的域名。
关于 Base URL
TokOne 的公开域名由部署方决定。如果你不确定，请在控制台或向客服确认你的 Base URL。下文所有示例把它写作 https://api.tokone.ai。
2. 第一次调用
TokOne 同时提供 OpenAI、Anthropic 与 Gemini 兼容端点。任选其一即可。
OpenAI 兼容（Chat Completions）
bash
curl https://api.tokone.ai/v1/chat/completions \
-H "Authorization: Bearer $TOKONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"messages": [
{ "role": "user", "content": "回复 OK" }
]
}'Python（官方 openai SDK，只改 base_url）：
python
from openai import OpenAI
client = OpenAI(
api_key="sk-...", # 你的 TokOne API Key
base_url="https://api.tokone.ai/v1", # 指向 TokOne
)
resp = client.chat.completions.create(
model="gpt-5.5",
messages=[{"role": "user", "content": "回复 OK"}],
)
print(resp.choices[0].message.content)Node.js:
js
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.TOKONE_API_KEY,
baseURL: "https://api.tokone.ai/v1",
});
const resp = await client.chat.completions.create({
model: "gpt-5.5",
messages: [{ role: "user", content: "回复 OK" }],
});
console.log(resp.choices[0].message.content);Anthropic 兼容（Messages）
bash
curl https://api.tokone.ai/v1/messages \
-H "x-api-key: $TOKONE_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-opus-4-6",
"max_tokens": 256,
"messages": [
{ "role": "user", "content": "回复 OK" }
]
}'Gemini 兼容（generateContent）
bash
curl https://api.tokone.ai/v1beta/models/gemini-3.5-flash:generateContent \
-H "x-goog-api-key: $TOKONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"contents": [
{ "role": "user", "parts": [{ "text": "回复 OK" }] }
]
}'3. 流式输出
所有推理端点都支持 SSE 流式，加上 "stream": true 即可：
bash
curl https://api.tokone.ai/v1/chat/completions \
-H "Authorization: Bearer $TOKONE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.5",
"stream": true,
"messages": [{ "role": "user", "content": "写一首关于路由的短诗" }]
}'响应以 text/event-stream 形式逐块返回，以 data: [DONE] 结束。
4. 鉴权方式
TokOne 接受以下三种请求头（按优先级），任选其一：
| 请求头 | 适用场景 |
|---|---|
Authorization: Bearer <key> | 推荐，OpenAI 风格 |
x-api-key: <key> | Anthropic 风格客户端 |
x-goog-api-key: <key> | Gemini CLI 兼容 |
WARNING
出于安全考虑，不支持通过 URL 查询参数（如 ?key= / ?api_key=）传递密钥，这类请求会被拒绝。请始终用请求头传递 API Key。