OpenAI Compatible

API 文档

TokenHub 提供 OpenAI 兼容的 API 接口，最低只需修改 Base URL 即可接入。支持 GPT-4o、Claude、Gemini 等主流模型。

Base URL HTTPS

https://aitok.cc

将 OpenAI 的 api.openai.com/v1 替换为 aitok.cc 即可使用

快速开始

Terminal — 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 中添加：

Request Header

Authorization: Bearer tk_live_xxxxxxxxxxxxxxxxxxxxxxxx

API Key 以 tk_live_ 为前缀。请勿将您的 API Key 提交到公开代码仓库或暴露在前端代码中。

Chat Completions

兼容 OpenAI Chat Completions v1 接口，支持流式输出（SSE）。

端点

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

支持的模型

gpt-4o

Embeddings

兼容 OpenAI Embeddings v1 接口，用于文本向量化。

POST   https://aitok.cc/v1/embeddings
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{"model":"text-embedding-3-small","input":"Hello world"}'

text-embedding-3-small text-embedding-3-large text-embedding-ada-002

Models

列出所有可用模型及其元信息。

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

错误码

当 API 请求失败时，会返回对应的 HTTP 状态码和错误信息。以下是常见错误码及建议处理方式。

400

Bad Request

请求参数有误或格式不正确

客户端错误

常见原因 & 解决方案

•JSON 格式错误或字段缺失（如缺少 messages 字段）
•模型名称拼写错误（区分大小写）
•请求体超过模型最大 token 限制

401

Unauthorized

API Key 无效或已过期

认证失败

常见原因 & 解决方案

•API Key 输入错误（检查是否包含完整 tk_live_ 前缀）
•API Key 已被删除或禁用 → 请在后台管理确认状态
•Header 中 Authorization 格式应为 Bearer sk-xxx

403

Forbidden

无权访问该模型或超出套餐限制

权限不足

常见原因 & 解决方案

•当前套餐未包含该模型的访问权限
•账户余额不足或已欠费 → 请充值续费
•IP 地址不在白名单内（如果启用了 IP 限制）

429

Too Many Requests

请求频率超限或月度用量超配额

限流

常见原因 & 解决方案

•RPM（每分钟请求数）超限 → 实施指数退避重试：retry-after 秒后重试
•月度 Token 配额已用完 → 升级套餐或等待下月重置
•Tokens Per Minute (TPM) 超限 → 减小单次请求的 max_tokens 值

500

Internal Server Error

上游 AI 提供商返回错误

服务端错误

说明 & 处理方式

•上游 AI 服务商（OpenAI / Anthropic / Google）暂时不可用
•系统会自动尝试路由到备用提供商（如果有配置 fallback）
•建议等待数秒后重试；若持续出现请联系客服

503

Service Unavailable

服务临时不可用

维护中

说明 & 处理方式

•平台正在进行维护升级或容量扩容
•通常持续数分钟到数十分钟不等
•建议使用指数退避策略重试，间隔逐步增大

错误响应格式

// 所有错误均返回统一 JSON 格式:
{
  "error": {
    "message": "Invalid API Key provided",
    "type": "authentication_error",
    "code": "invalid_api_key"
  }
}

定价说明

TokenHub 按套餐月费 + 超额按量计费的方式收费，灵活满足不同规模需求。

免费套餐

100K tokens/月

适合个人试用与开发调试