一、接口域名
针对不同的地域，平台提供了不同的接入地址，以便于为你提供最稳定的接入。默认接入地址如下：
注意：请根据服务开通的地域选择对应的接口地址，不支持跨地域、跨站点调用服务。
| 地域 | 接口地址 | 资源调度范围 |
| 广州 | 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": "hy4", "object": "model", "name": "hy4", "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 调用指引 |
| Hy4 | hy4 | 详细调用参数可参见 语言模型调用概览。 |
| Hy4 preview | hy4-preview | |
| Hy3 | hy3 | |
| 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.1-Flash-1017 原厂直供 | deepseek/deepseek-flash | |
| DeepSeek-V4-Flash 0731 正式版 原厂直供 | deepseek-v4-flash-202605deepseek/deepseek-v4-flash-0731deepseek/deepseek-v4-flash | |
| DeepSeek-V4-Pro 0813 正式版 原厂直供 | deepseek-v4-pro-202606deepseek/deepseek-v4-pro-0813deepseek/deepseek-v4-pro | |
| DeepSeek-V4-Flash-Vision-Exp 原厂直供 | deepseek/deepseek-v4-flash-vision-exp | |
| DeepSeek-V4.1-Flash-1017 | deepseek-v4.1-flash-1017 | |
| DeepSeek-V4.1-Flash | deepseek-v4.1-flash | |
| DeepSeek-V4-Pro 0813 正式版 | deepseek-v4-pro-0813 | |
| DeepSeek-V4-Pro | deepseek-v4-pro | |
| GLM-5.3 | glm-5.3 | |
| GLM-5.3-Flash | glm-5.3-flash | |
| GLM-5.3-FlashX | glm-5.3-flashx | |
| GLM-5.2 | glm-5.2 | |
| GLM-5V-Turbo | glm-5v-turbo | |
| Kimi K3.1 Pro HighSpeed | kimi-k3.1-pro-highspeed | |
| Kimi K3.1 Pro | kimi-k3.1-pro | |
| Kimi K3 | kimi-k3 | |
| Kimi K2.8 Preview | kimi-k2.8-preview | |
| Kimi K2.7 Code HighSpeed | kimi-k2.7-code-highspeed | |
| Kimi K2.7 Code | kimi-k2.7-code | |
| Kimi-K2.6 | kimi-k2.6 | |
| MiniMax-M3.1-Flash | minimax-m3.1-flash | |
| MiniMax-M3 | minimax-m3 | |
| MiniMax-M2.7 | minimax-m2.7 | |
| MiMo-V2.6-Pro | mimo-v2.6-pro | |
| MiMo-V2.6-Flash | mimo-v2.6-flash | |
| MiMo-V2.5-Pro | mimo-v2.5-pro | |
| Step 5 Preview | step-5-preview | |
| Hy-Image-3.0 | hy-image-v3 | 详细调用参数可参见 图像生成模型调用概览。 |
| Vidu-Image-q2 | vidu-image-q2 | |
| Hy-Video-v1.5 | hy-video-v1.5 | 详细调用参数可参见 视频生成模型调用概览。 |
| PixVerse-Video-v6 | pixverse-video-v6.0 | |
| Kling-Video-V3 | kling-video-v3 | |
| MiniMax-Video-H3 | minimax-video-h3 | |
| 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 错误码说明。