base_url必须严格匹配官方文档指定的域名,混元turbo、pro、lite对应不同url且末尾不加路径;python sdk需设环境变量hunyuan_base_url,requests手动请求时须与model强绑定拼接完整url。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

腾讯混元接入时 base_url 填写错误会导致请求直接 404 或返回“invalid endpoint”,必须严格匹配官方文档指定的接口域名,不能拼错、不能多斜杠、不能漏版本号。
确认当前使用的混元模型类型
先明确你调用的是 【混元 Turbo】、【混元 Pro】 还是 【混元 Lite】 —— 不同模型对应不同 base_url,混用会报错。
打开腾讯云「混元大模型控制台」→ 左侧导航栏点击「API 管理」→ 查看「服务地址」列显示的 URL,该地址即为你要填写的 base_url。
各模型对应的 base_url 格式
方法一:混元 Turbo(推荐用于生产高稳定性场景)
https://hunyuan.tencentcloudapi.com
方法二:混元 Pro(需单独申请开通权限)
https://hunyuanpro.tencentcloudapi.com
方法三:混元 Lite(轻量级,仅支持部分 API)
https://hunyanlite.tencentcloudapi.com
注意:所有地址末尾不加 /v1、不加 /chat/completions,也不带任何查询参数——base_url 只到域名层级,路径由 SDK 或请求代码中另行拼接。
在代码中正确配置 base_url
第一步:使用官方 Python SDK(tencentcloud-sdk-python-hunyuan)时,在初始化 client 前设置环境变量:os.environ["HUNYUAN_BASE_URL"] = "https://hunyuan.tencentcloudapi.com"
第二步:初始化 client 实例时,传入 region 和 profile:client = hunyuan_client.HunyuanClient(cred, "ap-guangzhou", client_profile)
SDK 内部会自动将 base_url 拼接到实际请求路径前,无需手动拼接完整 URL。
第三步:若使用 requests 手动构造请求,base_url 必须与 model 参数强绑定——例如调用 turbo 模型的 chat/completions 接口,最终请求 URL 是:
【https://hunyuan.tencentcloudapi.com/v1/chat/completions】
少一个字符或错一个字母都会触发腾讯云网关拦截。











