Veo Tasks API 的对接和使用
内容提要
本文介绍Veo Tasks API的对接与使用，通过传入Veo Videos Generation API生成的任务ID查询任务执行情况。内容包括申请流程、单个及批量查询的请求示例、响应字段说明和错误处理。用户需在Ace Data Cloud控制台获取API Token，调用接口即可获取视频任务详情。
延伸解读
任务查询的两种模式
Veo Tasks API 提供单个查询（action 为 retrieve）和批量查询（action 为 retrieve_batch）两种模式。单个查询传入一个任务 ID，批量查询传入任务 ID 数组，返回结果中 items 数组包含每个任务的详情，count 字段表示任务数量。开发者可根据实际场景选择，批量查询可减少请求次数，提高效率。
响应字段中的时间与状态信息
响应中的 created_at、started_at、finished_at 均为 Unix 时间戳（秒），elapsed 表示任务耗时（秒）。任务未完成时不返回 finished_at 和 elapsed，因此可通过这些字段判断任务是否完成及耗时。response 字段中的 data 数组包含视频 URL 和状态（如 succeeded），可用于获取生成结果。
错误码与排查建议
API 错误响应包含 success:false 和 error 对象，其中 code 字段标识错误类型，如 401 invalid_token 表示 Token 无效，429 too_many_requests 表示请求频率超限，500 api_error 表示服务器内部错误。开发者可根据错误码快速定位问题，例如检查 Token 是否正确、是否触发限流等。
Q&A
Veo Tasks API 的主要功能是什么？
Veo Tasks API 的主要功能是通过输入 Veo Videos Generation API 生成的任务ID来查询该任务的执行情况。
如何获取 Veo Tasks API 的 API Token？
需要到 Ace Data Cloud 控制台获取 API Token。如果尚未登录或注册，会自动跳转到登录页面，注册登录后返回当前页面即可获取。一个 API Token 即可调用平台所有服务，首次申请会赠送免费额度。
Veo Tasks API 的请求头和请求体需要设置哪些参数？
请求头需要设置 accept 为 application/json，authorization 为 Bearer {token}，content-type 为 application/json。请求体需要包含 id（任务ID）和 action（操作方式，如 retrieve）。
如何通过 Veo Tasks API 查询单个视频任务？
发送 POST 请求到 https://api.acedata.cloud/veo/tasks，请求头设置 authorization 为 Bearer {token}，请求体包含 id 为任务ID，action 为 retrieve。响应会返回该任务的详细信息。
Veo Tasks API 返回的响应中主要有哪些字段？
主要字段包括：id（任务ID）、request（请求信息）、response（返回信息）、created_at（创建时间）、started_at（开始时间）、finished_at（完成时间）、elapsed（耗时）等。其中 response 中包含视频URL和状态等。
如何批量查询多个视频任务？
发送 POST 请求到 https://api.acedata.cloud/veo/tasks，请求体包含 ids 数组（任务ID列表）和 action 为 retrieve_batch。响应会返回 items 数组，包含每个任务的详情，以及 count 表示任务个数。
Veo Tasks API 常见的错误代码有哪些？
常见错误代码包括：400 token_mismatched（参数缺失或无效）、400 api_not_implemented（API未实现）、401 invalid_token（无效或缺失授权令牌）、429 too_many_requests（请求过多，超出速率限制）、500 api_error（服务器内部错误）。
