混元生图（3.0）和多轮对话均仅支持异步接口，需先提交任务获取JobId，再轮询状态直至SUCCESS，最后通过ResultUrl下载图片（24小时内有效，需处理CORS）。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你需要批量生成图片或处理耗时较长的AI任务时，同步等待响应会严重拖慢整体流程，必须用异步请求把任务提交后立即返回任务ID，再轮询结果，才能真正提升吞吐量。
确认接口支持异步模式
混元生图（3.0）和混元生图（多轮对话）均只提供异步接口。同步接口仅存在于部分旧版能力中，当前主力生图服务已全面切换为异步架构。调用前请核对文档中接口域名是否为 aiart.tencentcloudapi.com 或 hunyuan.tencentcloudapi.com ——前者对应单次生图，后者对应多轮对话。
若误用同步方式调用，将直接返回 405 Method Not Allowed 错误，无法重试补救。
提交任务获取唯一JobId
使用 Python SDK 提交生图任务：
第一步：构造请求对象，指定 model、prompt、size 和 images（如需图生图）；
第二步：调用 SubmitHunyuanImageJob（单轮）或 SubmitHunyuanImageChatJob（多轮）方法；
第三步：从响应中提取 【JobId】 字段，这是后续查询结果的唯一凭证，丢失即无法追踪任务状态。
注意：同一 JobId 仅可查询一次结果，查询成功后该记录在服务端自动清除，不可重复拉取。
轮询任务状态直到完成
方法一：手动轮询（适合调试与低频任务）
每 2～3 秒调用一次 DescribeHunyuanImageJob 接口，传入 JobId；
检查返回字段 Status 是否为 SUCCESS；
若为 FAILED，读取 ErrorMessage 字段定位失败原因；
若为 RUNNING，继续等待；
若为 PENDING，说明任务尚未被调度，需耐心等待队列排期。
方法二：带退避策略的自动轮询（生产环境必需）
首次等待 1 秒 → 第二次等待 2 秒 → 第三次等待 4 秒 → 后续每次翻倍，上限设为 30 秒；
累计轮询超 10 分钟仍未完成，视为超时，主动终止并记录告警；
这能避免高频空轮询触发腾讯云 API 频率限制（默认 20 QPS），导致自身请求被限流。
解析最终图像结果
当 Status == "SUCCESS" 时，响应体中 ResultUrl 字段即为生成图片的直链地址；
该 URL 有效期为 24 小时，需在此期限内完成下载或转存；
【ResultUrl 不可直接渲染到网页 img 标签】，因腾讯云 COS 默认禁止跨域访问，需先通过代理服务或配置 CORS 规则，否则浏览器控制台报错“Blocked by CORS policy”；
下载时建议添加 User-Agent: hunyuan-batch-client 头，便于服务端识别流量来源。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
