集成与使用生产者任务 API
简介
生产者任务 API 的主要功能是通过输入由生产者音频生成 API 生成的任务 ID 来查询任务的执行状态。本文将为您提供详细的集成说明，帮助您轻松集成并充分利用此 API 的强大功能。使用生产者任务 API，您可以方便地查询来自生产者音频生成 API 的任务执行状态。
环境准备/前置条件
在开始之前，请确保您已经访问了 Ace Data Cloud 平台，并申请了相应的服务。了解更多信息和申请流程，请访问：生产者音频生成 API 文档。
详细步骤
应用流程
- 首先，您需要在应用页面申请对应的服务，并从生产者音频生成 API 中复制任务 ID，如下图所示：
- 然后，转到任务 API 页面申请相应服务，生产者任务 API，点击“获取”按钮，如下图所示：
如果您尚未登录或注册，系统会自动重定向到登录页面。完成登录或注册后，您将自动返回当前页面。
对于首次申请者，系统提供免费配额，允许您免费使用此 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