快速开始
快速开始
从注册到跑通第一个 API 请求,只需三步。
创建 API Key
注册账号后进入控制台,在左侧菜单「API 密钥」中新建 Key。Key 以 sk- 开头,只能放在服务端,不要写进前端代码。
把 Key 设为环境变量
文档中的所有示例都从 TOKENRA_API_KEY 读取 Key。
# macOS / Linux
export TOKENRA_API_KEY="sk-..."
# Windows PowerShell
$env:TOKENRA_API_KEY = "sk-..."发出第一个请求
下面通过 POST /v1/chat/completions 调用 deepseek-v4.1-flash。任何 OpenAI SDK 只要把 base_url 设为 https://tokenra.io/v1 即可使用。
curl https://tokenra.io/v1/chat/completions \
-H "Authorization: Bearer $TOKENRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-v4.1-flash",
"messages": [
{"role": "system", "content": "你是一名简洁的技术助手。"},
{"role": "user", "content": "用两句话解释 API 网关的作用。"}
]
}'import os
from openai import OpenAI
client = OpenAI(api_key=os.environ["TOKENRA_API_KEY"], base_url="https://tokenra.io/v1")
resp = client.chat.completions.create(
model="deepseek-v4.1-flash",
messages=[
{"role": "system", "content": "你是一名简洁的技术助手。"},
{"role": "user", "content": "用两句话解释 API 网关的作用。"},
],
)
print(resp.choices[0].message.content)const resp = await fetch("https://tokenra.io/v1/chat/completions", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.TOKENRA_API_KEY}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
model: "deepseek-v4.1-flash",
messages: [
{ role: "system", content: "你是一名简洁的技术助手。" },
{ role: "user", content: "用两句话解释 API 网关的作用。" },
],
}),
});
const data = await resp.json();
console.log(data.choices[0].message.content);import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Chat {
public static void main(String[] args) throws Exception {
String body = """
{
"model": "deepseek-v4.1-flash",
"messages": [
{"role": "user", "content": "Explain in two sentences what an API gateway does."}
]
}
""";
HttpRequest request = HttpRequest.newBuilder(URI.create("https://tokenra.io/v1/chat/completions"))
.header("Authorization", "Bearer " + System.getenv("TOKENRA_API_KEY"))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> response = HttpClient.newHttpClient()
.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());
}
}先设置环境变量 TOKENRA_API_KEY。Python 需 pip install openai。JavaScript 保存为 .mjs,用 Node.js 18+ 运行。Java 需 JDK 17+,用 java 类名.java 直接运行。Windows 命令行用 cURL 发送中文可能出现乱码,可把请求体保存为 UTF-8 的 body.json,再用 -d @body.json 发送。
下一步
- 长回答用
"stream": true流式返回。 - 改
model字段即可切换模型,模型 ID 见模型列表。 - 视频和图片模型有各自的接口,参见 Seedance 2.0 Pro 和 GPT Image 2.5 Flare。
- Claude Code 等 Anthropic 客户端:设置
ANTHROPIC_BASE_URL=https://tokenra.io,ANTHROPIC_AUTH_TOKEN设为你的 Key。