API 文档

TokenHub 提供 OpenAI 兼容的 API 接口，最低只需修改 Base URL 即可接入。

Base URL: https://aitok.cc — 将 OpenAI 的 api.openai.com/v1 替换为 aitok.cc 即可

快速开始

curl 
# 发送一个 Chat Completion 请求
curl https://aitok.cc/v1/chat/completions \
  -H "Authorization: Bearer YOUR_TOKENHUB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
Python (OpenAI SDK) 
# pip install openai
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_TOKENHUB_API_KEY",
    base_url="https://aitok.cc"
)

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

认证方式

所有 API 请求需要通过 Bearer Token 认证。在后台创建 API Key 后，在请求 Header 中添加：

Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxx

API Key 以 tk_live_ 为前缀。请勿将您的 API Key 提交到公开的代码仓库。

对话补全

兼容 OpenAI 对话补全 v1 接口。

端点

POST https://aitok.cc/v1/chat/completions

支持的模型

gpt-4o · gpt-4o-mini
gpt-4-turbo · gpt-4
claude-3-5-sonnet
gemini-1.5-pro · gemini-1.5-flash

向量嵌入

兼容 OpenAI 向量嵌入 v1 接口。

POST https://aitok.cc/v1/embeddings

-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"model": "text-embedding-3-small", "input": "Hello world"}'

支持的 Embedding 模型：text-embedding-3-small、text-embedding-3-large、text-embedding-ada-002

模型列表

列出所有可用的模型端点。

GET https://aitok.cc/v1/models

错误码

错误码 说明
401 API Key 无效或已过期
403 无权访问该模型或超出套餐限制
429 请求频率超限（RPM）或月度用量超配额
500 上游 AI 提供商返回错误，尝试自动路由到备用提供商
503 服务临时不可用，请稍后重试

定价说明

计费原理

TokenHub 采用按量计费模式，根据实际使用的 Token 数量和模型倍率计算费用。不同模型的计费倍率不同，输入（Prompt）和输出（Completion）Token 分别计费。

计算公式

输入费用 = Prompt Token 数量 × 模型倍率 × 分组折扣

输出费用 = Completion Token 数量 × 模型倍率 × 输出倍率 × 分组折扣

总费用 = 输入费用 + 输出费用

费用单位：$1 = 500 配额单位，每个配额单位 = $0.002。所有费用以美元（USD）计价。

主流模型倍率速查

模型 基础倍率 输出倍率 缓存折扣 预估费用
GPT-4o 1.25 4x 0.5x 读取 $2.50 / 1M
Claude 3.5 Sonnet 1.5 5x 0.1x 读取 $3.00 / 1M
DeepSeek Chat 0.135 1x 0.25x 读取 $0.27 / 1M
Gemini 2.5 Pro 0.625 8x - $1.25 / 1M
其他模型 0.1 - 2.0 1x - 8x - $0.20 - $4.00 / 1M

* 倍率可能根据上游提供商价格调整而变动，请以实际调用时计算为准。

按次计费模型

模型 费用
DALL-E 3$0.04 / 张
Midjourney$0.10 / 张
Suno Music$0.10 / 首
Sora 2$0.30 / 次

充值说明：平台支持赠送余额、奖励 Token 和充值余额三种资产。赠送余额通过注册、邀请获取，有时效性；奖励 Token 通过每日签到获取；充值余额通过付费充值获取，永久有效。扣费顺序：赠送余额 → 奖励 Token → 充值余额，前一种用尽后自动切换。