必须正确配置OpenAI兼容API：API域名填https://api.hunyuan.cloud.tencent.com（末尾无斜杠），模型ID须与官方列表完全一致（如hunyuan-pro），密钥仅显示一次需立即复制保存，填错将导致404或model not found错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在 Chatbox 中稳定调用腾讯混元大模型，必须正确配置 OpenAI 兼容 API 接入方式，因为 Chatbox 不原生支持混元私有协议，仅通过模拟 OpenAI 的 /v1/chat/completions 接口才能通信成功；填错域名或模型 ID 将直接导致“404 Not Found”或“model not found”错误，且无明确提示。
获取混元 API 密钥
登录腾讯云控制台 → 进入 混元大模型服务页 → 左侧导航栏点击「API 密钥管理」→ 若无可用密钥，点击「创建密钥」→ 创建后立即复制密钥字符串（【该密钥仅显示一次，关闭页面即不可再查】）→ 建议粘贴到本地记事本暂存，切勿截图上传或发群。
配置 Chatbox 使用混元模型
打开已安装的 Chatbox 客户端 → 点击右下角「设置」图标 → 在「模型提供方」选项卡中点击「添加自定义提供方」→ 按以下字段填写：
① 提供方名称：填“Tencent Hunyuan”（仅作标识，可任意）
② API 密钥：粘贴上一步复制的密钥
③ API 域名：【https://api.hunyuan.cloud.tencent.com】（注意末尾无斜杠，错写成 hunyuan.tencentcloud.com 或少一个 u 都会连接失败）
④ 模型：填具体模型 ID，例如 hunyuan-pro、hunyuan-standard 或 hunyuan-turbo（必须与混元官方模型列表完全一致，大小写敏感）
⑤ API 路径：留空或填 /v1/chat/completions（Chatbox 会自动补全，但显式填写可避免低版本兼容问题）
点击「保存」→ 返回设置页，确认新提供方状态显示为「已连接」。
验证与切换模型
回到 Chatbox 主界面 → 点击左上角「新建对话」→ 在模型选择下拉框中找到你刚命名的提供方（如“Tencent Hunyuan”）→ 展开后应可见你填写的模型名（如 hunyuan-pro）→ 选中它 → 输入“你好”，发送。
若 3 秒内返回结构化 JSON 响应并正常输出文字，说明接入成功；若卡住超 10 秒或弹出「Request failed」，请检查：API 域名是否多写了 v1、密钥是否含空格、模型 ID 是否拼错（例如把 hunyuan-turbo 写成 hunyuan-tubo）。
