快速结论（点开查看）
功能特性
Hy3 旗舰TokenHub 入口企业集成微信生态
是否适合你使用
适合初学者、个人开发者、国内项目快速接入和低门槛试用。
如果你正在比较 腾讯混元 API 怎么买、价格是否合适、能不能国内访问，建议先查看购买教程，再用免费额度或小额充值跑通一个真实任务。
接入前确认
- 官网入口和控制台地址
- API Key 创建与保存方式
- Base URL、模型名和 SDK 兼容性
- 免费额度、限速和计费单位
购买教程
腾讯混元 API 购买与接入教程（企业级开通指南）
从腾讯云开通、创建密钥到完成首次调用的精简流程
1
注册账号并开通混元
先注册腾讯云账号并完成认证，然后在 TokenHub（腾讯混元新能力入口）开通服务。
- 访问腾讯云官网注册账号：https://cloud.tencent.com，国内用户按提示完成实名认证
- 登录后进入 TokenHub 控制台：https://console.cloud.tencent.com/tokenhub/models
- 阅读并同意服务条款，点击「立即开通」
2
创建并保存密钥重要
在 API 密钥页面创建访问凭证，保存 SecretId 和 SecretKey。
- 进入 API 密钥页面，点击创建密钥
- 填写参数和昵称后生成 SecretId / SecretKey
- 立即复制保存，后续代码调用需要用到
SecretKey 只应保存在本地环境变量或服务端配置中，不要提交到公开仓库。
3
配置环境变量并首次调用
混元新能力已迁移到 TokenHub，接口兼容 OpenAI，可用标准 OpenAI SDK 快速完成调用。
- 将 TokenHub 的 API Key 写入运行环境
- base_url 设置为 https://tokenhub.tencentmaas.com/v1
- 先用 hy3 做基础对话测试
python
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ.get("TENCENT_SECRET_KEY"),
base_url="https://tokenhub.tencentmaas.com/v1",
)
completion = client.chat.completions.create(
model="hy3",
messages=[{"role": "user", "content": "你好，请介绍一下腾讯混元"}],
)
print(completion.choices[0].message.content)使用 OpenAI SDK 调用腾讯混元 API，让模型自我介绍并打印回复。成功执行即代表 SecretKey 和 base_url 配置正确。
4
按场景选择模型
旧版混元模型（hunyuan-lite、hunyuan-turbos、hunyuan-t1 等）已于 2026-06-22 下线，新能力统一在 TokenHub 提供，按任务成本和能力选择即可。
- hy3：最新旗舰语言模型，256K 上下文，输入 ¥1/百万、输出 ¥4/百万（缓存命中 ¥0.25），适合通用对话、内容创作和代码生成
- hy3-preview：Hy3 预览版，多数旧模型的下线替代入口
- hy-vision-2.0-instruct：多模态理解最新版，面向图像理解任务
- hy-mt2-pro / plus / lite：智能翻译第二代，替代旧翻译模型（开源侧为 Hy-MT2-7B）
免费额度、后付费规则、模型价格和 TokenHub 入口可能调整；混元大模型平台将于 2026-09-30 停服，正式使用前以 TokenHub 控制台为准。
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
- • 模型默认不启用联网搜索，如需搜索能力需按接口文档开启对应参数
- • 新项目直接接入 TokenHub（OpenAI 兼容 base_url https://tokenhub.tencentmaas.com/v1），旧混元大模型平台将于 2026-09-30 停服，不要接入旧入口
注意事项
- • 混元 API 通常为后付费模式，建议在费用中心开启预算或费用预警
- • 批量调用前先小规模测试模型效果、延迟和成本
国内直连腾讯云生态OpenAI 兼容接口多模型选择适合企业集成
相关 API 推荐
适用场景
常见问题
腾讯混元 API 国内可以访问吗？
腾讯混元 API 更适合国内用户优先尝试，通常可以直接访问。正式接入前仍建议用免费额度或小额充值跑通真实任务。
腾讯混元 API Key 在哪里创建？
进入 腾讯混元 控制台后，在 API Key、密钥管理或开发者设置页面创建密钥。可以继续查看本站的 腾讯混元 购买教程，按步骤完成创建与保存。
腾讯混元 API 适合什么场景？
腾讯混元 适合的方向包括：Hy3 旗舰、TokenHub 入口、企业集成、微信生态。如果你还不确定具体选择，可以先查看场景推荐页，再回到该 API 详情页确认接入条件。
接入 腾讯混元 API 前要确认什么？
至少确认官网入口、免费额度或计费规则、Base URL、模型名、API Key 保存方式和限速规则。不要把 API Key 写入前端代码、公开仓库或截图。