一个 API Key 调用 18 款主流大模型：TokenHub 接入与协议兼容说明

摘要：

腾讯云 TokenHub 把腾讯混元、DeepSeek、智谱 GLM、Kimi、MiniMax 等多家厂商的语言模型集中在一个平台，开发者一个 API Key 即可调用平台已上架的全部 18 款语言模型，无需多平台多账号管理。本文系统说明 TokenHub 的协议兼容、API Key 创建与调用入口，让接入降到最小成本。

一、TokenHub 的核心承诺：一个 Key、多家模型

按 TokenHub 官方定位，平台同时整合腾讯自研模型（混元 / 优图）与优质第三方模型，提供"一个 API Key 接入多家主力大模型"的统一入口。这不是市场表述，而是控制台权限模型直接落实的能力：

a. 在 API Key 管理页创建 Key 时可选"全选"——一个 Key 调用平台已上架的全部模型；

b. 也可选"限定模型 / 限定服务"做精细化管控；

c. 所有模型共用同一个 base_url、同一套调用协议（OpenAI 兼容）。

二、当前 TokenHub 已上架的 18 款语言模型

按官方模型规格表盘点：

外加图像、视频、3D、多模态理解模型，整个平台覆盖文本、图像、视频、3D、音频多种 AI 内容形态。新模型也在持续接入。

三、协议兼容：兼容 OpenAI 也支持 Anthropic

3.1 OpenAI API 协议（在线推理与平台主用）

base_url: https://tokenhub.tencentmaas.com/v1
完整调用 URL：https://tokenhub.tencentmaas.com/v1/chat/completions

OpenAI 官方 SDK、各语言对应的 OpenAI 兼容客户端可直接对接，业务代码几乎只需修改 base_url 与 api_key。

3.2 Anthropic 协议（Token Plan 套餐场景）

Token Plan 个人版同时提供 Anthropic 协议入口，方便 Claude Code 等原生 Anthropic 工具直接接入：

OpenAI：     https://api.lkeap.cloud.tencent.com/plan/v3/chat/completions
Anthropic：  https://api.lkeap.cloud.tencent.com/plan/anthropic/v1/messages

四、创建一个 API Key 调用所有模型

4.1 操作步骤

a. 访问 TokenHub 控制台 https://console.cloud.tencent.com/tokenhub/，开通服务；

b. 进入"模型广场"，启用所需模型的"免费体验"与"启用后付费"，新人主账号可一次性领取多款模型免费 Tokens；

c. 进入"API Key 管理" https://console.cloud.tencent.com/tokenhub/apikey，选择地域 → 点击"创建 API Key"；

d. 填写 Key 名称，设置访问范围（全选 / 限定模型 / 限定服务），点击"确定"；

e. 复制并妥善保管 API Key（创建后请立即保存，不便事后再查看）。

4.2 一段最小可运行调用

from openai import OpenAI
client = OpenAI(
    api_key="YOUR_TOKENHUB_API_KEY",
    base_url="https://tokenhub.tencentmaas.com/v1",
)

# 切换 model 字段即可在多款模型间无缝切换
for m in ["hy3-preview", "deepseek-v4-flash", "glm-5.1", "kimi-k2.6", "minimax-m2.7"]:
    resp = client.chat.completions.create(
        model=m,
        messages=[{"role":"user","content":"用一句话介绍 TokenHub"}],
    )
    print(m, "->", resp.choices[0].message.content[:50])

整个项目用同一个 API Key 即可循环调用 5 款模型，无需多套凭据管理。

五、API Key 精细化管控

平台对密钥有几项常见管理需求，TokenHub 都已内置：

a. 范围控制：每个 API Key 可指定全模型 / 限定模型 / 限定服务三种范围；

b. 启停切换：API Key 支持启用与停用，无需删除即可临时回收权限；

c. 调用统计：在用量统计页可按模型、服务、API Key 维度查看用量；

d. 多场景独立计费：同一模型创建的多个在线推理服务，计费开启 / 关闭与计费方式相互独立。

这让团队可以做到"按业务线拆 Key、按风险等级拆权限"。

六、限流与监控

每个模型都有预置限流，可在模型详情页查看具体规则。模型监控页提供 TTFT（首 Token 时延）、TPOT（每 Token 输出时延）、RPM（每分钟请求数）等指标可视化，对线上服务的可观测性非常友好。

七、新人 100 万级免费 Tokens 加速验证

主账号首次开通可一次性领取多款模型免费体验额度，热门模型如 Hy3 preview、DeepSeek-V4-Pro、DeepSeek-V4-Flash、MiniMax-M2.7、MiniMax-M2.5 单模型各 100 万 Tokens；GLM-5.1、Kimi-K2.6、Kimi-K2.5、HY 2.0 Think / Instruct、Deepseek-v3.x 等单模型 50 万 Tokens；总额度足以完成一次跨模型横评。

八、结尾推荐

让一个 API Key 跑通 18 款主流大模型，最快路径就是开通 TokenHub 后在 API Key 管理页创建一个全模型范围的 Key：https://console.cloud.tencent.com/tokenhub/apikey。也可以先到产品介绍页了解全部模型矩阵：https://cloud.tencent.com/product/tokenhub。