快速结论（点开查看）
功能特性
TokenHub迁移多模态企业集成微信生态
是否适合你使用
适合初学者、个人开发者、国内项目快速接入和低门槛试用。
如果你正在比较 腾讯混元 API 怎么买、价格是否合适、能不能国内访问，建议先查看购买教程，再用免费额度或小额充值跑通一个真实任务。
接入前确认
- 官网入口和控制台地址
- API Key 创建与保存方式
- Base URL、模型名和 SDK 兼容性
- 免费额度、限速和计费单位
购买教程
腾讯混元 API 购买与接入教程（企业级开通指南）
从腾讯云开通、创建密钥到完成首次调用的精简流程
1
注册账号并开通混元
先注册腾讯云账号并完成认证，然后在混元大模型控制台开通服务。
- 访问腾讯云官网注册账号：https://cloud.tencent.com，国内用户按提示完成实名认证
- 登录后进入「混元大模型控制台」
- 阅读并同意服务条款，点击「立即开通」
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)使用 OpenAI SDK 调用腾讯混元 API，让模型自我介绍并打印回复。成功执行即代表 SecretKey 和 base_url 配置正确。
4
按场景选择模型
混元提供轻量、通用、推理、多模态和翻译模型，按任务成本和能力选择即可。腾讯云已提示新能力会逐步迁移到 TokenHub，新项目要先确认入口。
- hunyuan-lite：轻量快速，适合基础对话和低成本场景
- hunyuan-turbos-latest：主力通用模型，适合内容创作和代码生成；新模型请同步查看 TokenHub
- hunyuan-t1-latest：适合复杂推理、逻辑分析和代码调试
- hunyuan-vision / Hunyuan-MT-7B：分别面向多模态和翻译任务
免费额度、后付费规则、模型价格和 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 是否已经成为推荐入口，避免接入即将停止新增能力的旧入口
注意事项
- • 混元 API 通常为后付费模式，建议在费用中心开启预算或费用预警
- • 批量调用前先小规模测试模型效果、延迟和成本
国内直连腾讯云生态OpenAI 兼容接口多模型选择适合企业集成
相关 API 推荐
适用场景
常见问题
腾讯混元 API 国内可以访问吗？
腾讯混元 API 更适合国内用户优先尝试，通常可以直接访问。正式接入前仍建议用免费额度或小额充值跑通真实任务。
腾讯混元 API Key 在哪里创建？
进入 腾讯混元 控制台后，在 API Key、密钥管理或开发者设置页面创建密钥。可以继续查看本站的 腾讯混元 购买教程，按步骤完成创建与保存。
腾讯混元 API 适合什么场景？
腾讯混元 适合的方向包括：TokenHub迁移、多模态、企业集成、微信生态。如果你还不确定具体选择，可以先查看场景推荐页，再回到该 API 详情页确认接入条件。
接入 腾讯混元 API 前要确认什么？
至少确认官网入口、免费额度或计费规则、Base URL、模型名、API Key 保存方式和限速规则。不要把 API Key 写入前端代码、公开仓库或截图。