Suno Tasks API 的集成与使用

用户00045392116
3 阅读4分钟

在现代应用开发中，音频和歌词生成的需求日益增加，而 Ace Data Cloud 提供的 Suno Tasks API 则为开发者提供了便捷的任务查询功能。通过这个 API，开发者可以根据从 Suno Audios Generation API 或 Suno Lyrics Generation API 获取的任务 ID 查询任务的执行状态。本文将详细介绍 Suno Tasks API 的集成步骤及使用方法。

背景介绍

Ace Data Cloud 是一个功能强大的数据处理平台，提供多种 API 服务，包括音频和歌词生成。开发者可以通过这些 API 轻松创建和管理音频内容，满足不同场景下的需求。

申请服务

使用 Suno Tasks API 之前，您需要在 Suno Audios Generation API 的申请页面申请相应的服务，并获取任务 ID。以下是获取任务 ID 的步骤：

  1. 访问 Suno Audios Generation API 并生成任务。
  2. 复制生成的任务 ID，如下图所示：

  1. 然后前往 Suno Tasks API 申请相应服务。点击“Acquire”按钮，如下图所示：

Application Page

如果您还未登录或注册，将被自动重定向到 登录页面。首次申请者可以享受免费配额，方便您进行 API 测试。

请求示例

Suno Tasks API 可用于查询 Suno Audios Generation API 和 Suno Lyrics Generation API 的任务结果。使用示例中，我们将使用从 Suno Audios Generation API 返回的任务 ID（例如：eae26f89-b64b-404d-a80c-761996660b1c）进行演示。

设置请求头和请求体

请求头：

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

请求体：

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

示例设置如下图所示：

代码示例

以下是使用 cURL 和 Python 进行 API 请求的代码示例：

CURL

curl -X POST 'https://api.acedata.cloud/suno/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "id": "eae26f89-b64b-404d-a80c-761996660b1c",
  "action": "retrieve"
}'

Python

import requests

url = "https://api.acedata.cloud/suno/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "id": "eae26f89-b64b-404d-a80c-761996660b1c",
    "action": "retrieve"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

响应示例

成功请求后，API 将返回任务的具体信息。例如：

{
  "_id": "66d2add5550a4144a5a88dfe",
  "id": "eae26f89-b64b-404d-a80c-761996660b1c",
  "api_id": "09a26295-5972-4392-9318-dcd9b218f90d",
  "request": {
    "action": "generate",
    "prompt": "A song for Christmas"
  },
  "response": {
    "success": true,
    "task_id": "eae26f89-b64b-404d-a80c-761996660b1c",
    "data": [
      {
        "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e",
        "title": "Holiday Wishes",
        "audio_url": "https://cdn1.suno.ai/b8a4f691-4b14-4120-a7e1-a54a27a0e57e.mp3"
      }
    ]
  }
}

返回内容包含多个字段，request 字段是发起任务时的请求信息，response 字段则是任务完成后返回的信息。

批量查询操作

如果需要查询多个任务 ID 的详细信息，可以使用批量查询功能，此时的操作方法为 retrieve_batch。

请求体：

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

代码示例

以下是批量查询的代码示例：

CURL

curl -X POST 'https://api.acedata.cloud/suno/tasks' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "ids": ["eae26f89-b64b-404d-a80c-761996660b1c", "0d3ed03b-912b-4f7d-941b-8441323cb77b"],
  "action": "retrieve_batch"
}'

Python

import requests

url = "https://api.acedata.cloud/suno/tasks"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "ids": ["eae26f89-b64b-404d-a80c-761996660b1c", "0d3ed03b-912b-4f7d-941b-8441323cb77b"],
    "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: 请求过多，超过速率限制。

错误响应示例

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  }
}

总结

通过本文，您已了解如何使用 Suno Tasks API 查询单个或批量音频生成任务的具体信息。这一 API 为音频内容的生成和管理提供了强大的支持。如果您有任何问题，请随时联系技术支持团队。

相关链接：

标签：#API #音频生成 #数据处理 #开发者工具 #技术分享

avatar
文章
阅读
粉丝