API 使用说明

Download

聚焦模式

字号

最后更新时间： 2026-08-28 15:02:05

概述
大模型服务平台 TokenHub 兼容 OpenAI API、Anthropic API 协议，可直接使用 OpenAI SDK 快速接入。
接口域名
针对不同的地域，平台提供了不同的接入地址，以便于为您提供最稳定的接入。默认接入地址如下：
站点
接口地址
资源调度范围
新加坡
https://tokenhub-intl.tencentcloudmaas.com
全球
广州
https://tokenhub.tencentcloudmaas.com
中国大陆
硅谷
https://tokenhub-us.tencentcloudmaas.com
美国
同时平台提供了备用接入地址以确保异常情况下用户能顺利接入，当默认地址不可用时，您可以尝试切换为以下接入地址：
站点
接口地址
新加坡
https://tokenhub-intl.tencentcloudmaas.tech
广州
https://tokenhub.tencentcloudmaas.tech
硅谷
https://tokenhub-us.tencentcloudmaas.tech
鉴权方式
使用 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.tencentcloudmaas.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 调用指引
Hy4 preview
hy4-preview
详细调用参数参见 语言模型调用概览。
Hy3
hy3
﻿
DeepSeek-V4-Flash 0731 正式版 原厂直供
deepseek-v4-flash-202605
deepseek/deepseek-v4-flash-0731
deepseek/deepseek-v4-flash
﻿
DeepSeek-V4-Pro 0813 正式版 原厂直供
deepseek-v4-pro-202606
deepseek/deepseek-v4-pro-0813
deepseek/deepseek-v4-pro
﻿
DeepSeek-V4-Flash-Vision-Exp 原厂直供
deepseek/deepseek-v4-flash-vision-exp
﻿
DeepSeek-V4-Flash 0731 正式版
deepseek-v4-flash-0731
﻿
DeepSeek-V4-Pro 0813 正式版
deepseek-v4-pro-0813
﻿
DeepSeek-V4-Flash
deepseek-v4-flash
﻿
DeepSeek-V4-Pro
deepseek-v4-pro
﻿
Deepseek-v3.2
deepseek-v3.2
﻿
GLM-5.3
glm-5.3
﻿
GLM-5.3-Flash
glm-5.3-flash
﻿
GLM-5.2
glm-5.2
﻿
GLM-5.1
glm-5.1
﻿
GLM-5
glm-5
﻿
GLM-5V-Turbo
glm-5v-turbo
﻿
GLM-5-Turbo
glm-5-turbo
﻿
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
﻿
Hy-MT2-Plus
hy-mt2-plus
﻿
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 错误码说明。
﻿
﻿
﻿

帮助和支持

本页内容是否解决了您的问题？

您也可以联系销售或提交工单以寻求帮助。

填写满意度调查问卷，共创更好文档体验。

文档反馈

站点	接口地址	资源调度范围
新加坡	https://tokenhub-intl.tencentcloudmaas.com	全球
广州	https://tokenhub.tencentcloudmaas.com	中国大陆
硅谷	https://tokenhub-us.tencentcloudmaas.com	美国

参数	类型	说明
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 preview	hy4-preview	详细调用参数参见语言模型调用概览。
Hy3	hy3
DeepSeek-V4-Flash 0731 正式版原厂直供	deepseek-v4-flash-202605 deepseek/deepseek-v4-flash-0731 deepseek/deepseek-v4-flash
DeepSeek-V4-Pro 0813 正式版原厂直供	deepseek-v4-pro-202606 deepseek/deepseek-v4-pro-0813 deepseek/deepseek-v4-pro
DeepSeek-V4-Flash-Vision-Exp 原厂直供	deepseek/deepseek-v4-flash-vision-exp
DeepSeek-V4-Flash 0731 正式版	deepseek-v4-flash-0731
DeepSeek-V4-Pro 0813 正式版	deepseek-v4-pro-0813
DeepSeek-V4-Flash	deepseek-v4-flash
DeepSeek-V4-Pro	deepseek-v4-pro
Deepseek-v3.2	deepseek-v3.2
GLM-5.3	glm-5.3
GLM-5.3-Flash	glm-5.3-flash
GLM-5.2	glm-5.2
GLM-5.1	glm-5.1
GLM-5	glm-5
GLM-5V-Turbo	glm-5v-turbo
GLM-5-Turbo	glm-5-turbo
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
Hy-MT2-Plus	hy-mt2-plus
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

tencent cloud

大模型服务平台 TokenHub

API 使用说明

概述

接口域名

鉴权方式

查询模型列表

请求示例

响应示例

响应参数说明

模型调用方式

异常处理

帮助和支持