必须依据接口返回的status字段判断任务是否完成,status为done或fail时终止轮询;done时取resultfile3ds或resultimage等结果字段,fail时需同时读取errorcode和errormessage;轮询间隔3~5秒,最大重试≤120次或总耗时≤90分钟。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要确认腾讯混元智能体提交的任务是否真正完成,不能只看界面有没有返回图片或文件,必须依据接口返回的结构化状态字段做判断,否则可能误将“执行中”当作“已完成”而提前取结果导致失败。
查任务状态:用QueryHunyuanTo3DJob或类似查询接口
调用对应任务类型的查询接口(如3D生成用QueryHunyuanTo3DJob,生图用DescribeHunyuanImageJob),传入当初提交任务时获得的JobId。
接口响应体中必须检查Status字段值,这是唯一权威标识。
当Status为【DONE】或【FAIL】时,表示任务生命周期终结,可停止轮询;其余值(WAIT/RUN)均代表尚未完成,需继续查询。
区分完成与失败:看Status+配套字段组合
方法一:Status == DONE → 任务成功完成
此时响应中必含ResultFile3Ds(3D类)或ResultImage(生图类)等结果载体字段,直接按字段路径取值即可。
方法二:Status == FAIL → 任务明确失败
必须读取ErrorCode和ErrorMessage,二者缺一不可。仅看ErrorCode容易漏掉关键上下文,比如同是InvalidParameter,可能是提示词违规,也可能是模型不支持该分辨率。
注意:Status为RUN时,哪怕已过去10分钟,也不能默认它快好了——有些长周期任务(如复杂3D网格生成)可能持续运行40分钟以上,必须严格以Status为准。
自动轮询策略:避免超时或空转
第一步:首次提交后立即调用一次查询接口,获取初始Status。
第二步:若Status为WAIT或RUN,则进入轮询循环,建议间隔时间为【3~5秒】,过短会触发限流,过长则拉长整体等待时间。
第三步:设置最大重试次数(推荐≤120次)或总耗时上限(如≤90分钟),一旦达到即终止并报“任务超时”,防止无限等待。这一步不可省略,【Long-Horizon-Terminal-Bench测试表明79%的失败源于超时】。
第四步:每次轮询后都重新解析Status,仅当值变为DONE或FAIL时退出循环并处理结果。











