开发者文档 · v1
5 分钟接入,像调用 OpenAI 一样调用所有模型
TokenHub 提供完全兼容 OpenAI 的 HTTP 接口。已有代码只需替换 base_url 与 api_key, Python、Node.js、LangChain、Go 等任意客户端都可以直接使用。
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": false8 }'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.content9 if delta:10 print(delta, end="", flush=True)若使用原生 HTTP 客户端,请将响应按 text/event-stream 增量解析, 每行以 data: 开头。
04 · Errors
错误码
网关与上游的错误统一转换为 OpenAI 错误格式: { "error": { "message", "type", "code" } }。建议按 HTTP 状态码做重试与降级策略。
| HTTP | 错误码 | 说明 | 处理建议 |
|---|---|---|---|
| 401 | invalid_api_key | API Key 无效、已过期或已被吊销 | 检查 Authorization 请求头,确认 Key 前缀为 sk-th- 且在控制台处于启用状态 |
| 402 | insufficient_balance | 账户余额不足以覆盖本次预估费用 | 在控制台充值,或降低 max_tokens 后重试 |
| 403 | account_suspended | 租户已被停用或 Key 权限不足 | 联系团队管理员或平台客服处理 |
| 404 | model_not_found | 请求的模型不存在或已下线 | 调用 GET /v1/models 获取最新模型列表 |
| 429 | rate_limit_exceeded | 触发 RPM 限流或上游并发限制 | 使用指数退避重试,或在控制台申请更高的 RPM 限额 |
| 400 | invalid_request_error | 请求体格式不符合 OpenAI 规范 | 对照 OpenAI 参数规范检查 messages、tools 等字段 |
| 502 | upstream_error | 上游模型返回异常或超时 | 稍后重试;若持续出现,请携带 requestId 联系支持 |
| 503 | provider_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 | OAOpenAI | 1.1M | ¥14.40 | ¥72.00 | 对话视觉 |
gpt-6.1-terra GPT-6.1 Terra | OAOpenAI | 1.1M | ¥7.20 | ¥36.00 | 对话视觉 |
gpt-6.1-terra-pro GPT-6.1 Terra Pro | OAOpenAI | 1.1M | ¥7.20 | ¥36.00 | 对话视觉 |
gpt-6-luna GPT-6 Luna | OAOpenAI | 1.1M | ¥0.72 | ¥3.60 | 对话视觉 |
claude-fable-5.1 Claude Fable 5.1 | ANAnthropic | 1M | ¥72.00 | ¥360.00 | 对话视觉 |
claude-opus-5.5 Claude Opus 5.5 | ANAnthropic | 1M | ¥28.80 | ¥144.00 | 对话视觉 |
claude-sonnet-5.5 Claude Sonnet 5.5 | ANAnthropic | 1M | ¥14.40 | ¥72.00 | 对话视觉 |
claude-haiku-5.5 Claude Haiku 5.5 | ANAnthropic | 1M | ¥0.72 | ¥3.60 | 对话视觉 |
gemini-4-argon Gemini 4 Argon | GGoogle Gemini | 1M | ¥14.40 | ¥72.00 | 对话视觉 |
gemini-3.8-flash Gemini 3.8 Flash | GGoogle Gemini | 1M | ¥5.94 | ¥29.70 | 对话视觉 |
gemini-3.5-flash-lite Gemini 3.5 Flash Lite | GGoogle Gemini | 1M | ¥2.16 | ¥18.00 | 对话视觉 |
deepseek-v4-pro DeepSeek V4 Pro | DSDeepSeek | 1M | ¥9.50 | ¥28.51 | 对话工具调用 |
deepseek-flash DeepSeek V4.1 Flash | DSDeepSeek | 1M | ¥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 | KKimi | 1M | ¥20.00 | ¥100.00 | 对话视觉 |
kimi-k3.1-pro Kimi K3.1 Pro | KKimi | 1M | ¥13.00 | ¥68.00 | 对话视觉 |
kimi-k2.7-code Kimi K2.7 Code | KKimi | 262K | ¥6.50 | ¥27.00 | 对话工具调用 |
glm-5.3 GLM-5.3 | GLM智谱 GLM | 1M | ¥8.00 | ¥28.00 | 对话视觉 |
glm-5.3-flashx GLM-5.3 FlashX | GLM智谱 GLM | 1M | ¥2.00 | ¥7.00 | 对话视觉 |
glm-5.3-flash GLM-5.3 Flash | GLM智谱 GLM | 1M | ¥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 | MMMiniMax | 205K | ¥2.10 | ¥8.40 | 对话工具调用 |
minimax-m3 MiniMax M3 | MMMiniMax | 1M | ¥2.10 | ¥8.40 | 对话工具调用 |
minimax-m3.1-flash MiniMax M3.1 Flash | MMMiniMax | 1M | ¥1.00 | ¥4.00 | 对话工具调用 |
mistral-large-4 Mistral Large 4 | MIMistral | 1M | ¥5.04 | ¥15.12 | 对话工具调用 |
devstral-2 Devstral 2 | MIMistral | 262K | ¥2.88 | ¥14.40 | 对话工具调用 |
grok-4.7 Grok 4.7 | XxAI Grok | 500K | ¥14.40 | ¥43.20 | 对话视觉 |
grok-4.3 Grok 4.3 | XxAI Grok | 1M | ¥9.00 | ¥18.00 | 对话视觉 |
grok-build-0.1 Grok Build 0.1 | XxAI Grok | 256K | ¥7.20 | ¥14.40 | 对话工具调用 |
共 37 个模型,列表与价格实时读取自平台配置;上游发布新模型后我们会在 24 小时内完成接入。
06 · FAQ