Skip to main content
POST
创建音乐 V2

说明

使用 Music 2.0 的结构化参数创建异步歌曲任务,返回 task_id 后通过统一查询接口轮询结果。
该接口为异步接口,创建任务后请使用 查询歌曲任务 轮询结果。
V2 不接收 V1 的 custom_modeinstrumentaltitlestyle_weightweirdness_constraint 字段。
仅顶层 lyrics 使用 cl100k_base 执行 1600 token 限制;prebuilt_lyrics、歌词生成和歌词改写不使用该限制。
prebuilt_lyrics 用于精确回灌写词结果,与顶层 lyrics 互斥。
attachments 仅支持 audio 类型,且需提供可公开访问的 URL。
audio_settings.format 支持 mp3wavwav32

授权

Authorization
string
header
必填

格式:Bearer <API_KEY>

请求体

application/json
model
enum<string>
必填

已启用的 Music 2.0 模型 label。

可用选项:
senseaudio-music-2.0-260626
prompt
string

歌曲主题或自然语言描述。

mode
enum<string>
默认值:sing

生成模式。

可用选项:
sing,
lyrics_to_instrumental,
instrumental
style
string

目标音乐风格。

lyrics
string

用户自带歌词;与 prebuilt_lyrics 互斥,最多 1600 tokens。

attachments
object[]

参考音频附件列表。

prebuilt_lyrics
object

写词预览结果回灌,用于精确渲染。

audio_settings
object
model_settings
object
lyrics_settings
object
vocal_settings
object
music_settings
object
cover_settings
object

响应

200 - application/json

成功

task_id
string

异步歌曲生成任务 ID,用于统一查询接口轮询状态。