跳到导航

上传音乐

上传音乐文件以供后续局部重绘使用。上传价格与生成歌曲相同。所有上传内容都会接受版权侵权检查。如检测到受版权保护的内容,仍将收取请求费用的一半。

请求头

xi-api-keystring可选

请求

This endpoint expects a multipart form containing a file.
filefile必需

要上传的音频文件。

extract_composition_planboolean or enum可选默认为 false

是否为上传的歌曲生成并返回创作计划。传入模型 ID(music_v1、music_v2 或 music_v2_5)可控制返回的创作计划格式。传入 true/false 已弃用;true 默认使用 music_v1 计划格式。启用此项会增加延迟。

with_timestampsboolean可选默认为 false

是否转录上传的歌曲并返回单词级时间戳。如果为 True,响应将包含 words_timestamps,但会增加延迟。

with_waveform_visualboolean可选默认为 false

是否返回上传歌曲的可视化波形。

响应

已成功上传音乐文件及可选作曲计划

song_idstring

上传歌曲的唯一标识符。

composition_planobject or null可选

从上传歌曲中提取的作曲方案。仅当请求正文中提供了 extract_composition_plan 时出现。

words_timestampslist of objects or null可选

从上传歌曲转录的单词级时间戳。仅当请求体中的 with_timestamps 为 True 时提供。

waveform_visuallist of integers or null可选

上传歌曲的低分辨率波形,用于显示预览。每秒音频包含 4 个值,范围为 -1000 至 1000。立体声会混合为单声道。仅当请求正文中的 with_waveform_visual 为 True 时提供。

错误

422
Unprocessable Entity Error