TokenMix Team · 2026-03-17

5 分钟快速上手 TokenMix API

5 分钟快速上手 TokenMix API

通过 TokenMix，你可以用一个 API Key 调用所有主流 AI 模型 -- GPT-4o、Claude Sonnet 4、Gemini 2.0 Flash、DeepSeek R1、Llama 4 等等。接口完全兼容 OpenAI 格式，如果你用过 OpenAI 的 SDK，上手零学习成本。

第一步：获取 API Key

  1. 在 tokenmix.ai 注册账号
  2. 进入 Dashboard > API Keys
  3. 点击「创建新 Key」
  4. 复制并妥善保存。Key 只显示一次。

第二步：安装 SDK

TokenMix 完全兼容 OpenAI SDK，直接装官方包就行：

Python：

pip install openai

Node.js：

npm install openai

第三步：发起第一次调用

Python

import openai
import sys

client = openai.OpenAI(
    base_url="https://api.tokenmix.ai/v1",
    api_key="your-tokenmix-api-key"  # 换成你的 Key
)

try:
    response = client.chat.completions.create(
        model="gpt-4o",
        messages=[
            {"role": "system", "content": "你是一个有用的助手。"},
            {"role": "user", "content": "用两句话解释什么是 API 网关。"}
        ],
        max_tokens=200,
        temperature=0.7
    )
    print(response.choices[0].message.content)

except openai.AuthenticationError:
    print("API Key 无效，请到 tokenmix.ai/dashboard/keys 检查")
    sys.exit(1)
except openai.RateLimitError:
    print("触发限流，稍等片刻再试")
    sys.exit(1)
except openai.APIError as e:
    print(f"API 错误: {e.message}")
    sys.exit(1)

Node.js

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.tokenmix.ai/v1",
  apiKey: "your-tokenmix-api-key",
});

async function main() {
  try {
    const response = await client.chat.completions.create({
      model: "gpt-4o",
      messages: [
        { role: "system", content: "你是一个有用的助手。" },
        { role: "user", content: "用两句话解释什么是 API 网关。" },
      ],
      max_tokens: 200,
    });
    console.log(response.choices[0].message.content);
  } catch (error) {
    if (error instanceof OpenAI.AuthenticationError) {
      console.error("API Key 无效");
    } else if (error instanceof OpenAI.RateLimitError) {
      console.error("触发限流");
    } else {
      console.error("API 错误:", error.message);
    }
    process.exit(1);
  }
}

main();

cURL

curl https://api.tokenmix.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-tokenmix-api-key" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个有用的助手。"},
      {"role": "user", "content": "用两句话解释什么是 API 网关。"}
    ],
    "max_tokens": 200
  }'

第四步：流式输出

做聊天界面或者需要逐字显示的场景，用流式模式：

Python 流式

try:
    stream = client.chat.completions.create(
        model="claude-sonnet-4",
        messages=[
            {"role": "user", "content": "写一个 Python 类型提示的简短指南。"}
        ],
        stream=True
    )

    for chunk in stream:
        if chunk.choices[0].delta.content is not None:
            print(chunk.choices[0].delta.content, end="", flush=True)
    print()

except openai.APIError as e:
    print(f"\n流式错误: {e.message}")

Node.js 流式

const stream = await client.chat.completions.create({
  model: "claude-sonnet-4",
  messages: [{ role: "user", content: "写一个 Python 类型提示的简短指南。" }],
  stream: true,
});

for await (const chunk of stream) {
  const content = chunk.choices[0]?.delta?.content;
  if (content) process.stdout.write(content);
}
console.log();

第五步：切换模型

TokenMix 最大的优势：切换模型只需要改一行代码。所有模型共用同一个 endpoint、同一个 SDK、同一个 Key：

# 改 model 参数就行
response = client.chat.completions.create(
    model="claude-sonnet-4",  # 或：gpt-4o, gemini-2.0-flash, deepseek-r1, llama-4
    messages=[{"role": "user", "content": "你好！"}]
)

不需要装新 SDK，不需要申请新 Key，不需要新的计费账号。想对比两个模型的效果？跑两遍就行。

实用技巧

设置超时

client = openai.OpenAI(
    base_url="https://api.tokenmix.ai/v1",
    api_key="your-tokenmix-api-key",
    timeout=30.0  # 30 秒超时
)

指数退避重试

import time

def call_with_retry(client, max_retries=3, **kwargs):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(**kwargs)
        except openai.RateLimitError:
            if attempt == max_retries - 1:
                raise
            time.sleep(2 ** attempt)
        except openai.APIError:
            if attempt == max_retries - 1:
                raise
            time.sleep(1)

用环境变量管理 Key（推荐）

export TOKENMIX_API_KEY=sk-your-key-here

import os
client = openai.OpenAI(
    base_url="https://api.tokenmix.ai/v1",
    api_key=os.environ["TOKENMIX_API_KEY"]
)

下一步

从注册到跑通第一个调用，5 分钟足够。开始构建吧。