Producer 上传参考音频 API 对接说明
内容提要
本文介绍Producer上传参考音频API的对接方法。该API仅需一个参数audio_url，传入公开可访问的mp3 CDN地址。通过curl请求示例，返回结果包含task_id、audio_id、歌词及音频URL。获取audio_id后，可配合Producer Audios Generation API，使用upload_extend操作生成基于参考音频的新歌曲。
延伸解读
接口设计极简，但依赖外部CDN
该上传接口仅需一个参数audio_url，简化了对接流程。但要求该地址必须是公开可访问的mp3 CDN链接，这意味着开发者需要先将音频文件上传至可公开访问的存储服务（如对象存储），并确保链接长期有效。若CDN链接失效或访问受限，接口将无法正常工作，因此在实际应用中需注意链接的稳定性和安全性。
返回数据包含歌词，可辅助二次创作
接口返回的data中不仅包含audio_id，还提供了lyric字段，其中包含了歌曲的风格标签和歌词内容。这些信息可用于了解参考音频的歌曲结构，为后续使用Producer Audios Generation API进行歌曲生成时提供参考，例如调整生成参数或作为歌词输入的起点。但需注意，歌词可能不完整或与最终生成结果存在差异。
上传后需结合生成接口使用
获取audio_id后，需配合Producer Audios Generation API，通过action=upload_extend参数来生成新歌曲。这表明上传接口本身不直接产生创作结果，而是作为前置步骤。开发者需确保在调用生成接口时正确传递audio_id，并注意生成接口可能存在的其他参数和限制，如生成时长、风格控制等，这些在本文中未详细说明，需参考相关文档。
Q&A
Producer上传参考音频API需要哪些参数？
该API只需要一个参数audio_url，它是一个公开可访问的mp3 CDN地址。
如何调用Producer上传参考音频API？
使用POST请求发送到https://api.acedata.cloud/producer/upload，请求头包含accept: application/json、authorization: Bearer {token}和content-type: application/json，请求体为JSON格式，包含audio_url字段。
Producer上传参考音频API返回哪些数据？
返回结果包含success、task_id和data，其中data包含audio_id、lyric和audio_url。audio_id是上传后的歌曲ID，lyric是歌词，audio_url是音频文件的URL。
如何获取上传后的歌曲ID？
在API返回的data字段中，audio_id字段即为上传后的歌曲ID。
上传参考音频后如何生成新歌曲？
获取audio_id后，使用Producer Audios Generation API，将action参数设为upload_extend，并传入audio_id，即可根据参考音频生成新歌曲。
Producer上传参考音频API支持哪些音频格式？
目前支持mp3格式，且音频地址必须是公开可访问的CDN地址。
