TokenRa
English登录注册

快速开始

快速开始

从注册到跑通第一个 API 请求,只需三步。

创建 API Key

注册账号后进入控制台,在左侧菜单「API 密钥」中新建 Key。Key 以 sk- 开头,只能放在服务端,不要写进前端代码。

把 Key 设为环境变量

文档中的所有示例都从 TOKENRA_API_KEY 读取 Key。

SHELL
# 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 即可使用。

POST /v1/chat/completions
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 网关的作用。"}
    ]
  }'

先设置环境变量 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。