指南

迁移指南

只需极少量代码改动,即可从 OpenAI 或 Anthropic 官方 API 迁移至 TokenFast。由于 TokenFast 与 OpenAI 完全兼容,迁移通常只是一行代码的事。

为何迁移到 TokenFast?

多 Provider 接入

通过同一个 API Key 即可调用 OpenAI、Anthropic、Google、Mistral 等多家 Provider 的模型。

成本优势

定价具备竞争力,无月度最低消费要求。按实际用量付费。

无供应商锁定

在不同 Provider 的模型之间切换时,无需改动任何代码。

内置监控

开箱即用的用量追踪、预算控制与 Rate Limit 能力。

从 OpenAI 官方 API 迁移

由于 TokenFast 与 OpenAI 完全兼容,从 OpenAI 迁移是最简单的方式:只需修改 Base URL 与 API Key,其余代码保持不变。

步骤一:更新客户端配置

Python

迁移前Python
from openai import OpenAI

client = OpenAI(
    api_key="sk-openai-key"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)
迁移后Python
from openai import OpenAI

client = OpenAI(
    base_url="https://api.tokenfast.ai/v1",
    api_key="sk-your-tokenfast-key"
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}]
)

Node.js

迁移前Node.js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-openai-key",
});

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Hello!" }],
});
迁移后Node.js
import OpenAI from "openai";

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

const response = await client.chat.completions.create({
  model: "gpt-4o",
  messages: [{ role: "user", content: "Hello!" }],
});

cURL

迁移前cURL
curl https://api.openai.com/v1/chat/completions \
  -H "Authorization: Bearer sk-openai-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"Hello!"}]}'
迁移后cURL
curl https://api.tokenfast.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-your-tokenfast-key" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-4o","messages":[{"role":"user","content":"Hello!"}]}'

步骤二:更新环境变量

若您通过环境变量管理配置(推荐做法),请同步更新:

迁移前Shell (.env)
OPENAI_API_KEY=sk-openai-key
OPENAI_BASE_URL=https://api.openai.com/v1
迁移后Shell (.env)
OPENAI_API_KEY=sk-your-tokenfast-key
OPENAI_BASE_URL=https://api.tokenfast.ai/v1

步骤三:尝试其他模型(可选)

迁移至 TokenFast 后,您无需修改任何代码即可调用其他 Provider 的模型——只需修改模型名称:

Python
# 调用 Anthropic Claude
response = client.chat.completions.create(
    model="claude-sonnet-4-6",
    messages=[{"role": "user", "content": "Hello!"}]
)

# 调用 Google Gemini
response = client.chat.completions.create(
    model="gemini-2.5-pro",
    messages=[{"role": "user", "content": "Hello!"}]
)

# 调用 DeepSeek
response = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "Hello!"}]
)

保持不变的部分

  • 请求与响应格式(100% 与 OpenAI 兼容)
  • 流式输出支持(SSE 格式)
  • Function calling / 工具调用
  • JSON 模式
  • 所有 SDK 功能(重试、超时等)

迁移清单

  • 创建 TokenFast 账户 并获取您的 API Key
  • 将 Base URL 更新为 https://api.tokenfast.ai/v1
  • 将原 Provider 的 API Key 替换为您的 TokenFast Key
  • 若从 Anthropic 迁移,请切换至 OpenAI SDK 格式
  • 更新所有环境(开发、预发布、生产)中的环境变量
  • 使用 API Playground 进行测试,验证一切正常
  • 在控制台中设置预算提醒与 Rate Limit

需要帮助?

若您在迁移过程中遇到问题,可查阅 错误码 页面进行排查,或参考 API 参考 获取详细的 Endpoint 文档。