Riffusion 上传参考音频 API 对接说明
内容提要
本文介绍Riffusion上传参考音频的API对接方法。该API仅需一个参数audio_url，提供公开CDN地址（支持mp3格式）。通过curl POST请求至指定端点，携带Bearer令牌和音频链接，即可获取包含audio_id的响应。随后可将此ID用于Riffusion Audios Generation API，通过action参数upload_extend生成基于参考音频的新歌曲。
延伸解读
接口设计极简，但依赖外部CDN
该上传接口仅需一个audio_url参数，简化了对接流程。但要求音频必须存放在可公开访问的CDN地址，且支持mp3格式。这意味着开发者需要自行准备稳定的外部存储和链接，若CDN不可用或格式不符，上传将失败。
异步任务模式，需轮询或回调
接口返回task_id和audio_id，但未说明任务是否同步完成。通常此类API采用异步处理，开发者需根据task_id查询任务状态或等待回调，以确保audio_id可用后再进行后续生成操作。
与生成API联动，实现二次创作
获取audio_id后，可将其用于Riffusion Audios Generation API，通过action参数upload_extend生成新歌曲。这为基于参考音频的二次创作提供了完整链路，但需注意生成API的具体参数和限制，如音频长度、风格控制等。
Q&A
Riffusion上传参考音频API需要哪些参数？
该API只有一个必填参数audio_url，它是一个可公开访问的CDN地址，支持mp3格式。
如何调用Riffusion上传参考音频的API？
使用curl发送POST请求到https://api.acedata.cloud/riffusion/upload，请求头需包含accept: application/json、authorization: Bearer {token}和content-type: application/json，请求体为JSON格式，包含audio_url字段。
Riffusion上传参考音频API的响应格式是什么？
响应为JSON格式，包含success、task_id和data字段，其中data字段包含audio_id，即上传后的歌曲ID。
上传参考音频后如何生成新歌曲？
使用Riffusion Audios Generation API，将action参数设为upload_extend，并传入audio_id（即上传返回的歌曲ID），即可基于参考音频生成新歌曲。
Riffusion上传参考音频API支持哪些音频格式？
支持mp3格式，要求提供可公开访问的CDN地址。
Riffusion上传参考音频API的端点是什么？
端点是https://api.acedata.cloud/riffusion/upload。
