腾讯混元api key可调用hunyuan-a13b、hunyuan-pro、hunyuan-translation、hunyuan-translation-lite、hunyuan-role-latest及hy3-preview等模型，需匹配正确base_url与model参数，否则返回400/404错误。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
你需要知道腾讯混元 API Key 能调用哪些模型，才能在开发中精准选型、避免请求失败或计费异常——API Key 本身不绑定具体模型，但必须配合正确的模型 ID 和兼容的 endpoint 才能生效，填错模型名会直接返回 404 或 400 错误。
混元官方原生支持的模型
你的混元 API Key 可直接调用腾讯云控制台已开通服务的全部混元系列模型，前提是模型已在账号下启用且未被禁用。当前（2026年9月）稳定可用的核心模型包括：
• 【hunyuan-a13b】：通用主力模型，80B总参/13B激活，支持快慢思考切换（加 /no_think 指令），最大输入224k token；
• 【hunyuan-pro】：上一代高性能通用模型，适合高精度长文本生成；
• 【hunyuan-translation】：33语种+5民族语互译专用模型，WMT25全语种第一；
• 【hunyuan-translation-lite】：轻量翻译模型，响应更快，适合移动端或低延迟场景；
• 【hunyuan-role-latest】：角色扮演专项模型，支持深度人设记忆与多轮情感一致性；
👁️ 使用 MiniMax VL API 进行图像分析：描述图像、提取截屏文字、分析照片。需 MiniMax Token Plan API 密钥（免费套餐可用）。
• 【hy3-preview】：2026年4月发布的最新旗舰，295B总参/21B激活，原生支持256K上下文、Function Calling 与 Cache 缓存，调用参数为 hy3-preview。
通过 TokenHub 平台间接调用的模型
如果你的 API Key 是在 TokenHub 平台申请的（非混元独立控制台），那么该 Key 具备跨厂商调用能力，可一键访问以下已上架的国产旗舰模型：
方法一：TokenHub 统一接入
• 混元 Hy3 preview（同上）
• DeepSeek-V4-Pro / DeepSeek-V4-Flash
• GLM-5.1
• Kimi-K2.6
• MiniMax-M2.7
注意：这些模型虽共用同一 API Key，但调用时必须将 model 参数显式指定为对应 ID（如 deepseek-v4-pro），不能复用混元的 hunyuan-* 命名。
调用前必须确认的三件事
第一步：登录 混元控制台 → 进入「模型服务」→ 查看已开通模型列表，灰色禁用状态的模型无法调用；
第二步：检查你使用的 SDK 或客户端是否配置了正确的 base_url —— 混元专属地址为 https://api.hunyuan.cloud.tencent.com/v1，TokenHub 地址则为 https://api.tokenhub.tencent.com/v1；
第三步：在请求 payload 中明确填写 model 字段，例如：
{"model": "hunyuan-a13b", "messages": [...]}。【不填 model 或填错大小写（如 HUNYUAN-A13B）将导致 400 报错】
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
