EN

快速接入

TokenHub 兼容 OpenAI 接口，只需替换 BaseURL 即可调用全部模型；同样支持 Anthropic / Claude Code 原生协议、Gemini 协议与 OpenAI Responses 协议。

快速开始

  1. 获取密钥

    注册并登录后，在控制台「API 密钥」页创建密钥（sk- 开头）。密钥仅在创建时完整展示一次，请妥善保存。

    前往控制台

  2. 替换 BaseURL

    将请求基址替换为本站网关地址，其余请求格式与 OpenAI 接口完全一致：

    https://api.tokenhub.example/v1

  3. 发起调用

    把下方示例中的 sk-... 换成你的密钥，即可发起第一次调用。

调用示例

三种常用端点：OpenAI Chat Completions、OpenAI Responses 与 Anthropic Messages。

cURL · Chat Completions
curl https://api.tokenhub.example/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -d '{
    "model": "openai/gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
cURL · Responses
curl https://api.tokenhub.example/v1/responses \
  -H "Authorization: Bearer sk-..." \
  -d '{
    "model": "openai/gpt-4o",
    "input": "Write a haiku about APIs."
  }'
cURL · Messages（Anthropic）
curl https://api.tokenhub.example/v1/messages \
  -H "x-api-key: sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

OpenAI SDK 接入

官方 SDK 只需改写 base_url，模型名沿用「厂商/模型」格式。

Python
from openai import OpenAI

client = OpenAI(
    api_key="sk-...",
    base_url="https://api.tokenhub.example/v1",
)

resp = client.chat.completions.create(
    model="openai/gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(resp.choices[0].message.content)
Node.js
import OpenAI from "openai";

const client = new OpenAI({
  apiKey: "sk-...",
  baseURL: "https://api.tokenhub.example/v1",
});

const resp = await client.chat.completions.create({
  model: "openai/gpt-4o",
  messages: [{ role: "user", content: "Hello!" }],
});
console.log(resp.choices[0].message.content);

Claude Code / Anthropic 原生协议

本站兼容 Anthropic /v1/messages 协议。Claude Code 只需配置两个环境变量：

环境变量
export ANTHROPIC_BASE_URL="https://api.tokenhub.example"
export ANTHROPIC_AUTH_TOKEN="sk-..."

或直接调用 /messages 接口：

cURL · Messages（Anthropic）
curl https://api.tokenhub.example/v1/messages \
  -H "x-api-key: sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "anthropic/claude-sonnet-4",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

模型名称

模型名使用「厂商/模型」格式，例如 openai/gpt-4o、anthropic/claude-sonnet-4、google/gemini-2.5-pro。完整列表与实时价格见模型广场。

查看模型广场

常见错误

状态码含义处理方式
401密钥无效或已删除检查 Authorization 是否为 Bearer sk-...，或在控制台重新创建密钥
402余额不足前往控制台「钱包」充值，或订阅套餐享折扣价
429触发限流降低并发或稍后重试；套餐用户享有更高限额
免费注册查看模型广场

文档中心

全部接入文档，按主题分组浏览。

5 个分组 · 28 篇文档

开始使用

端点参考

通用

分销与合作

已知问题