腾讯混元 API 购买与接入教程（企业级开通指南）
从腾讯云开通、创建密钥到完成首次调用的精简流程
BLUF 摘要（点开查看）
这篇教程用 6 个步骤说明 腾讯混元 API 如何注册、开通、获取 API Key 并完成首次接入；先确认国内直连、免费额度、计费单位，再把 Key 安全保存到环境变量或工具配置中。
教程概览
注册账号并开通混元
先注册腾讯云账号并完成认证，然后在混元大模型控制台开通服务。
点击位置：浏览器访问 cloud.tencent.com → 注册/登录 → 混元大模型控制台 → 立即开通
完成后看到：控制台显示混元服务已开通，可看到模型列表和 API 入口
- 确认已完成腾讯云实名认证
- 如提示权限不足，检查账号是否为企业认证
- 访问腾讯云官网注册账号：cloud.tencent.com，国内用户按提示完成实名认证
- 登录后进入「混元大模型控制台」
- 阅读并同意服务条款，点击「立即开通」
创建并保存密钥
在 API 密钥页面创建访问凭证，保存 SecretId 和 SecretKey。
点击位置：控制台 → API 密钥页面 → 创建密钥
完成后看到：页面显示 SecretId 和 SecretKey，可复制
- 填写参数和昵称后才能生成密钥
- SecretKey 只显示一次，复制后立即保存
- 进入 API 密钥页面，点击创建密钥
- 填写参数和昵称后生成 SecretId / SecretKey
- 立即复制保存，后续代码调用需要用到
配置环境变量并首次调用
混元 API 兼容 OpenAI 接口，可用标准 OpenAI SDK 快速完成调用。
点击位置：终端运行 pip install openai，创建 .env 写入 TENCENT_SECRET_KEY
完成后看到：Python 脚本成功打印腾讯混元的自我介绍回复，无报错
- 确认 TENCENT_SECRET_KEY 环境变量已设置
- 检查 base_url 是否为
https://api.hunyuan.cloud.tencent.com/v1 - 如报错 401，检查密钥是否正确
- 将 SecretId / SecretKey 写入运行环境
- base_url 设置为 https://api.hunyuan.cloud.tencent.com/v1
- 先用 hunyuan-turbos-latest 做基础对话测试
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)按场景选择模型
混元提供轻量、通用、推理、多模态和翻译模型，按任务成本和能力选择即可。腾讯云已提示新能力会逐步迁移到 TokenHub，新项目要先确认入口。
点击位置：控制台 → 模型列表或文档页面
完成后看到：页面显示 hunyuan-lite、hunyuan-turbos-latest、hunyuan-t1-latest，或 TokenHub 推荐的新模型入口
- 确认模型名称拼写正确
- 首次测试建议用 hunyuan-turbos-latest
- hunyuan-lite：轻量快速，适合基础对话和低成本场景
- hunyuan-turbos-latest：主力通用模型，适合内容创作和代码生成；新模型请同步查看 TokenHub
- hunyuan-t1-latest：适合复杂推理、逻辑分析和代码调试
- hunyuan-vision / Hunyuan-MT-7B：分别面向多模态和翻译任务
开启流式输出与进阶调用
需要实时回复或复杂项目时，可开启 stream，并按需接入 LangChain。
点击位置：代码中设置 stream=True，或引入 LangChain 的 ChatHunyuan
完成后看到：实时逐字输出 AI 回复，或 LangChain 集成调用成功
- 确认 SDK 版本支持流式输出
- LangChain 集成需额外安装依赖
- 聊天类应用建议开启 stream，提升实时交互体验
- 复杂项目可使用 LangChain 的 ChatHunyuan
- PHP、Java 等语言也可通过腾讯云官方 SDK 调用
集成到应用框架
除了直接写代码，也可以把混元接入 Dify、LobeChat、HAI 等应用框架。
点击位置：LobeChat/Dify/HAI 的模型供应商设置中选择腾讯混元并填写 API Key
完成后看到：应用框架显示连接成功，可正常调用混元模型
- 确认 API Key 格式正确
- 检查网络是否可访问腾讯云 API 地址
- LobeChat：选择模型提供商为腾讯混元，填写 API Key 后检查连接
- Dify / HAI：在模型供应商中选择 Tencent Hunyuan 并配置密钥
- LangChain Embedding：设置密钥后使用社区集成生成向量
配置推荐：使用 CC Switch 接入 AI 工具
创建 API Key 后，建议用 CC Switch 统一填写 API Key、Base URL 和模型名称，再接入 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 等工具，避免手动修改配置文件出错。
使用提示
优先把密钥放到环境变量或 .env 文件中，避免硬编码泄露
内容生成可适当提高 temperature，代码生成建议使用较低 temperature
模型默认不启用联网搜索，如需搜索能力需按接口文档开启对应参数
新项目优先确认 TokenHub 是否已经成为推荐入口，避免接入即将停止新增能力的旧入口
注意事项
混元 API 通常为后付费模式，建议在费用中心开启预算或费用预警
批量调用前先小规模测试模型效果、延迟和成本
适合谁
- • 国内用户，想快速接入 AI API
- • 需要手把手指导完成注册、充值和获取 Key 的新手
- • 想把 腾讯混元 接入 Claude Code、Codex 等工具的用户
常见问题
腾讯混元 有免费额度吗？
有，新用户优惠。建议先用免费额度测试真实任务，确认满足需求后再充值。
注册 腾讯混元 需要什么？
手机号或邮箱即可注册，支持支付宝/微信充值。部分 API 需要实名认证。
API Key 泄露了怎么办？
立即到控制台删除泄露的 Key 并重新生成。建议把 Key 存在环境变量或 .env 文件中，不要提交到 Git 仓库。