必须先在腾讯混元控制台开通服务并使用api explorer或tokenhub完成chatcompletions接口调用测试，验证密钥、权限及参数配置正确性，确保返回200状态码和非空content后方可正式接入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要在正式接入腾讯混元大模型前，先在控制台完成模型能力验证和基础调用测试，避免因密钥错误、服务未开通或参数配置偏差导致后续集成失败。
确认服务已开通并进入混元控制台
打开浏览器，访问 腾讯混元大模型控制台首页。若页面提示“请先开通服务”，说明尚未完成服务开通——必须点击“立即开通”并勾选协议提交，否则所有测试按钮均置灰不可用。【未开通服务时，API密钥即使存在也无法调用任何模型】
开通成功后，左侧导航栏会出现“在线调试”或“API Explorer”入口，这是唯一支持免代码实时验证的官方通道。
使用 API Explorer 进行模型调用测试
点击左侧菜单中的「API Explorer」→ 在搜索框输入「ChatCompletions」→ 选择接口「ChatCompletions（文本生成）」。
第一步：在「认证信息」区域，系统会自动读取你当前账号的 SecretId 和 SecretKey；若未显示，请先前往「访问管理 → API 密钥管理」创建一对新密钥，并刷新页面。
第二步：在「请求参数」中填写以下最小必要字段：
• Model：填 hunyuan-pro（不填默认值可能触发400错误）
• Messages：填 JSON 数组，例如 [{"role":"user","content":"你好"}]
• Temperature：可暂设为 0.7，便于观察输出多样性
第三步：点击右上角「发送请求」按钮。若返回 HTTP 状态码 200 且 response.body 中含 "choices" 字段与非空 content，说明模型调用链路完全通畅；若返回 401，检查密钥是否复制完整、是否被意外截断；若返回 403，确认该密钥所属子账号是否被主账号授予了 hunyuan 权限。
用 TokenHub 控制台快速验证 OpenAI 兼容接口
方法一：直接跳转测试页
访问 TokenHub 控制台 → 左侧点「API Key 管理」→ 找到你用于混元的 Key → 点右侧「在线调试」按钮。页面自动加载 /v1/chat/completions 接口，预填好 Authorization 和 base_url，只需修改 messages 内容即可发送。
方法二：手动构造 cURL（适合排查网络层问题）
在调试页底部点击「查看 cURL 命令」，复制命令粘贴到终端执行。注意：cURL 中的 API Key 是明文，【执行完立即删掉历史记录，防止密钥泄露】。
这一步操作起来很简单，直接把文件拖进去就行。
