必须主动轮询QueryHunyuanImageJob接口获取生图结果,依据JobId查状态:1/2需等待重试,4为失败需查错误码,5为成功则提取ResultImage中1小时内有效的图片URL。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

你需要通过腾讯混元文生图API查询已提交任务的生成结果,而不是等待系统自动推送——因为所有生图任务均为异步执行,必须主动用任务ID轮询状态才能拿到图片URL。
获取任务ID
确认你已在上一步调用 SubmitHunyuanImageJob 接口成功提交任务,并完整记录返回的 【JobId】 字符串。这个ID是唯一凭证,丢失后无法追溯任务,也查不到结果。
JobId 示例:251197749-1731412663-d4e1f224-fa21-40bc-9ee7-4bb13abece6e-0(注意含连字符和末尾短横)
调用QueryHunyuanImageJob接口查询
方法一:使用 API Explorer 在线调试(推荐新手)
打开 API Explorer 页面 → 选择地域为 ap-guangzhou → 在参数栏粘贴你的 JobId → 点击【发起调用】。
方法二:用 curl 命令行直连(适合自动化脚本)
执行以下命令(请将 YOUR_SECRET_ID、YOUR_SECRET_KEY 和 JOB_ID 替换为真实值):curl -X POST "https://hunyuan.tencentcloudapi.com/" -H "Authorization: <strong>【此处需用TC3-HMAC-SHA256签名,不可明文传密钥】</strong>" -H "Content-Type: application/json" -d '{"Action":"QueryHunyuanImageJob","Version":"2023-09-01","Region":"ap-guangzhou","JobId":"JOB_ID"}'
注意:签名必须用腾讯云 SecretKey 计算,明文暴露密钥会导致账号被盗,切勿在日志或共享环境打印完整请求体。
解析返回结果
第一步:检查 JobStatusCode 字段值
① 若为 1(等待中)或 2(运行中)→ 需等待至少2秒后重试查询,不可高频轮询(默认限频20次/秒);
② 若为 4(处理失败)→ 查看 JobErrorCode 和 JobErrorMsg 定位原因,常见如提示词违规、资源超时;
③ 若为 5(处理完成)→ 进入第二步。
第二步:提取 ResultImage 数组中的 URL
该字段是字符串数组,即使只生成1张图也以 ["https://..."] 形式返回;URL 有效期仅1小时,必须在此期限内下载或转存,过期链接将返回403错误。


















