① 获取官方 API Key
在控制台「API Key」页面创建 Key,该 Key 由腾讯云 TokenHub 官方侧签发,属于官方 Key。请妥善保管,页面仅在创建时展示一次明文。
请求直接发往腾讯云 TokenHub 官方域名,与官方文档的 Base URL、鉴权头、请求体完全一致。
你只需在控制台创建官方 Key,替换 Authorization 里的 Key 即可。
在控制台「API Key」页面创建 Key,该 Key 由腾讯云 TokenHub 官方侧签发,属于官方 Key。请妥善保管,页面仅在创建时展示一次明文。
按服务开通地域选择接口地址,不支持跨地域调用:广州 https://tokenhub.tencentmaas.com/v1,新加坡 https://tokenhub-intl.tencentmaas.com/v1。备用域名将 .com 换成 .cn。
| 地域 | 默认地址 | 备用地址 | 资源调度范围 |
|---|---|---|---|
| 广州 | https://tokenhub.tencentmaas.com | https://tokenhub.tencentmaas.cn | 中国大陆 |
| 新加坡 | https://tokenhub-intl.tencentmaas.com | https://tokenhub-intl.tencentmaas.cn | 全球 |
调用 GET /v1/models 获取当前可调用模型及状态,返回的 id 即推理接口 model 参数值;未携带或无效 Key 返回 401。
# 查询可用模型 curl https://tokenhub.tencentmaas.com/v1/models \ -H "Authorization: Bearer YOUR_TOKENHUB_API_KEY"
将 YOUR_TOKENHUB_API_KEY 替换为控制台创建的官方 Key,其余与 OpenAI SDK 完全一致。
# Chat Completions(请求直达腾讯云 TokenHub 官方域名) curl https://tokenhub.tencentmaas.com/v1/chat/completions \ -H "Authorization: Bearer YOUR_TOKENHUB_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "hy4", "messages": [{"role": "user", "content": "用一句话解释什么是腾讯云 Token 官方直连"}] }'
# Python(OpenAI SDK) from openai import OpenAI client = OpenAI( api_key="YOUR_TOKENHUB_API_KEY", base_url="https://tokenhub.tencentmaas.com/v1", ) resp = client.chat.completions.create( model="deepseek-v4.1-flash-1017", messages=[{"role": "user", "content": "你好"}], ) print(resp.choices[0].message.content)
TokenHub 同时兼容 Anthropic Messages 协议,端点同为 /v1/messages,使用 x-api-key 头鉴权;并非所有模型都支持 Anthropic 协议,具体见官方模型协议表。
# Anthropic Messages curl https://tokenhub.tencentmaas.com/v1/messages \ -H "x-api-key: YOUR_TOKENHUB_API_KEY" \ -H "Content-Type: application/json" \ -H "anthropic-version: 2023-06-01" \ -d '{ "model": "hy4", "max_tokens": 1024, "messages": [{"role": "user", "content": "用一句话解释什么是腾讯云 Token 官方直连"}] }'
OpenAI 协议用 Authorization: Bearer <Key>;Anthropic 协议用 x-api-key: <Key>。
返回体含官方 request id,问题可直接向腾讯云 TokenHub 官方提工单。
每次调用计入账号用量,可在控制台按 Key、模型、日期对账。
| 模型 | Model ID | 协议 |
|---|---|---|
| Hy4 | hy4 | OpenAI / Anthropic |
| Hy3 | hy3 | OpenAI / Anthropic |
| DeepSeek-V4.1-Flash-1017 原厂直供 | deepseek/deepseek-flash | OpenAI / Anthropic |
| DeepSeek-V4.1-Flash | deepseek-v4.1-flash-1017 | OpenAI / Anthropic |
| GLM-5.3 | glm-5.3 | OpenAI / Anthropic |
| Kimi K3.1 Pro | kimi-k3.1-pro | OpenAI / Anthropic |
| MiniMax-M3 | minimax-m3 | OpenAI / Anthropic |
| Seedream-Image-v5.0-pro(文生图) | 以 GET /v1/models 为准 | 图像 |
| HY-Video-v1.5(文生视频) | hy-video-v1.5 | 视频 |
完整 35 个语言模型与多模态模型、官方刊例价见 价格与渠道对比 与控制台模型广场。
/v1/chat/completions)、OpenAI Responses(/v1/responses)与 Anthropic Messages(/v1/messages)三种协议;各模型对 Responses 与 Anthropic 的支持不同,以官方协议概览表为准。现有 SDK 代码只需改 base_url 与 api_key 两处即可切换,无需改动请求体。