帮你快速理解、总结文档立即下载

第三方软件集成混元指南

最近更新时间:2026-08-25 18:24:30
本文档已由 AI 辅助审校
我的收藏
注意:
为进一步提升大模型服务体验,腾讯混元大模型相关功能将逐步迁移至 TokenHub。迁移后,原平台将不再新增模型能力,并停止支持新购模型服务。用户已购买的模型服务可继续使用,暂不受影响。如需开通新的模型服务或使用更多模型能力,请前往 TokenHub。
本文提供了腾讯云大模型 API 中的混元大模型在不同场景下的第三方教程,您可参考教程进行相关实践操作。

CherryStudio

CherryStudio 是一款集多模型对话、知识库管理、AI 绘画、翻译等功能于一体的全能 AI 助手平台。

下载和安装

下载并安装 CherryStudio 客户端。详细可参见 官方文档 。

申请混元 API 密钥

注意: API KEY 是腾讯云混元大模型 API 请求时的安全鉴权凭证。为了您的财产和服务安全,请妥善保存 API KEY ,请勿通过任何方式上传或者公开分享您的密钥信息。相关文档可参见 API Key 管理 。

配置混元 API 密钥

1. 点击客户端左下角的设置。
2. 在模型服务中搜索并单击腾讯混元。
3. 在右侧表单框填入 API 密钥和 API 地址 https://api.hunyuan.cloud.tencent.com/v1/,详细如下图所示:



4. 点击检查如果弹出连接成功即可使用 CherryStudio 集成混元大模型。

添加其他模型

CherryStudio 默认的模型不完全,用户可手动添加混元的其他模型。
1. 在配置 API 密钥的页面 下滑 单击添加。
2. 填写表单。模型 ID 与混元支持的模型列表保持一致、模型名称会自动填写、分组名称填写 Hunyuan 即可。 混元的模型列表请参见 产品描述 。
3. 填写完成后点击添加模型。




调用混元大模型

配置完毕后点击左侧标签页中的助手,切换模型为混元即可调用。




OpenWebUI

Open WebUI 是一个可扩展、功能丰富且用户友好的自托管 AI 平台,旨在完全离线运行。它支持各种 LLM 运行器(如 Ollama)和与 OpenAI 兼容的 API,并内置 RAG 推理引擎,使其成为强大的 AI 部署解决方案。

下载和安装

申请混元 API 密钥

同 CherryStudio 的申请流程,可参见 API Key 管理 。

配置混元 API 密钥

1. 打开 WebUI 后, 单击左下角用户头像,点击设置。
2. 点击左侧标签页中的 外部链接。 点击右侧加号,在弹出的表单中填写相关信息。
3. URL 填写 https://api.hunyuan.cloud.tencent.com/v1/ 密钥填写申请的混元 API 密钥。其余输入框留空即可,单击保存。




调用混元大模型

配置完毕后点击左侧标签页中的新对话,切换模型为混元即可调用。




Dify

Dify 是一款开源的大语言模型(LLM) 应用开发平台。它融合了后端即服务(Backend as Service)和 LLMOps 的理念,使开发者可以快速搭建生产级的生成式 AI 应用。即使您是非技术人员,也能参与到 AI 应用的定义和数据运营过程中。
Dify 集成混元有两种方式:SDK 接入和 OpenAI 兼容接口接入。OpenAI 兼容接口录入模型较为繁琐,推荐使用 SDK 接入。选择一种接入方式即可。

下载和安装

申请腾讯云 AKSK(SDK 接入)

相关文档可参见 云 API。
注意:
您的 API 密钥代表您的账号身份和所拥有的权限,使用腾讯云 API 可以操作您名下的所有腾讯云资源。为了您的财产和服务安全,请妥善保存和定期更换密钥,请勿通过任何方式(如 GitHub)上传或者分享您的密钥信息。

配置腾讯云 AKSK

1. 打开 Dify 后,点击右上角用户头像,点击设置。
2. 选择左侧模型供应商,下滑找到 Tencent Hunyuan,点击设置。
3. 在弹出的表单中填写 Secret ID、Secret Key 并单击保存。







申请混元 API 密钥(OpenAI 兼容接口接入)

同 CherryStudio 的申请流程,可参见 API Key 管理 。

配置混元 API 密钥

1. 打开 Dify 后,点击右上角用户头像,点击设置。
2. 选择左侧模型供应商,下滑找到 OpenAI-API-compatible,点击添加模型。
3. API endpoint URL 填写 https://api.hunyuan.cloud.tencent.com/v1/API Key 填写申请的混元 API 密钥。模型填写混元支持的模型,例如 hunyuan-turbo 混元的模型列表请参见 产品描述 。



在弹出的表单中填写相关信息:




调用混元大模型

配置完毕后点击主页中的创建空白应用,切换混元大模型即可调用。



调整模型及参数。




Chatbox

Chatbox 是一款开源 AI 客户端应用和智能助手,支持在 Windows、macOS、Android、iOS、Linux 和网页版上使用。可以选择使用混元 API Key 连接到需要的模型。

下载和安装

申请混元 API 密钥

同 CherryStudio 的申请流程,可参见 API Key 管理 。

配置混元 API 密钥

1. 打开 Chatbox 后, 点击 Chatbox 页面左下方的设置,点击模型提供方,点击底部的添加。
2. 在弹窗中填写名称,API 模式选择 OpenAI API 兼容,点击添加。
3. URL 填写 https://api.hunyuan.cloud.tencent.com/v1/ 密钥填写申请的混元 API 密钥。其余输入框留空即可,单击保存。




调用混元大模型

配置完毕后点击左侧标签页中的新对话,切换模型为 Hy3 即可调用。