开发者文档 · v1

5 分钟接入,像调用 OpenAI 一样调用所有模型

TokenHub 提供完全兼容 OpenAI 的 HTTP 接口。已有代码只需替换 base_url 与 api_key, Python、Node.js、LangChain、Go 等任意客户端都可以直接使用。

https://api.tokenhub.dev/v1获取 API Key37 个模型可用
01 · Quickstart

快速开始

使用 TokenHub 只需要三步:注册账号、在控制台创建 API Key、把 SDK 的 base_url 指向 https://api.tokenhub.dev/v1。 下面以 deepseek-v4-pro 为例。

提示:base_url 必须包含 /v1 后缀;模型 ID 使用 GET /v1/models 返回的 slug,而不是厂商内部名称。
request.sh
1curl https://api.tokenhub.dev/v1/chat/completions \
2 -H "Authorization: Bearer $TOKENHUB_API_KEY" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "model": "deepseek-v4-pro",
6 "messages": [{"role": "user", "content": "你好,TokenHub!"}],
7 "stream": false
8 }'
02 · Authentication

鉴权

所有 API 请求都需要在请求头携带 API Key。Key 在控制台「API 密钥」页面创建, 以 sk-th- 开头,支持为每个环境或服务创建独立 Key。

auth.sh
1curl https://api.tokenhub.dev/v1/models \
2 -H "Authorization: Bearer $TOKENHUB_API_KEY"
  • 完整 Key 仅在创建时展示一次,请立即保存到环境变量(如 TOKENHUB_API_KEY),不要硬编码进仓库。
  • 平台只保存 Key 的 SHA-256 哈希,无法找回明文;Key 泄露时可在控制台一键吊销。
  • 可为每个 Key 设置 RPM 限流、消费上限与过期时间,便于按项目或成员隔离成本。
03 · Streaming

流式输出

在请求体中设置 stream: true 即可获得 SSE 流式响应,网关会原样转发上游增量事件,结束时返回 data: [DONE]。计费在流结束后按实际用量结算。

stream.py
1resp = client.chat.completions.create(
2 model="deepseek-v4-pro",
3 messages=[{"role": "user", "content": "写一句关于云的诗"}],
4 stream=True,
5)
6 
7for chunk in resp:
8 delta = chunk.choices[0].delta.content
9 if delta:
10 print(delta, end="", flush=True)

若使用原生 HTTP 客户端,请将响应按 text/event-stream 增量解析, 每行以 data: 开头。

04 · Errors

错误码

网关与上游的错误统一转换为 OpenAI 错误格式: { "error": { "message", "type", "code" } }。建议按 HTTP 状态码做重试与降级策略。

HTTP错误码说明处理建议
401invalid_api_keyAPI Key 无效、已过期或已被吊销检查 Authorization 请求头,确认 Key 前缀为 sk-th- 且在控制台处于启用状态
402insufficient_balance账户余额不足以覆盖本次预估费用在控制台充值,或降低 max_tokens 后重试
403account_suspended租户已被停用或 Key 权限不足联系团队管理员或平台客服处理
404model_not_found请求的模型不存在或已下线调用 GET /v1/models 获取最新模型列表
429rate_limit_exceeded触发 RPM 限流或上游并发限制使用指数退避重试,或在控制台申请更高的 RPM 限额
400invalid_request_error请求体格式不符合 OpenAI 规范对照 OpenAI 参数规范检查 messages、tools 等字段
502upstream_error上游模型返回异常或超时稍后重试;若持续出现,请携带 requestId 联系支持
503provider_unavailable上游厂商未配置或暂时不可用换用其他模型,或等待平台恢复后重试
05 · Models

模型列表

通过 GET /v1/models 获取当前账号可用的模型(OpenAI 兼容列表格式)。完整价格请查看 模型价格页。

