上传音乐

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

请求头

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