帮你快速理解、总结文档立即下载
文档中心>大模型服务平台 TokenHub>调用指南>API 使用说明

API 使用说明

最近更新时间：2026-07-16 23:04:30

我的收藏

本页目录：

概述

大模型服务平台 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 鉴权。

查询模型列表

您可以通过 GET /v1/models 接口查询当前平台支持的模型范围。该接口兼容 OpenAI API 协议，返回平台当前可调用的全部模型列表及其状态，模型 ID 即为调用推理接口时 model 参数需传入的值。
注意：
调用 /v1/models 需在请求头中传入 API KEY 进行鉴权（Authorization: Bearer <API KEY>）；未携带认证信息或 API KEY 无效时，接口将返回 HTTP 401 错误。

请求示例

curl https://tokenhub.tencentmaas.com/v1/models \\
  -H "Authorization: Bearer $TOKENHUB_API_KEY"

响应示例

{
    "object": "list",
    "data": [
        {
            "id": "hy3",
            "object": "model",
            "name": "Hy3",
            "created": 1783267200,
            "status": "online"
        },
        {
            "id": "deepseek-v4-pro",
            "object": "model",
            "name": "DeepSeek-V4-Pro",
            "created": 1776960000,
            "status": "online"
        }
    ]
}

响应参数说明

参数
类型
说明
object
String
固定为 list，表示返回的是模型列表。
data
Array
模型对象数组，每个元素代表一个可用模型。
data[].id
String
模型 ID，调用推理接口时 model 参数需传入该值。
data[].object
String
对象类型，固定为 model。
data[].name
String
模型展示名称。
data[].created
Integer
模型创建时间（Unix 时间戳，单位：秒）。
data[].status
String
模型状态，如 online（在线）、pre-offline（即将下线）。

模型调用方式

模型名称
model 参数值
API 调用指引
Hy3
hy3
详细调用参数可参见 语言模型调用概览。
Hy3 preview
hy3-preview
Hy-MT2-Pro
hy-mt2-pro
Hy-MT2-Plus
hy-mt2-plus
Hy-MT2-Lite
hy-mt2-lite
Hy-Role-Latest
hunyuan-role-latest
Hy-Role
hy-role
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.2
glm-5.2
GLM-5.1
glm-5.1
GLM-5V-Turbo
glm-5v-turbo
GLM-5-Turbo
glm-5-turbo
GLM-5
glm-5
Kimi K3
kimi-k3
Kimi K2.7 Code HighSpeed
kimi-k2.7-code-highspeed
Kimi K2.7 Code
kimi-k2.7-code
Kimi-K2.6
kimi-k2.6
Kimi-K2.5
kimi-k2.5
MiniMax-M3
minimax-m3
MiniMax-M2.7
minimax-m2.7
MiniMax-M2.5
minimax-m2.5
Qwen3.5 Flash
qwen3.5-flash
Qwen3.5 Plus
qwen3.5-plus
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
详细调用参数可参见 多模态理解。
HY-Vision-2.0-Instruct
hy-vision-2.0-instruct
HY-Vision-1.5-Thinking
hunyuan-t1-vision-20250916
HY-Vision-Video
hunyuan-turbos-vision-video-20250728
Kinfra-Text-Embedding-0.6b
kinfra-text-embedding-0.6b
详细调用参数可参见 向量模型。
Kinfra-Text-Embedding-4b
kinfra-text-embedding-4b
Kinfra-VL-Embedding-2b
kinfra-vl-embedding-2b
Kinfra-VL-Embedding-8b
kinfra-vl-embedding-8b

异常处理

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

中国站