Riffusion 音频生成 API 集成指南

在这篇文章中，我们将介绍 Riffusion 音频生成 API 的集成步骤。通过该 API，用户可以通过输入自定义参数生成官方的 Riffusion 音乐。Riffusion 是一个基于 AI 的音乐生成平台，适合音乐创作人、开发者和爱好者使用。

环境准备

注册并获取 Riffusion API 访问权限。
安装 cURL 或其他 HTTP 客户端工具（如 Postman）。

前置条件

首先，您需要在 Riffusion Audios Generation API 页面申请相应的服务。进入页面后，点击"获取"按钮。

如果您尚未登录或注册，系统将自动重定向您至登录页面。登录或注册后，您将返回到当前页面。
第一次申请时，会授予您一个免费的配额，允许您免费使用 API。

基本使用

生成音乐

您可以输入任意文本以生成歌曲。例如，如果我想生成一首关于圣诞节的歌曲，可以输入 a song for Christmas。

请求头设置

在请求中需要设置以下请求头：

accept: 您希望接收的响应格式，填写为 application/json，表示 JSON 格式。
authorization: 调用 API 的密钥，可以在申请后直接选择。

请求体参数

请求体中需要填写的参数包括：

action: 此次音乐生成任务的操作类型，填写为 generate。
model: 用于生成歌曲的模型，目前主要包括：FUZZ-1.0 、FUZZ-1.1 、FUZZ-1.0 Pro 、FUZZ-1.1 Pro。
lyric: 歌词内容。
custom: 是否以自定义方式生成歌曲。
prompt: 启发模式下的提示词。
style: 歌曲风格参数。
title: 歌曲标题信息。
audio_id: 参考歌曲 ID，用于续写/再现操作。
continue_at: 从指定秒数继续写歌。
replace_section_start/replace_section_end: 替换段落的起止时间（秒）。
vocal_variation: 声音变化程度，数值越大表示与原声差异越大。
callback_url: 结果需要返回的 URL。
instrumental: 是否为无歌词模式。

示例代码

您可以通过以下 cURL 命令生成歌曲：

shell 复制代码

curl -X POST 'https://api.acedata.cloud/riffusion/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "model": "FUZZ-1.0",
  "action": "generate",
  "prompt": "A song for Christmas"
}'

自定义生成

如果您想自定义歌词生成，可以直接输入歌词文本。以下是一个示例：

plaintext 复制代码

[Verse] Woke up with the sun in my eyes No clouds above just blue in the skies Shoes on my feet I'm ready to run Every step feels like a loaded gun

您需要填写以下内容：

lyric: 歌词文本
custom: 填写为 true，表示自定义生成，默认为 false，表示使用 prompt 生成。
title: 歌曲标题。
style: 歌曲风格（可选）。

示例代码

shell 复制代码

curl -X POST 'https://api.acedata.cloud/riffusion/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "model": "FUZZ-1.0",
  "action": "generate",
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies...",
  "custom": true
}'

常见操作

替换歌曲部分

若要替换已生成歌曲的部分，您需要设置 action 参数为 replace_section，并填写歌词、标题和音频 ID。

shell 复制代码

curl -X POST 'https://api.acedata.cloud/riffusion/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "replace_section",
  "model": "FUZZ-1.0 Pro",
  "lyric": "[Verse]\nWoke up with the sun in my eyes...",
  "audio_id": "b7376272-3902-49b4-a83b-62f7e6ab505c",
  "replace_section_start": 3,
  "replace_section_end": 70
}'

异步回调

由于 Riffusion 音频生成 API 的生成时间较长，您可以使用异步回调功能。您需要在请求中指定 callback_url 字段。生成任务完成后，结果将以 POST JSON 形式发送到您指定的 callback_url。

错误处理

在调用 API 时，如果发生错误，API 将返回相应的错误代码和消息。常见错误包括：

400 token_mismatched: 请求错误，可能由于缺少或无效的参数。
401 invalid_token: 未授权，令牌无效或缺失。
429 too_many_requests: 请求过多，超出速率限制。
500 api_error: 服务器内部错误。

总结

通过这篇指南，您已经了解了如何使用 Riffusion 音频生成 API 来生成音乐。希望本指南能帮助您更好地集成和使用该 API。如有任何疑问，请随时联系技术支持团队。

技术标签

Riffusion
音频生成
API集成
AI音乐生成
数据科学