Udio 音频生成 API 集成指南
在本篇文章中，我们将详细介绍如何集成 Udio 音频生成 API。该 API 可根据自定义参数生成 Udio 的官方音乐，适合开发者用于音乐生成、创作等多种场景。
环境准备
在开始之前，请确保您具备以下条件：
- 已注册并登录 Ace Data Cloud 账户。
- 拥有访问 Udio 音频生成 API 的权限。
申请 API 访问
要使用该 API，首先需要在 Udio Audios Generation API 页面申请相应服务。进入页面后，点击“获取”按钮，如下图所示：
如果您未登录或注册，将自动跳转到登录页面。登录或注册后，您将返回到申请页面。
首次申请时，将提供免费的配额，允许您免费使用该 API。
基本用法
首先了解基本用法，您需要输入以下字段来获取处理结果：
action: 指定操作，此处值为generate。model: 当前主要包括udio32-v1.5和udio130-v1.5。- 其他字段包括
prompt（提示）、lyrics（歌词）、lyrics_strength（歌词强度）等。
请求头设置如下：
accept: 期望的响应格式，填写为application/json。authorization: 调用 API 的密钥，申请后可直接获取。
请求体示例：
{ "model": "udio130-v1.5", "lyrics_type": "user", "action": "generate", "lyrics": "你的歌词", "prompt": "描述内容", "lyrics_strength": 0.8, "negative_prompt": "不希望的内容", "prompt_strength": 0.5, "quality": "高", "callback_url": "你的回调URL" }通过点击“尝试”按钮进行测试，您将获得如下结果：
{ "success": true, "data": [ { "id": "c97f3596-f355-46be-b204-032c0122e628", "title": "Morning Reflections", "audio_url": "https://storage.googleapis.com/udio-artifacts-c33fe3ba-3ffe-471f-92c8-5dfef90b3ea3/samples/ce45f47cbac34eabb582412a91eaa528/1/The%2520Untitled.mp3", "state": "completed" } ] }异步回调
由于 Udio 音频生成 API 的生成时间较长，约需 1-2 分钟，因此它支持异步回调。流程如下：
- 客户端发起请求时，指定
callback_url字段。 - API 返回包含
task_id的结果。 - 任务完成后，生成的结果将以 POST JSON 格式发送到指定的
callback_url。
示例操作：
首先，您可以使用公共 Webhook 网站 webhook.site 获取 Webhook URL，如https://webhook.site/624b2c78-6dbd-4618-9d2b-b32eade6d8c3。
然后，将callback_url字段设置为该 URL，并填写相关参数，点击运行。
您将立即收到如下结果：
{ "task_id": "20068983-0cc9-4c6a-aeb6-9c6a3c668be0" }稍后，您可以在 Webhook URL 中查看生成的任务结果。
错误处理
调用 API 时，如果出现错误，API 将返回相应的错误代码和消息。例如：
400 token_mismatched: 请求错误，可能缺少或无效参数。401 invalid_token: 未授权，令牌无效或缺失。429 too_many_requests: 请求过多，超出速率限制。500 api_error: 服务器内部错误。
错误响应示例：
{ "success": false, "error": { "code": "api_error", "message": "fetch failed" } }总结
通过本指南，您已经了解了如何使用 Udio 音频生成 API 生成音乐。希望这篇文章能帮助您更好地集成和使用该 API。如有任何问题，请随时联系技术支持团队。
技术标签：#API #音频生成 #Udio #AceDataCloud #开发者指南