腾讯混元旧接口已停用，所有新调用须迁移至TokenHub控制台创建密钥、选择模型并配置API；旧域名自2026年8月起逐步下线，新base_url为https://tokenhub.tencentmaas.com/v1等，迁移后需用curl验证响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元旧接口已停止新增模型能力，原平台不再支持新购服务，所有新调用必须迁移到TokenHub控制台完成密钥创建、模型选择与API配置；迁移失败将导致请求返回404或鉴权拒绝。
确认旧接口是否已停用
登录原混元大模型控制台（如 https://hunyuan.tencent.com），若页面显示「服务已迁移至TokenHub」或无法找到「API密钥管理」「模型调用配置」入口，则说明该账号下旧接口已不可用。部分老账号仍可访问历史服务，但自2026年6月10日起，所有新购、续费、扩并发操作均被拦截。
检查当前调用的base_url：若为类似 https://api.hunyuan.tencent.com/v2 或 https://hunyuan.cloud.tencent.com/openapi，这些域名已在2026年8月起逐步DNS下线，请求会超时或返回503。
在TokenHub开通并获取新API Key
第一步：访问TokenHub控制台 → https://console.cloud.tencent.com/tokenhub/
第二步：点击左侧菜单「在线推理」→ 选择目标模型（如hy3-preview、hy4-preview）→ 开启「免费体验」与「启用后付费」
第三步：点击右上角「新用户福利免费体验」→ 勾选至少一个模型 → 「立即领取」，获得50–100万Tokens，有效期90天（截止2026年12月27日前）
第四步：进入「API密钥管理」→ 点击「创建API KEY」→ 输入名称（建议含环境标识，如hy3-prod）→ 确认生成
SecretKey仅首次展示，关闭页面即永久丢失，务必立即复制保存到安全位置。如已遗漏，只能删除旧密钥后重新创建。
替换base_url与模型参数
方法一：在线推理（按量计费，推荐新项目）
旧base_url（失效）：https://api.hunyuan.tencent.com/v2
新base_url（生效）：https://tokenhub.tencentmaas.com/v1
完整请求地址：https://tokenhub.tencentmaas.com/v1/chat/completions
方法二：Token Plan（订阅套餐，适合稳定用量）
新base_url：https://api.lkeap.cloud.tencent.com/plan/v3
注意：此入口不兼容Anthropic协议，如需使用Claude风格调用，请走方法三
方法三：Anthropic协议专用（仅Token Plan支持）
新base_url：https://api.lkeap.cloud.tencent.com/plan/anthropic
完整地址：https://api.lkeap.cloud.tencent.com/plan/anthropic/v1/messages
调用时需将model参数改为anthropic-compatible格式，例如"model": "claude-3-haiku-20240307"
验证迁移是否成功
用curl执行最简测试请求：
curl -X POST 'https://tokenhub.tencentmaas.com/v1/chat/completions' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer sk-xxxxxx' \
-d '{ "model": "hy3-preview", "messages": [{"role":"user","content":"测试"}], "temperature": 0.1 }'
收到JSON响应且"object"字段为"chat.completion"，即表示TokenHub链路通达。若返回"invalid_api_key"，请检查SecretKey是否粘贴错误或过期；若返回"model_not_found"，说明所填model值未在TokenHub中启用，需回到「在线推理」页面手动开启对应模型开关。
