API 使用说明

最近更新时间:2026-05-22 19:25:54

我的收藏

概述

大模型服务平台 TokenHub 兼容 OpenAI API、Anthropic API 协议,可直接使用 OpenAI SDK 快速接入。

接口域名

针对不同的地域,平台提供了不同的接入地址,以便于为您提供最稳定的接入。默认接入地址如下:
注意:
请根据服务开通的地域选择对应的接口地址,不支持跨地域、跨站点调用服务。
地域
接口地址
资源调度范围
广州
https://tokenhub.tencentmaas.com
中国大陆
新加坡
https://tokenhub-intl.tencentmaas.com
全球
同时平台提供了备用接入地址以确保异常情况下用户能顺利接入,当默认地址不可用时,您可以尝试切换为以下接入地址:
地域
接口地址
资源调度范围
广州
https://tokenhub.tencentmaas.cn
中国大陆
新加坡
https://tokenhub-intl.tencentmaas.cn
全球

鉴权方式

使用 API KEY 通过 Authorization: Bearer Header 鉴权。

模型调用方式

模型名称
model 参数值
API 调用指引
Hy3 preview
hy3-preview
详细调用参数可参见 文本生成
HY 2.0 Think(2026-06-22 下线)
hunyuan-2.0-thinking-20251109
HY 2.0 Instruct(2026-06-22 下线)
hunyuan-2.0-instruct-20251111
Hunyuan-role
hunyuan-role-latest
DeepSeek-V4-Flash
deepseek-v4-flash
DeepSeek-V4-Pro
deepseek-v4-pro
Deepseek-v3.2
deepseek-v3.2
Deepseek-v3.1(2026-05-25 下线)
deepseek-v3.1-terminus
Deepseek-r1-0528(2026-05-25 下线)
deepseek-r1-0528
Deepseek-v3-0324(2026-05-25 下线)
deepseek-v3-0324
GLM-5.1
glm-5.1
GLM-5V-Turbo
glm-5v-turbo
GLM-5-Turbo
glm-5-turbo
GLM-5
glm-5
Kimi-K2.6
kimi-k2.6
Kimi-K2.5
kimi-k2.5
MiniMax-M2.7
minimax-m2.7
MiniMax-M2.5
minimax-m2.5
Hy-MT2-Pro
hy-mt2-pro
HY-Image-V3.0
HY-Image-V3.0
详细调用参数可参见 图像生成
HY-Image-Lite
HY-Image-Lite
HY-Video-1.5
HY-Video-1.5
详细调用参数可参见 视频生成
YT-Video-2.0
YT-Video-2.0
YT-Video-HumanActor
YT-Video-HumanActor
YT-Video-FX
YT-Video-FX
HY-3D-3.0
HY-3D-3.0
详细调用参数可参见 3D 生成
HY-3D-3.1
HY-3D-3.1
HY-3D-Express
HY-3D-Express
YT-VITA
youtu-vita
详细调用参数可参见 多模态理解

异常处理

API 报错请参见 API 错误码说明