API 接入指南

三步接入腾讯云 Token 官方 API

请求直接发往腾讯云 TokenHub 官方域名,与官方文档的 Base URL、鉴权头、请求体完全一致。 你只需在控制台创建官方 Key,替换 Authorization 里的 Key 即可。

① 获取官方 API Key

在控制台「API Key」页面创建 Key,该 Key 由腾讯云 TokenHub 官方侧签发,属于官方 Key。请妥善保管,页面仅在创建时展示一次明文。

② 配置 Base URL

按服务开通地域选择接口地址,不支持跨地域调用:广州 https://tokenhub.tencentmaas.com/v1,新加坡 https://tokenhub-intl.tencentmaas.com/v1。备用域名将 .com 换成 .cn。

接口域名

地域默认地址备用地址资源调度范围
广州https://tokenhub.tencentmaas.comhttps://tokenhub.tencentmaas.cn中国大陆
新加坡https://tokenhub-intl.tencentmaas.comhttps://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"

OpenAI 兼容调用示例

将 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)

Anthropic 兼容(Messages)

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

返回体含官方 request id,问题可直接向腾讯云 TokenHub 官方提工单。

📈

用量可追溯

每次调用计入账号用量,可在控制台按 Key、模型、日期对账。

官方直连模型(部分)

模型Model ID协议
Hy4hy4OpenAI / Anthropic
Hy3hy3OpenAI / Anthropic
DeepSeek-V4.1-Flash-1017 原厂直供deepseek/deepseek-flashOpenAI / Anthropic
DeepSeek-V4.1-Flashdeepseek-v4.1-flash-1017OpenAI / Anthropic
GLM-5.3glm-5.3OpenAI / Anthropic
Kimi K3.1 Prokimi-k3.1-proOpenAI / Anthropic
MiniMax-M3minimax-m3OpenAI / Anthropic
Seedream-Image-v5.0-pro(文生图)以 GET /v1/models 为准图像
HY-Video-v1.5(文生视频)hy-video-v1.5视频

完整 35 个语言模型与多模态模型、官方刊例价见 价格与渠道对比 与控制台模型广场。

接入要点:TokenHub 统一提供 OpenAI Chat Completions(/v1/chat/completions)、OpenAI Responses(/v1/responses)与 Anthropic Messages(/v1/messages)三种协议;各模型对 Responses 与 Anthropic 的支持不同,以官方协议概览表为准。现有 SDK 代码只需改 base_url 与 api_key 两处即可切换,无需改动请求体。