腾讯混元 API 购买与接入教程
从腾讯云开通、创建密钥到完成首次调用的精简流程
✓ 国内直连✓ 腾讯云生态✓ OpenAI 兼容接口✓ 多模型选择✓ 适合企业集成
1
注册账号并开通混元
先注册腾讯云账号并完成认证，然后在混元大模型控制台开通服务。
- 访问腾讯云官网注册账号，国内用户按提示完成实名认证
- 登录后进入「混元大模型控制台」
- 阅读并同意服务条款，点击「立即开通」
2
创建并保存密钥
在 API 密钥页面创建访问凭证，保存 SecretId 和 SecretKey。
- 进入 API 密钥页面，点击创建密钥
- 填写参数和昵称后生成 SecretId / SecretKey
- 立即复制保存，后续代码调用需要用到
⚠ SecretKey 只应保存在本地环境变量或服务端配置中，不要提交到公开仓库。
3
配置环境变量并首次调用
混元 API 兼容 OpenAI 接口，可用标准 OpenAI SDK 快速完成调用。
- 将 SecretId / SecretKey 写入运行环境
- base_url 设置为 https://api.hunyuan.cloud.tencent.com/v1
- 先用 hunyuan-turbos-latest 做基础对话测试
python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("TENCENT_SECRET_KEY"),
base_url="https://api.hunyuan.cloud.tencent.com/v1",
)
completion = client.chat.completions.create(
model="hunyuan-turbos-latest",
messages=[{"role": "user", "content": "你好，请介绍一下腾讯混元"}],
)
print(completion.choices[0].message.content)4
按场景选择模型
混元提供轻量、通用、推理、多模态和翻译模型，按任务成本和能力选择即可。
- hunyuan-lite：轻量快速，适合基础对话和低成本场景
- hunyuan-turbos-latest：主力通用模型，适合内容创作和代码生成
- hunyuan-t1-latest：适合复杂推理、逻辑分析和代码调试
- hunyuan-vision / Hunyuan-MT-7B：分别面向多模态和翻译任务
⚠ 免费额度、后付费规则和模型价格可能调整，正式使用前以腾讯云控制台为准。
5
开启流式输出与进阶调用
需要实时回复或复杂项目时，可开启 stream，并按需接入 LangChain。
- 聊天类应用建议开启 stream，提升实时交互体验
- 复杂项目可使用 LangChain 的 ChatHunyuan
- PHP、Java 等语言也可通过腾讯云官方 SDK 调用
6
集成到应用框架
除了直接写代码，也可以把混元接入 Dify、LobeChat、HAI 等应用框架。
- LobeChat：选择模型提供商为腾讯混元，填写 API Key 后检查连接
- Dify / HAI：在模型供应商中选择 Tencent Hunyuan 并配置密钥
- LangChain Embedding：设置密钥后使用社区集成生成向量
使用提示
优先把密钥放到环境变量或 .env 文件中，避免硬编码泄露
内容生成可适当提高 temperature，代码生成建议使用较低 temperature
模型默认不启用联网搜索，如需搜索能力需按接口文档开启对应参数
注意事项
混元 API 通常为后付费模式，建议在费用中心开启预算或费用预警
批量调用前先小规模测试模型效果、延迟和成本