Udio任务API的集成与使用教程

简介

Udio任务API的主要功能是通过输入由Udio音频生成API生成的任务ID，查询任务的执行状态。本文将详细介绍如何集成Udio任务API，帮助您轻松利用此API的强大功能。通过Udio任务API，您可以方便地查询从Udio音频生成API返回的任务执行状态。

环境准备/前置条件

在使用Udio任务API之前，您需要在 Udio音频生成API 页面申请相应的服务，并复制从Udio音频生成API返回的任务ID。

详细步骤

申请服务

1. 访问 Udio音频生成API 页面，申请相应服务。
2. 复制任务ID（如图所示）：

1. 前往 Udio任务API 页面，点击“获取”按钮：

1. 如果您没有登录或注册，系统会自动跳转到 登录页面，请进行注册或登录。

注意：首次申请用户可享受免费配额，您可以免费使用此API。

请求示例

Udio任务API可以用于查询Udio音频生成API的结果。有关如何使用Udio音频生成API的信息，请参考文档 Kling视频生成API。

以下是使用任务ID（例如：20068983-0cc9-4c6a-aeb6-9c6a3c668be0）查询的示例。

设置请求头和请求体

请求头包含： -accept: 指定响应格式为JSON，值为application/json。 -authorization: 调用API的密钥。

请求体包含： -id: 上传的任务ID。 -action: 任务的操作方法。

请求体的设置示例如下：

代码示例

页面右侧会自动生成多种语言的代码示例，示例如下：

以下是使用cURL进行请求的示例：

curl -X POST 'https://api.acedata.cloud/udio/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "8aa0e153-2f15-41dd-9158-76bcd3254a9d", "action": "retrieve" }'

响应示例

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

{ "_id": "67f67ee9550a4144a5c83f96", "id": "8aa0e153-2f15-41dd-9158-76bcd3254a9d", "response": { "success": true, "data": [ { "id": "5a5e2163-1c24-4c71-b975-aa0cdc0e6ca1", "title": "Morning Ritual", "audio_url": "https://storage.googleapis.com/udio-artifacts-c33fe3ba-3ffe-471f-92c8-5dfef90b3ea3/samples/b290b27d975b42eda0ffa50a0758fb54/1/The%2520Untitled.mp3", "state": "completed" } ] } }

批量查询操作

对于多个任务ID的查询，可以使用批量查询操作。设置请求体如下：

{ "ids": ["e3a575aa-a4bd-49c8-9b12-cde38d5462e0","20068983-0cc9-4c6a-aeb6-9c6a3c668be0"], "action": "retrieve_batch" }

代码示例

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

curl -X POST 'https://api.acedata.cloud/udio/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "ids": ["e3a575aa-a4bd-49c8-9b12-cde38d5462e0","20068983-0cc9-4c6a-aeb6-9c6a3c668be0"], "action": "retrieve_batch" }'

常见问题

• 如何处理错误？如果调用API时发生错误，API将返回相应的错误代码和消息。例如：json { "success": false, "error": { "code": "api_error", "message": "fetch failed" } }

总结

通过本文，您已学习如何使用Udio任务API查询单个或批量任务的详细信息。希望本文能帮助您更好地集成和使用此API。如有疑问，请随时联系技术支持团队。

标签：#Udio #API集成 #数据处理 #音频生成 #技术教程