查询任务结果
查询任务状态并获取生成的海报图片。
任务成功后,响应中包含以下字段:
Q:创意海报生成需要多长时间?
A:生成时间一般为 20~60 秒,受排队情况影响可能有所延迟。建议以 5 秒为间隔轮询查询接口,避免频繁请求。
Q:
轮询策略
- 通过生成海报接口提交任务,获取
task_id。 - 每 5 秒轮询一次,直到
task_status为SUCCEEDED或FAILED。 - 任务成功后,从响应中获取海报图片。
响应字段说明
任务成功后,响应中包含以下字段:
| 字段 | 说明 |
|---|---|
render_urls | 渲染后的海报图片 URL 列表 |
bg_urls | 背景图片 URL 列表 |
auxiliary_parameters | 辅助参数列表,用于 sr 或 hrf 模式的二次生成 |
注意事项
- URL 有效期:生成的图片 URL 有效期为 24 小时,请及时下载。
- 任务状态流转:
PENDING→RUNNING→SUCCEEDED、FAILED或SUSPENDED。 - 任务 ID 有效期:
task_id有效期为 24 小时,过期后无法查询状态和结果。 - 避免重复提交:请通过轮询获取结果,不要重复提交请求。
错误码
| HTTP 状态码 | 错误码 | 错误信息 | 含义 |
|---|---|---|---|
| 400 | InvalidParameter | check input data style | 输入参数不满足入参要求 |
| 500 | InternalError | inference error | 算法内部错误 |
常见问题
Q:创意海报生成需要多长时间?
A:生成时间一般为 20~60 秒,受排队情况影响可能有所延迟。建议以 5 秒为间隔轮询查询接口,避免频繁请求。
Q:render_urls 和 bg_urls 有什么区别?
A:render_urls 是包含文字排版的完整海报图片;bg_urls 是不含文字的背景图片,可用于后续二次编辑。