models.sh
1curl https://api.tokenhub.dev/v1/models \
2 -H "Authorization: Bearer $TOKENHUB_API_KEY"
3 
4# 返回 OpenAI 兼容格式
5# { "object": "list", "data": [{ "id": "deepseek-v4-pro", "object": "model" }, ...] }
模型 ID厂商上下文输入 / M输出 / M能力
gpt-6.1-sol-pro
GPT-6.1 Sol Pro
OAOpenAI1.1M¥14.40¥72.00
对话视觉
gpt-6.1-terra
GPT-6.1 Terra
OAOpenAI1.1M¥7.20¥36.00
对话视觉
gpt-6.1-terra-pro
GPT-6.1 Terra Pro
OAOpenAI1.1M¥7.20¥36.00
对话视觉
gpt-6-luna
GPT-6 Luna
OAOpenAI1.1M¥0.72¥3.60
对话视觉
claude-fable-5.1
Claude Fable 5.1
ANAnthropic1M¥72.00¥360.00
对话视觉
claude-opus-5.5
Claude Opus 5.5
ANAnthropic1M¥28.80¥144.00
对话视觉
claude-sonnet-5.5
Claude Sonnet 5.5
ANAnthropic1M¥14.40¥72.00
对话视觉
claude-haiku-5.5
Claude Haiku 5.5
ANAnthropic1M¥0.72¥3.60
对话视觉
gemini-4-argon
Gemini 4 Argon
GGoogle Gemini1M¥14.40¥72.00
对话视觉
gemini-3.8-flash
Gemini 3.8 Flash
GGoogle Gemini1M¥5.94¥29.70
对话视觉
gemini-3.5-flash-lite
Gemini 3.5 Flash Lite
GGoogle Gemini1M¥2.16¥18.00
对话视觉
deepseek-v4-pro
DeepSeek V4 Pro
DSDeepSeek1M¥9.50¥28.51
对话工具调用
deepseek-flash
DeepSeek V4.1 Flash
DSDeepSeek1M¥2.16¥8.64
对话视觉
qwen3.8-max
Qwen3.8 Max
QW通义千问1M¥12.00¥36.00
对话视觉
qwen3.7-plus
Qwen3.7 Plus
QW通义千问1M¥2.00¥8.00
对话视觉
qwen3.8-flash
Qwen3.8 Flash
QW通义千问1M¥0.80¥2.70
对话视觉
kimi-k3
Kimi K3
KKimi1M¥20.00¥100.00
对话视觉
kimi-k3.1-pro
Kimi K3.1 Pro
KKimi1M¥13.00¥68.00
对话视觉
kimi-k2.7-code
Kimi K2.7 Code
KKimi262K¥6.50¥27.00
对话工具调用
glm-5.3
GLM-5.3
GLM智谱 GLM1M¥8.00¥28.00
对话视觉
glm-5.3-flashx
GLM-5.3 FlashX
GLM智谱 GLM1M¥2.00¥7.00
对话视觉
glm-5.3-flash
GLM-5.3 Flash
GLM智谱 GLM1M¥0.80¥2.80
对话视觉
doubao-seed-2-1-pro
Doubao Seed 2.1 Pro
DB豆包1M¥6.00¥30.00
对话视觉
doubao-seed-evolving
Doubao Seed Evolving
DB豆包1M¥6.00¥30.00
对话视觉
doubao-seed-2-1-turbo
Doubao Seed 2.1 Turbo
DB豆包262K¥3.00¥15.00
对话视觉
doubao-seed-2-1-lite
Doubao Seed 2.1 Lite
DB豆包1M¥0.80¥2.70
对话视觉
hy4
混元 Hy4
HY腾讯混元1M¥6.00¥18.00
对话视觉
hy3
混元 Hy3
HY腾讯混元262K¥0.60¥2.40
对话视觉
ernie-5.1
ERNIE 5.1
ER文心一言128K¥4.00¥18.00
对话视觉
minimax-m2.7
MiniMax M2.7
MMMiniMax205K¥2.10¥8.40
对话工具调用
minimax-m3
MiniMax M3
MMMiniMax1M¥2.10¥8.40
对话工具调用
minimax-m3.1-flash
MiniMax M3.1 Flash
MMMiniMax1M¥1.00¥4.00
对话工具调用
mistral-large-4
Mistral Large 4
MIMistral1M¥5.04¥15.12
对话工具调用
devstral-2
Devstral 2
MIMistral262K¥2.88¥14.40
对话工具调用
grok-4.7
Grok 4.7
XxAI Grok500K¥14.40¥43.20
对话视觉
grok-4.3
Grok 4.3
XxAI Grok1M¥9.00¥18.00
对话视觉
grok-build-0.1
Grok Build 0.1
XxAI Grok256K¥7.20¥14.40
对话工具调用

共 37 个模型,列表与价格实时读取自平台配置;上游发布新模型后我们会在 24 小时内完成接入。

06 · FAQ

常见问题

准备好发起第一次调用了吗?

注册即送 ¥5.00 体验金,无需绑定支付方式。遇到问题可以在控制台提交工单或直接邮件联系我们。