静觅
·
Maestro 任务查询 API
内容提要
本文介绍了Maestro任务查询API的使用方法，包括如何通过POST请求查询视频任务的状态与结果。支持轮询查询，建议每5-10秒进行一次，以获取实时进度。返回的数据包含任务状态、请求参数和响应结果。
关键要点
-
使用 POST 请求查询视频任务的状态与结果，API 地址为 https://api.acedata.cloud/maestro/tasks。
-
支持轮询查询，建议每 5-10 秒进行一次，以获取实时进度。
-
返回的数据包含任务状态、请求参数和响应结果，状态包括 pending、planning、producing、succeeded 和 failed。
-
可以通过 action 字段选择查询单个任务或历史任务列表，单个任务使用 retrieve，历史任务使用 retrieve_batch。
-
查询历史任务时，可以设置返回条数 limit，最大为 100，支持按时间戳过滤任务。
延伸解读
API 查询的灵活性
Maestro任务查询API提供了灵活的查询选项，用户可以选择查询单个任务或历史任务列表。通过设置不同的action字段，用户能够根据需求获取实时进度或历史记录，这对于管理多个视频任务非常有帮助。
轮询查询的最佳实践
建议每5-10秒进行一次轮询查询，以获取任务的实时状态。这种频率可以确保用户及时了解任务进展，避免因长时间等待而错过重要信息。合理的轮询间隔可以提高效率，减少不必要的请求。
任务状态的解读
任务状态包括pending、planning、producing、succeeded和failed。了解这些状态的含义可以帮助用户更好地判断任务的执行情况，及时采取措施应对失败的任务，确保项目的顺利进行。
延伸问答
如何使用Maestro任务查询API查询视频任务的状态？
可以通过POST请求到https://api.acedata.cloud/maestro/tasks，使用action字段选择'retrieve'来查询单个任务的状态。
Maestro任务查询API支持哪些任务状态？
支持的任务状态包括pending、planning、producing、succeeded和failed。
如何查询历史任务列表？
使用POST请求，设置action为'retrieve_batch'，并可以通过limit参数设置返回条数，最大为100。
查询任务时，建议的轮询时间间隔是多少？
建议每5-10秒进行一次轮询查询，以获取实时进度。
如何通过时间戳过滤历史任务？
可以在查询历史任务时设置created_at_max和created_at_min参数，以过滤早于或晚于特定Unix时间戳的任务。
Maestro任务查询API的返回数据包含哪些信息？
返回的数据包含任务状态、请求参数和响应结果，包括任务的进度和输出链接。
