混元系列是什么
腾讯的混元大模型家族，覆盖对话、推理与视觉生成等多条产品线，主要经腾讯云大模型接口对外提供服务，同时提供 OpenAI 兼容端点以降低存量代码的迁移成本；另有面向微信生态与腾讯云知识引擎的集成能力。选型时要特别留意两套接口的差异：模型标识、签名方式、参数支持范围与计费口径并不完全一致。
基本信息
| 厂商 | 腾讯，产品线覆盖对话、推理与视觉生成 |
|---|---|
| 代表型号 | 对话类如 Turbo 系列，推理类如 T1 系列，具体名称以官方模型列表为准 |
| 原生接入 | 腾讯云大模型接口，请求需 TC3-HMAC-SHA256 签名，建议使用官方 SDK |
| 兼容接入 | OpenAI 兼容端点，用 Bearer 鉴权，便于从既有代码迁移 |
| 生态集成 | 腾讯云知识引擎、微信生态相关集成能力 |
| 计费方式 | 文本按输入输出 token 计费，图像与视频生成按张数或时长，以官网为准 |
典型使用场景
- 数据不出境要求下的国内合规部署，业务本身已在腾讯云上时可就近接入
- 需要与微信生态打通的产品，例如公众号、小程序内的智能问答
- 长文摘要与文档问答，选用支持长上下文的对话型号
- 复杂推理与数学类任务，切换到推理型号并接受更长的思考耗时
- 存量使用 OpenAI SDK 的项目快速试接，先走兼容端点降低改造成本
兼容端点调用
兼容端点调用
# 兼容端点走 Bearer 鉴权，调用形态与 OpenAI 接口基本一致
curl -s https://api.hunyuan.cloud.tencent.com/v1/chat/completions \
-H "Authorization: Bearer $HUNYUAN_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "hunyuan-turbo-latest",
"messages": [{"role": "user", "content": "你好"}],
"stream": false
}'
# 模型标识随版本与地区变化，上线前用官方模型列表核对
# 长文本与推理场景要换对应型号，兼容端点的参数支持范围可能小于原生接口接入方式对比
| 方式 | 适用情况 | 注意点 |
|---|---|---|
| 原生接口 | 需要完整能力与细粒度参数 | TC3 签名手写易错，优先用官方 SDK |
| OpenAI 兼容端点 | 存量代码快速迁移与验证 | 模型标识与参数支持可能是子集 |
| 知识引擎 | 需要托管式检索问答能力 | 与自建 RAG 的分工要提前划清 |
| 私有化部署 | 数据与合规要求更严格 | 需走商务沟通，交付周期较长 |
腾讯云原生接口使用 TC3-HMAC-SHA256 签名，手写实现出错后报错信息通常很含糊，排错成本高，优先使用官方 SDK 或官方示例代码。
兼容端点与原生接口的模型标识不是同一套命名：从兼容端点切到原生接口时，模型名字与计费口径都要重新核对，别直接照搬配置。