创建音乐生成任务

音乐生成和语音合成共用 POST /v1/media/generate。Hailuo 的歌模式下 params.lyrics 必填，不传报 lyrics cannot be empty。

请求

curl https://api.lk888.ai/v1/media/generate \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "music-2.5",
    "prompt": "city pop, 90 BPM, warm synth",
    "params": {
      "is_instrumental": "song",
      "lyrics": "[Verse]\nCity lights are shining bright tonight\nWe are dancing till the morning light",
      "bitrate": "256000",
      "sample_rate": "44100"
    }
  }'

prompt 写音乐风格，歌词写在 params.lyrics 里。

响应

{ "code": 200, "data": { "task_id": 12345 }, "msg": "Task created successfully" }

参数

先查再用：GET /v1/skills/models/{name}。

模型	模式	歌词	采样率	码率	人声性别	版本
music-2.5 / music-2.5+	is_instrumental song / instrumental	lyrics	sample_rate 16000 / 24000 / 32000 / 44100	bitrate 32000 / 64000 / 128000 / 256000	—	—
suno-v4.5	make_instrumental song / instrumental	lyrics	sample_rate 44100 / 48000	bitrate 128000 / 192000 / 256000	vocal_gender auto / m / f	mv chirp-v4-5 / chirp-v4 / chirp-v3-5 / chirp-bluejay
suno-v6	make_instrumental song / instrumental	lyrics	—	—	vocal_gender auto / m / f	mv v6 / v6-wild / v6-mini

两家的模式参数名不一样：Hailuo 用 is_instrumental，Suno 用 make_instrumental。

歌词给不给

• Hailuo 歌模式 —— lyrics 必填；纯音乐模式（is_instrumental 设成 instrumental）不用给
• Suno —— lyrics 和 prompt 至少给一个，歌词不给的话 AI 照着风格描述自己写

歌词支持 [Verse] / [Chorus] 这类段落标记。

轮询

GET /v1/skills/task-status?task_id=12345，间隔 5 秒，is_final = true 停。成品在 result_url，result_type 是 audio。详见查询任务。

特别注意

• Suno 一版出两条，生成完自己挑一条
• suno-v6 的 v6-wild 更放得开，v6-mini 更轻更快
• suno-v4.5 支持伴奏续写和卡拉OK字幕，歌最长 4 分钟
• notify_url 是顶层字段，跟 model / prompt / params 平级
• 提交前查余额：GET /v1/skills/balance
• 失败看 error_code，能不能重试见错误码查询