当前位置：首页 > news >正文

Riffusion 音频生成 API 集成指南

news 2026/8/10 23:50:33

在这篇文章中，我们将介绍 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 命令生成歌曲：

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" }'

自定义生成

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

[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: 歌曲风格（可选）。

示例代码

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。

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 }'