Flux Tasks API 的对接和使用
内容提要
本文介绍Flux Tasks API的对接与使用方法。该API通过传入任务ID查询Flux Images Generation API的图片生成任务详情。文章涵盖申请流程、单个任务查询（使用id和action参数）、批量查询（使用ids数组和retrieve_batch操作）、请求与响应示例、字段说明及错误处理，帮助用户集成并查询任务执行情况。
延伸解读
API Token 通用性
文章指出，一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。这意味着开发者只需在 Ace Data Cloud 控制台获取一次 Token，即可用于 Flux Tasks API 及其他相关 API，简化了集成流程。首次申请还会赠送免费额度，便于测试和体验。
批量查询的响应结构
批量查询（retrieve_batch）的响应与单个查询不同，外层包含 items 数组和 count 字段。items 中每个元素的结构与单个查询的返回结果一致，因此开发者可以复用单个查询的解析逻辑来处理批量结果。count 字段则直接提供了任务数量，便于校验数据完整性。
错误处理要点
文章列出了常见的错误码，如 400（参数错误）、401（无效 Token）、429（请求过多）和 500（服务器错误）。开发者应针对这些错误码实现相应的重试或提示逻辑，尤其是 429 限流错误，需要合理控制请求频率。错误响应中包含 trace_id，可用于向技术支持反馈问题。
Q&A
Flux Tasks API 的主要功能是什么？
Flux Tasks API 的主要功能是通过输入 Flux Images Generation API 生成的任务ID来查询该任务的执行情况，包括单个任务查询和批量任务查询。
如何获取调用 Flux Tasks API 所需的 API Token？
需要到 Ace Data Cloud 控制台获取 API Token。如果未登录或注册，会自动跳转到登录页面，注册登录后返回当前页面即可获取。一个 API Token 即可调用平台所有服务，首次申请会赠送免费额度。
Flux Tasks API 查询单个任务时，请求体需要包含哪些参数？
查询单个任务时，请求体需要包含两个参数：id（任务ID）和 action（操作方式，设置为 retrieve）。
Flux Tasks API 批量查询任务时，请求体如何构造？
批量查询时，请求体需要包含 ids（任务ID数组）和 action（操作方式，设置为 retrieve_batch）。例如：{"ids": ["id1", "id2"], "action": "retrieve_batch"}。
Flux Tasks API 返回的响应中，request 和 response 字段分别代表什么？
request 字段是发起任务时的请求体信息，response 字段是任务完成后返回的响应体信息。
Flux Tasks API 批量查询的响应中，items 和 count 字段分别代表什么？
items 是包含所有批量图片任务具体详情信息的数组，每个元素与单个任务查询的返回结果格式相同；count 表示本次批量查询的任务个数。
Flux Tasks API 返回错误时，常见的错误代码有哪些？
常见错误代码包括：400 token_mismatched（参数缺失或无效）、400 api_not_implemented（参数缺失或无效）、401 invalid_token（无效或缺失授权令牌）、429 too_many_requests（请求频率超限）、500 api_error（服务器内部错误）。
