Flux Tasks API 的集成与使用指南

简介Flux Tasks API 是 Ace Data Cloud 提供的一个强大工具主要用于查询由 Flux Images Generation API 生成的任务执行状态。通过此 API开发者可以轻松获取任务的实时进度和结果从而更好地管理和优化图像生成工作流。在本教程中我们将详细介绍如何集成和使用 Flux Tasks API帮助你充分利用其强大的功能。环境准备/前置条件在使用 Flux Tasks API 之前你需要完成以下步骤访问 Flux Images Generation API 页面申请相应的服务。从 Flux Images Generation API 复制生成的任务 ID。前往 Flux Tasks API 页面申请相关服务。详细步骤申请服务在申请页面中点击“获取”按钮。如果你尚未登录系统会引导你到 登录页面完成注册或登录后返回当前页面。首次申请用户可享受免费配额。请求示例Flux Tasks API 的主要用途是查询 Flux Images Generation API 的结果。假设你有一个任务 ID2db0168c-2373-4367-8d9a-9dc778802e8a以下是如何使用该 API 的详细步骤。设置请求头和请求体请求头包括 -accept: 响应格式设置为application/json。 -authorization: API 调用所需的密钥。请求体包括 -id: 上传的任务 ID。 -action: 任务的操作方式。请求体设置如图所示代码示例你可以直接在页面右侧查看自动生成的不同语言代码。以下是使用 CURL 和 Python 的代码示例CURL 示例curl -X POST https://api.acedata.cloud/flux/tasks \ -H accept: application/json \ -H authorization: Bearer {token} \ -H content-type: application/json \ -d { id: 2c454ff3-4f8f-47f0-8147-acb29a84d1c2, action: retrieve }Python 示例import requests url https://api.acedata.cloud/flux/tasks headers { accept: application/json, authorization: Bearer {token}, content-type: application/json } payload { id: 2c454ff3-4f8f-47f0-8147-acb29a84d1c2, action: retrieve } response requests.post(url, jsonpayload, headersheaders) print(response.text)响应示例成功请求后API 将返回图像任务的详细信息。例如{ _id: 677de81d550a4144a5f4cf62, id: 2db0168c-2373-4367-8d9a-9dc778802e8a, api_id: deefc5d7-7f22-43e9-929e-f2b6afee60b7, application_id: 001c2f84-2a4a-4c4d-ba3f-8a89f43b5be2, created_at: 1736304669.779, request: { action: generate, size: 1024x1024, prompt: a white siamese cat }, response: { success: true, task_id: 2db0168c-2373-4367-8d9a-9dc778802e8a, data: [ { prompt: a white siamese cat, image_url: https://example.com/image.png } ] } }返回的结果包含多个字段其中request表示任务发起时的请求信息而response则是任务完成后的返回信息。批量查询操作如果需要查询多个任务 ID可以使用retrieve_batch作为操作方法。请求体设置如下{ ids: [2db0168c-2373-4367-8d9a-9dc778802e8a,72bdd69d-290d-4710-a6d4-60c78968865a], action: retrieve_batch }批量请求代码示例CURL 示例curl -X POST https://api.acedata.cloud/flux/tasks \ -H accept: application/json \ -H authorization: Bearer {token} \ -H content-type: application/json \ -d { ids: [2db0168c-2373-4367-8d9a-9dc778802e8a,72bdd69d-290d-4710-a6d4-60c78968865a], action: retrieve_batch }Python 示例import requests url https://api.acedata.cloud/flux/tasks headers { accept: application/json, authorization: Bearer {token}, content-type: application/json } payload { ids: [2db0168c-2373-4367-8d9a-9dc778802e8a,72bdd69d-290d-4710-a6d4-60c78968865a], action: retrieve_batch } response requests.post(url, jsonpayload, headersheaders) print(response.text)常见问题错误处理如果调用 API 时发生错误API 将返回相应的错误代码和消息。例如400 token_mismatched: 请求错误可能是缺少或无效参数。401 invalid_token: 未授权授权令牌无效或缺失。错误响应示例{ success: false, error: { code: api_error, message: fetch failed } }总结通过本教程你已经学习了如何使用 Flux Tasks API 查询单个或批量图像任务的具体信息。希望本指南能帮助你更好地集成和利用此 API。如果有任何疑问请随时联系技术支持团队。标签FluxTasksAPIAceDataCloudAPI集成Python开发数据处理