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 的结果。假设你有一个任务 ID：2db0168c-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, json=payload, headers=headers) 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, json=payload, headers=headers) print(response.text)常见问题
- 错误处理：如果调用 API 时发生错误，API 将返回相应的错误代码和消息。例如：
400 token_mismatched: 请求错误，可能是缺少或无效参数。401 invalid_token: 未授权，授权令牌无效或缺失。
错误响应示例
{ "success": false, "error": { "code": "api_error", "message": "fetch failed" } }总结
通过本教程，你已经学习了如何使用 Flux Tasks API 查询单个或批量图像任务的具体信息。希望本指南能帮助你更好地集成和利用此 API。如果有任何疑问，请随时联系技术支持团队。
标签
FluxTasksAPI
AceDataCloud
API集成
Python开发
数据处理