简介生产者任务 API 的主要功能是通过输入由生产者音频生成 API 生成的任务 ID 来查询任务的执行状态。本文将为您提供详细的集成说明帮助您轻松集成并充分利用此 API 的强大功能。使用生产者任务 API您可以方便地查询来自生产者音频生成 API 的任务执行状态。环境准备/前置条件在开始之前请确保您已经访问了 Ace Data Cloud 平台并申请了相应的服务。了解更多信息和申请流程请访问生产者音频生成 API 文档。详细步骤应用流程首先您需要在应用页面申请对应的服务并从生产者音频生成 API 中复制任务 ID如下图所示然后转到任务 API 页面申请相应服务生产者任务 API点击“获取”按钮如下图所示如果您尚未登录或注册系统会自动重定向到登录页面。完成登录或注册后您将自动返回当前页面。对于首次申请者系统提供免费配额允许您免费使用此 API。请求示例生产者任务 API 可用于查询生产者音频生成 API 的结果。有关如何使用生产者音频生成 API 的详细信息请参阅文档生产者音频生成 API。假设我们有一个任务 ID1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad以下是如何传入任务 ID 的示例。设置请求头和请求体请求头包括accept: 指定响应格式为 JSON设置为application/json。authorization: 调用 API 的密钥申请后即可直接选择。请求体包括id: 上传的任务 ID。action: 任务的操作方法。设置如下图所示代码示例您可以看到页面右侧已经自动生成了多种语言的代码示例如下图所示以下是一些代码示例CURLcurl -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