快速开始

TokenHub API 兼容 OpenAI 接口格式,只需三步即可开始调用:

  • 1. 注册账户并获取 API Key
  • 2. 安装 SDK 或直接使用 HTTP 请求
  • 3. 发送你的第一次请求

获取 API Key

登录控制台,进入「API密钥」页面,点击「创建密钥」即可生成。密钥格式为 sk-th-xxxxxxxx

首次调用

📋 复制
# 使用 curl 调用 GPT-4o
curl https://api.tokenhub.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-th-xxxx" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好,介绍一下你自己"}
    ]
  }'
# 使用 Python SDK
from tokenhub import TokenHub

client = TokenHub(api_key="sk-th-xxxx")

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[
        {"role": "user", "content": "你好,介绍一下你自己"}
    ]
)

print(response.choices[0].message.content)
// 使用 Node.js SDK
import TokenHub from 'tokenhub';

const client = new TokenHub({ apiKey: 'sk-th-xxxx' });

const response = await client.chat.completions.create({
  model: 'gpt-4o',
  messages: [
    { role: 'user', content: '你好,介绍一下你自己' }
  ]
});

console.log(response.choices[0].message.content);

鉴权方式

TokenHub API 使用 Bearer Token 进行鉴权。在每次请求的 Header 中添加 Authorization 字段即可。

HTTP Header
Authorization: Bearer sk-th-xxxxxxxxxxxxxxxx

聊天补全

创建一个聊天补全请求,模型将根据对话上下文生成回复。

请求地址: POST https://api.tokenhub.com/v1/chat/completions

请求参数

参数类型必填说明
modelstring模型ID,如 gpt-4o、claude-3.5-sonnet
messagesarray对话消息数组
temperaturefloat温度参数,0-2,默认0.7
max_tokensint最大生成Token数,默认1024
streambool是否流式输出,默认false

响应示例

JSON Response
{
  "id": "chatcmpl-abc123",
  "object": "chat.completion",
  "model": "gpt-4o",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "你好!我是AI助手..."
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 45,
    "total_tokens": 57
  }
}

模型列表

获取平台支持的所有模型列表。

请求地址: GET https://api.tokenhub.com/v1/models

参数说明

不同模型支持的参数可能有所不同,以下是通用参数说明:

参数范围说明
temperature0 - 2值越高输出越随机,值越低越确定
top_p0 - 1核采样,与temperature二选一
max_tokens1 - 128000限制生成Token数量
streamtrue/false流式输出,适合实时场景
stopstring/array停止词,遇到则停止生成

错误码

状态码说明处理方式
200成功
400请求参数错误检查请求体格式
401鉴权失败检查API Key是否正确
402余额不足请充值后重试
429请求频率超限降低调用频率或升级套餐
500服务器错误稍后重试或联系客服

SDK

TokenHub 提供多语言 SDK,安装后即可使用:

📋 复制
pip install tokenhub
npm install tokenhub

最佳实践

  • 使用流式输出(stream=true)提升用户体验
  • 合理设置 max_tokens 避免浪费
  • 对长对话使用支持超长上下文的模型(如 Gemini 1.5 Pro)
  • 代码任务使用 DeepSeek Coder 等专用模型,性价比更高
  • 实现重试机制处理 429 和 500 错误
  • 监控 Token 用量,及时充值避免中断