前言
Riffusion Tasks API 是一款强大的工具，主要用于通过输入由 Riffusion Audios Generation API 生成的任务 ID 来查询任务的执行状态。对于开发者而言，Riffusion Tasks API 提供了简单易用的接口，能够方便地获取音频生成任务的运行情况。本文将详细介绍如何集成和使用 Riffusion Tasks API，帮助你快速上手并充分利用其功能。
申请流程
要使用 Riffusion Tasks API，首先需要在 Riffusion Audios Generation API 的申请页面申请相应服务。申请后，你可以从 Riffusion Audios Generation API 中复制任务 ID，如下图所示：
接下来，访问 Riffusion Tasks API 页面申请相应的服务。在页面中点击 "Acquire" 按钮，如下图所示：
如果你尚未登录或注册，将自动重定向到 登录页面，请注册或登录。完成后将自动返回当前页面。首次申请的用户可以享受免费的使用配额。
请求示例
Riffusion Tasks API 可用于查询 Riffusion Audios Generation API 的结果。有关如何使用 Riffusion Audios Generation API 的详细信息，请参考文档 Riffusion Audios Generation API。
以下示例使用 Riffusion Audios Generation API 返回的任务 ID 进行演示，假设任务 ID 为 20068983-0cc9-4c6a-aeb6-9c6a3c668be0。
设置请求头和请求体
请求头 包括：
accept: 指定响应格式为 JSON，设置为application/json。authorization: 调用 API 的密钥，可以在申请后直接选择。
请求体 包括：
id: 上传的任务 ID。action: 任务的操作方式。
请求头和请求体设置如下图所示：
代码示例
在页面的右侧，你可以看到自动生成的多种语言代码，如下图所示：
以下是一些代码示例：
CURL
curl -X POST 'https://api.acedata.cloud/riffusion/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"id": "a6e0d456-189b-4c78-9232-2fe72166ab39",
"action": "retrieve"
}'
响应示例
在成功请求后，API 将返回任务的详细信息，例如：
{
"_id": "6858b5fb550a4144a57afd78",
...
"response": {
"success": true,
"task_id": "a6e0d456-189b-4c78-9232-2fe72166ab39",
...
}
}
响应中包含多个字段，request 字段为发起任务时的请求信息，而 response 字段为任务完成后的返回信息。
批量查询操作
如果需要查询多个任务 ID 的详细信息，只需将 action 设置为 retrieve_batch。
请求体 包括：
ids: 上传任务 ID 的数组。action: 任务的操作方式。
设置示例如下图所示：
批量请求示例
curl -X POST 'https://api.acedata.cloud/riffusion/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
"ids": ["a6e0d456-189b-4c78-9232-2fe72166ab39","a6e0d456-189b-4c78-9232-2fe72166ab39"],
"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"
}
总结
通过本文，你了解了如何使用 Riffusion Tasks API 查询单个或批量任务的详细信息。我们希望这篇文档能够帮助你更好地集成和使用 API。如有任何问题，欢迎随时联系技术支持团队。
技术标签：#Riffusion #API #音频生成 #开发者 #数据集成
