提交生歌任务（prompt/仿写）

POST/api/v1/song/generate

Authorization

BearerAuth Authorization: Bearer <YOUR_API_KEY>

Request Body

application/json

modelstringrequired

模型版本。提示词生成（task_type=normal）支持 v3.5、v4.0；仿写（task_type=reference）当前支持 v3.5

task_typeenum<string>required

生成模式

有效值: normalreference

lyricstring

歌词

有效值: 最大长度 3000

promptstring

提示词，最长 1000 字符

有效值: 最大长度 1000

reference_audioobject | null

参考音频

收起子属性

audio_typeenum<string>required

AudioType

有效值: upload_idaudio_idaudio_url

audio_contentstring

音频数据(UUID/url)

similaritynumber | null

相似度，有效值为[0.2, 0.8, 1.3, 1.5]

callbackstring

回调地址

ninteger

生成几首歌,默认是2

有效值: 1 – 2

Responses

200application/json

idstring<uuid>required

任务id

有效值: 格式: uuid

task_typeenum<string>required

TaskType

有效值: normalreferenceextend

choicesarray<object>

关联歌曲

收起子属性

idstring<uuid>required

歌曲id

有效值: 格式: uuid

statusenum<string>required

SongStatus

有效值: pendingcancelledrunningstreamdonefail

errorstring

错误原因

error_codeinteger

错误代码

audio_urlstring

完整mp3的播放地址

pipe_urlstring

流式播放地址

titlestring

歌名

lyricstring

歌词

sizeinteger

bytes字节数

durationnumber

mp3时长

create_atinteger

歌曲创建时间戳

finish_atinteger

歌曲创建结束时间戳

create_atinteger

任务创建时间戳