必须先提交生图任务获取jobid才能轮询结果或进行多轮对话；需在cam中创建并保存secretid/secretkey，开通tokenhub混元服务，严格匹配接口域名，通过api explorer、python sdk或手动http请求提交任务，返回200且含非空jobid方可后续操作。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要在腾讯云上调用混元大模型生成图像，必须先提交一个生图任务，获取唯一任务ID，后续才能轮询结果或发起多轮对话。这一步漏掉就根本拿不到图，所有调用都会返回空响应。
准备密钥与环境
登录腾讯云控制台 → 进入【访问管理 CAM】→ 【API密钥管理】→ 创建新的密钥对，务必当场复制并安全保存 【SecretId 和 SecretKey】，SecretKey 仅显示一次，丢失后只能新建密钥。
确认已开通混元生图服务：进入 TokenHub 调用页（非旧控制台），阅读并勾选服务条款后点击“立即开通”。未开通会导致调用直接报错 AuthFailure.UnauthorizedOperation。
接口域名需严格匹配：混元生图(3.0)用 aiart.tencentcloudapi.com；混元生图(多轮对话)用 hunyuan.tencentcloudapi.com。填错域名会返回 InvalidEndpoint 错误，且不提示具体原因。
构造并发送提交请求
方法一：使用 API Explorer 在线调试（推荐新手）
打开 API Explorer → 搜索“SubmitHunyuanImageChatJob”或“SubmitHunyuanImageJob” → 选择对应产品 → 填写 Region 为 ap-guangzhou → 输入 Prompt（中文，≤1024 UTF-8 字符）→ 粘贴 SecretId/SecretKey → 点击【发起请求】。
方法二：用 Python SDK 提交（适合集成）
安装 tencentcloud-sdk-python：pip install tencentcloud-sdk-python
初始化 client 时指定 region=“ap-guangzhou”，service_type=“aiart” 或 “hunyuan”；调用 submit_hunyuan_image_job() 或 submit_hunyuan_image_chat_job()，传入 Prompt 字符串和可选的 ChatId（多轮对话时必填上一轮返回的 ID）。
方法三：手动拼接 HTTP POST 请求
请求地址：https://aiart.tencentcloudapi.com（3.0）或 https://hunyuan.tencentcloudapi.com（多轮）
Header 必须含 X-TC-Action、X-TC-Version（3.0 用 2024-07-01，多轮用 2023-09-01）、X-TC-Region（固定 ap-guangzhou）、X-TC-SecretId、X-TC-Timestamp（当前 Unix 时间戳）、X-TC-Signature（需按签名算法生成）
Body 为 JSON，至少含 Action、Version、Region、Prompt 四个字段。
验证返回结果
第一步：检查 HTTP 状态码是否为 200。不是则说明网络、鉴权或参数格式出错，不要继续下一步。
第二步：解析 JSON 响应体，确认存在 JobId 字段且值为非空字符串。这是后续轮询的唯一凭证，【务必立即保存，服务器不存储该 ID 的映射关系】。
第三步：若返回中含 ChatId（仅多轮接口），说明已成功开启或续接对话组，下次调用 SubmitHunyuanImageChatJob 时必须带上它，否则视为全新对话，历史图像上下文丢失。
