可直接切换腾讯混元模型，前提是系统已兼容OpenAI协议；否则需用SDK集成。确认接口为/v1/chat/completions后，仅需更换endpoint、鉴权密钥及指定精确model ID。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你想把正在用的聊天系统后端模型从当前供应商切换成腾讯混元，但又不能停机重写整套对话逻辑——这需要在保留原有接口契约的前提下完成模型替换。
确认现有系统是否兼容OpenAI标准协议
先检查你的聊天系统是否基于 OpenAI 兼容的 REST API 接口（如 /v1/chat/completions）构建。如果是，可直接复用请求结构，仅更换 endpoint 和鉴权方式。
打开系统配置文件或环境变量，查找类似 OPENAI_BASE_URL、OPENAI_API_KEY 的字段。若存在且调用路径含 /v1/chat/completions，则大概率已兼容——【腾讯混元API完全支持OpenAI兼容协议，无需修改请求体结构】。
若系统使用私有协议（如自定义 JSON 字段名、非标准 HTTP 方法或无 streaming 支持），则必须走 SDK 集成路径，跳过本阶段。
用TokenHub获取混元服务凭证
腾讯混元新能力已全部迁移至 TokenHub 平台，原控制台不再开通新服务。
访问 https://tokenhub.tencentcloud.com → 登录腾讯云账号 → 进入「模型服务」→ 选择「腾讯混元」→ 点击「开通服务」。
开通后，在「API密钥管理」页生成一对新密钥：SecretId 和 SecretKey。注意：旧控制台申请的密钥仍可继续使用，但【新购服务、新模型（如Hy4 preview、Hy-MT2-Pro）仅支持TokenHub发放的密钥】。
将新密钥存入系统安全配置中心，禁用明文硬编码。
两种接入方式任选其一
方法一：直连 OpenAI 兼容模式（推荐给轻量级系统）
将原 OpenAI 请求 URL 替换为：https://api.hunyuan.cloud.tencent.com/v1/
Header 中 Authorization 字段保持 Bearer {SecretKey} 格式不变；X-TC-Region 必须设为 ap-guangzhou（其他地域暂不支持混元全量模型）。
请求体中 Model 字段需明确指定，例如 "hunyuan-pro" 或 "hunyuan-standard"；不填或填错会导致 400 错误——【混元不接受空 Model 或通配符，必须精确匹配模型ID】。
方法二：集成腾讯云官方 Python SDK（适合需流式响应、错误重试、上下文管理的生产系统）
执行 pip install tencentcloud-sdk-python==3.0.1287（必须 ≥3.0.1287，低版本不支持 Hy4 preview）。
初始化客户端时传入 SecretId、SecretKey 和地域 ap-guangzhou，不要用默认地域。
构造 ChatCompletionsRequest 对象，Messages 列表格式与 OpenAI 完全一致，Role 只接受 system/user/assistant，填 assistant 会触发 400。
启用 Stream=True 后，SDK 自动处理 SSE 流解析，无需手动切分 data: 块——这步省掉你写解析器的时间。
