腾讯混元chat接口base url必须为https://api.hunyuan.cloud.tencent.com/v1，末尾不可加/chat/completions或省略/v1；生图接口则需用https://api.cloudai.tencent.com且不带/v1，完整路径由代码显式指定。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
腾讯混元接入时服务地址必须完整包含 /v1 路径段，否则请求会直接返回 404 错误，无法进入模型调度流程。
Chat接口的Base URL写法
使用腾讯混元 Chat Completions 接口时，Base URL 必须为：https://api.hunyuan.cloud.tencent.com/v1。
这个地址末尾不能加 /chat/completions，也不能省略 /v1。SDK 或 OpenAI 兼容客户端会在内部自动拼接后续路径。
例如用 OpenAI Python SDK 时，只需传入 base_url="https://api.hunyuan.cloud.tencent.com/v1"，调用 client.chat.completions.create() 时会自动补全为 /v1/chat/completions。
生图接口的Base URL写法
方法一：使用混元生图专用地址
生图（AIART）接口不复用 Chat 的 base_url，必须单独使用：https://api.cloudai.tencent.com。
注意这里不带 /v1——因为生图接口的完整请求路径是 https://api.cloudai.tencent.com/v1/aiart/submit，/v1 是路径的一部分，但 base_url 只需到域名层级。
方法二：若用 OpenAI 兼容方式封装生图，需确保请求构造时显式指定完整 endpoint，不能依赖 base_url 自动追加。
常见错误排查顺序
第一步：确认你调用的是 Chat 还是 AIART 接口，二者 base_url 完全不同，不可混用。
第二步：Chat 类接口 → 检查 base_url 是否含 /v1 且不含 /chat/completions。
第三步：AIART 类接口 → 检查 base_url 是否为 https://api.cloudai.tencent.com，且代码中发起请求时明确使用 /v1/aiart/submit 或 /v1/aiart/query 路径。
第四步：用 curl 手动测试时，必须写出完整 URL，例如：curl https://api.hunyuan.cloud.tencent.com/v1/chat/completions —— 这里 /v1 是强制要求，缺一不可。
