简介

生产者任务 API 的主要功能是通过输入由生产者音频生成 API 生成的任务 ID 来查询任务的执行状态。本文将为您提供详细的集成说明，帮助您轻松集成并充分利用此 API 的强大功能。使用生产者任务 API，您可以方便地查询来自生产者音频生成 API 的任务执行状态。

环境准备/前置条件

在开始之前，请确保您已经访问了 Ace Data Cloud 平台，并申请了相应的服务。了解更多信息和申请流程，请访问：生产者音频生成 API 文档。

详细步骤

应用流程

1. 首先，您需要在应用页面申请对应的服务，并从生产者音频生成 API 中复制任务 ID，如下图所示：

1. 然后，转到任务 API 页面申请相应服务，生产者任务 API，点击“获取”按钮，如下图所示：

1. 如果您尚未登录或注册，系统会自动重定向到登录页面。完成登录或注册后，您将自动返回当前页面。

2. 对于首次申请者，系统提供免费配额，允许您免费使用此 API。

请求示例

生产者任务 API 可用于查询生产者音频生成 API 的结果。有关如何使用生产者音频生成 API 的详细信息，请参阅文档：生产者音频生成 API。

假设我们有一个任务 ID：1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad，以下是如何传入任务 ID 的示例。

设置请求头和请求体

请求头包括：

• accept: 指定响应格式为 JSON，设置为application/json。
• authorization: 调用 API 的密钥，申请后即可直接选择。

请求体包括：

• id: 上传的任务 ID。
• action: 任务的操作方法。

设置如下图所示：

代码示例

您可以看到页面右侧已经自动生成了多种语言的代码示例，如下图所示：

以下是一些代码示例：

CURL

curl -X POST 'https://api.acedata.cloud/producer/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "action": "retrieve" }'

响应示例

成功请求后，API 将返回任务的详细信息，例如：

{ "_id": "69541b81ff2676299ccc3b29", "id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "api_id": "01d96900-9f8c-41d7-814c-95c7a885ba61", "application_id": "920ba772-867a-48ae-8efa-9b9f94136199", "created_at": 1767119745.524, "credential_id": "eeae817d-d6ff-493e-8f88-6c62391da7c6", "request": { "action": "generate", "model": "FUZZ-2.0 Pro", "instrumental": false, "lyric": "[Verse]\nWoke up with the sun in my eyes\n..." }, "response": { "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad", "data": [ { "id": "1dd08826-478e-43a6-868f-aff5ababac2c", "title": "Woke up with the sun in my eyes", "image_url": "https://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/image/1dd08826-478e-43a6-868f-aff5ababac2c.jpg", "audio_url": "https://storage.googleapis.com/corpusant-app-public/riffs/3bff6223-fe13-4bef-973e-2cbaef430d5d/audio/1dd08826-478e-43a6-868f-aff5ababac2c.m4a", "progress": "100%", "state": "succeeded" } ] } }

返回结果包含多个字段，request字段为发起任务时的请求体，response字段为任务完成后返回的响应体。

批量查询操作

如果需要查询多个任务 ID 的详细信息，操作方法需选择retrieve_batch。

请求体包括：

• ids: 上传的任务 ID 数组。
• action: 任务的操作方法。

设置如下图所示：

代码示例

以下是批量查询的 CURL 示例：

curl -X POST 'https://api.acedata.cloud/producer/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "ids": ["1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad","1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad"], "action": "retrieve_batch" }'

错误处理

当调用 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" }

总结

通过本文，您学习了如何使用生产者任务 API 查询单个或批量任务的具体细节。希望这些信息能帮助您更好地集成和使用该 API。如有任何问题，请随时联系技术支持团队。

技术标签：#API #云计算 #数据处理 #开发者指南 #AceDataCloud