腾讯混元大模型功能已迁移至tokenhub平台，旧控制台停用新购服务，需验证api兼容性：检查模型是否启用、使用tokenhub新密钥测试openai/anthropic接口及生图参数映射（如prompt转义、禁用input_image_mask、仅支持https图片url）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元大模型功能已迁移至 TokenHub 平台，旧控制台不再支持新购服务，此时若已有依赖旧 API 的系统或第三方集成，必须验证其与 TokenHub 新接口的兼容性，否则调用将直接失败返回 401 或 404 错误。
确认 TokenHub 是否已启用对应模型能力
登录 TokenHub 控制台（https://tokenhub.tencentcloud.com），进入【模型服务】→【已开通模型】列表，检查目标模型（如 hunyuan-a13b、hunyuan-translation 或 HY-Image-V3.0）状态是否为“已启用”。未启用的模型在 API 层不可见，所有请求均会触发 404 Not Found。
若列表为空或仅显示部分模型，需点击【申请开通】提交工单——TokenHub 实行按需开通机制，不默认全量开放。
验证 OpenAI 兼容接口连通性
方法一：使用 curl 直接测试基础 chat/completions 路径
执行以下命令（替换 YOUR_API_KEY 为 TokenHub 中生成的有效密钥）：
curl -X POST "https://api.hunyuan.cloud.tencent.com/v1/chat/completions" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{"model":"hunyuan-a13b","messages":[{"role":"user","content":"你好"}]}'
成功响应应含 "choices" 字段且 status=200；若返回 "error": "invalid_api_key"，说明密钥未在 TokenHub 中绑定该模型权限，需重新生成或授权。
方法二：用 Python SDK 快速验证（需安装 openai>=1.0.0）
import os
from openai import OpenAI
client = OpenAI(
api_key=os.getenv("HUNYUAN_API_KEY"),
base_url="https://api.hunyuan.cloud.tencent.com/v1"
)
response = client.chat.completions.create(
model="hunyuan-a13b",
messages=[{"role": "user", "content": "测试兼容性"}]
)
print(response.choices[0].message.content)
注意：TokenHub 的 OpenAI 兼容接口 不接受旧控制台生成的 sk- 开头密钥，必须使用 TokenHub【API 密钥管理】中新建的密钥，否则一律认证失败。
验证 Anthropic 兼容接口是否生效
第一步：确认模型标识符是否更新
TokenHub 中 Anthropic 兼容路径（/anthropic/v1/messages）仅支持新版模型名，例如 hunyuan-2.0-thinking-20251109。旧版如 hunyuan-pro 或 hunyuan-1.5 已下线，调用将返回 400 Bad Request。
第二步：构造最小化请求体
curl -X POST "https://api.hunyuan.cloud.tencent.com/anthropic/v1/messages" \
--header "x-api-key: YOUR_TOKENHUB_ANTRHOPIC_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "hunyuan-2.0-thinking-20251109",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "你是谁？"}]
}'
关键点：Anthropic 接口在 TokenHub 中使用 x-api-key 头而非 Authorization，且密钥需单独在 TokenHub 的【Anthropic 密钥】页生成，与 OpenAI 类型密钥隔离。
验证混元生图接口参数映射是否准确
① 提交任务前，必须将原接口中的 prompt 字段值转义为 JSON 字符串格式，否则 TokenHub 后端解析失败返回 400；例如中文 prompt “一只橘猫”需传入 "\"一只橘猫\""（双引号+反斜杠转义）。
② 原控制台支持的 input_image_mask 参数在 TokenHub 生图 V3.0 接口中已被移除，若代码中仍携带该字段，整个请求将被拒绝。
③ 检查图片 URL 协议：TokenHub 仅接受以 https:// 开头的公开可访问地址，http:// 或本地 file:// 路径直接报错 422 Unprocessable Entity。
执行提交请求：
curl -X POST "https://api.cloudai.tencent.com/v1/aiart/submit" \
--header "Authorization: Bearer YOUR_IMAGE_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "HY-Image-V3.0",
"prompt": "一只橘猫坐在窗台上",
"size": "1024x1024"
}'
成功响应包含 task_id 字段；若返回 "code": "InvalidParameter.Prompt"，即提示 prompt 格式或内容违规，需检查是否含敏感词或未转义特殊字符。
