在现代应用开发中，数据处理与生成任务的管理是至关重要的。Ace Data Cloud 提供了 Flux Tasks API，它可以通过输入由 Flux Images Generation API 生成的任务 ID 来查询任务的执行状态。本文将详细介绍如何集成和使用 Flux Tasks API，帮助开发者充分利用这一强大的功能。
背景介绍
Ace Data Cloud 是一个云平台，专注于提供高效的数据处理和生成服务。使用 Flux Tasks API，开发者可以实时监控图像生成任务的状态，确保任务的顺利执行。这对于需要快速反馈的数据驱动应用尤为重要。
申请流程
要使用 Flux Tasks API，首先需要在申请页面申请相应的服务，访问 Flux Images Generation API 进行申请。申请后，您可以复制 Flux Images Generation API 返回的任务 ID，如下图所示：
接着，访问 Flux Tasks API 页面 Flux Tasks API 并申请相应的服务。在页面中点击“获取”按钮，如下图所示。
如果您尚未登录或注册，系统会自动引导您前往 登录页面 进行注册和登录。首次申请用户可以享受免费的配额，允许您免费使用该 API。
请求示例
Flux Tasks API 可以用于查询 Flux Images Generation API 的结果。有关如何使用 Flux Images Generation API 的详细信息，请参考文档 Flux Images Generation API。
以下示例将展示如何使用任务 ID 查询任务状态。假设我们拥有一个任务 ID：2db0168c-2373-4367-8d9a-9dc778802e8a，我们将演示如何传入该任务 ID。
请求头和请求体设置
请求头包括：
accept: 指定响应格式为 JSON，设置为application/json。authorization: 调用 API 的密钥，申请后可直接选择。
请求体包括：
id: 上传的任务 ID。action: 任务的操作方式。
请求体设置如图所示：
代码示例
在页面的右侧，您可以看到自动生成的多种语言代码，如下图所示：
以下是一些代码示例：
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,
"credential_id": "b00bddd3-140f-4343-a9a2-affb312b60de",
"request": {
"action": "generate",
"size": "1024x1024",
"prompt": "a white siamese cat"
},
"trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
"user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf",
"response": {
"success": true,
"task_id": "2db0168c-2373-4367-8d9a-9dc778802e8a",
"trace_id": "6624929c-bb80-40c0-81e8-d96af8405d19",
"data": [
{
"prompt": "a white siamese cat",
"image_url": "https://sf-maas-uat-prod.oss-cn-shanghai.aliyuncs.com/outputs/57d9ff7c-5a00-409e-9dcc-90f35b38d16e_0.png",
"seed": 281520112,
"timings": {
"inference": 3.193
}
}
]
}
}
响应结果包含多个字段，其中 request 字段为任务发起时的请求内容，response 字段为任务完成后返回的响应内容。
批量查询操作
如果您需要查询多个任务 ID 的详细信息，可以选择批量查询操作。此时，action 需要设置为 retrieve_batch。
请求体包括：
ids: 上传的任务 ID 数组。action: 任务的操作方式。
请求体设置如图所示：
代码示例
以下是批量查询的代码示例：
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: 未授权，令牌无效或缺失。429 too_many_requests: 请求过多，超出速率限制。500 api_error: 服务器内部错误。
错误响应示例
{
"success": false,
"error": {
"code": "api_error",
"message": "fetch failed"
},
"trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}
总结
通过本文，您已经了解了如何使用 Flux Tasks API 查询单个或批量图像任务的详细信息。希望本文能够帮助您更好地集成和使用该 API。如有任何疑问，请随时联系技术支持团队。
技术标签：#FluxTasksAPI #
