图片和视频生成常常不能在一次短请求里完成。接口接通以后,还需要把任务生命周期接好,否则等待超时很容易变成重复生成。
提交与结果分开处理
多媒体统一接口的相关方向使用提交、查询与获取结果的流程;提交阶段返回任务标识。大体积参考素材的处理可能继续在后续阶段推进。
保存 task_id、提交时间、输入摘要和业务订单标识,不把“收到任务标识”当成已经生成成功。
处理中不等于失败
程序需要区分排队、处理中、成功和失败等返回状态,按照文档设置查询节奏与等待边界。不要每次没有结果就重新提交同一素材。
一次连接中断,也不能据此确定服务器没有收到任务。先查原 task_id;提交结果不明确时,先查已有记录再判断下一步。
成功以后检查真实结果
拿到结果信息后,确认文件能读取、媒体内容和规格符合任务,并保存到你的交付流程里。返回一条链接和真正可用的成品是两个验收步骤。
结果保存失败时,优先恢复下载或查询,而不是直接重做生成。
重试要留下原因
失败任务记录参数摘要、错误类型和重试动作。参数不支持应修正参数,任务仍运行应继续查询,结果取回失败应恢复取回。每次重试有明确对象,才容易控制返工和对账。
荟沣科技· AI 大模型聚合平台· 让AI回归工具
