SenseAudio SongMaker

两步创作歌曲：生成歌词 → 谱曲。如果用户已有歌词，直接跳至第二步。

工作流程

用户描述 → [步骤1] 生成歌词 → 用户确认/修改 → [步骤2] 生成歌曲 → 返回链接
↑ 用户自带歌词时跳过步骤1

步骤1：生成歌词

如果用户提供自己的歌词，则跳过此步骤。

bash
LYRICS_RESP=$(curl -s -X POST https://api.senseaudio.cn/v1/song/lyrics/create \
-H Authorization: Bearer $SENSEAUDIOAPIKEY \
-H Content-Type: application/json \
-d {\prompt\: \<用户提示>\, \provider\: \sensesong\})

TASKID=$(echo $LYRICSRESP | jq -r .task_id // empty)

如果存在 task_id，则轮询直至完成：

bash
while true; do
POLL=$(curl -s https://api.senseaudio.cn/v1/song/lyrics/pending/$TASK_ID \
-H Authorization: Bearer $SENSEAUDIOAPIKEY)
STATUS=$(echo $POLL | jq -r .status)
{ [ $STATUS = SUCCESS ] || [ $STATUS = FAILED ]; } && break
sleep 3
done
LYRICS=$(echo $POLL | jq -r .response.data[0].text)

如果没有 task_id（同步响应），直接读取：

bash
LYRICS=$(echo $LYRICS_RESP | jq -r .data[0].text)

向用户展示歌词，并在继续前请求确认或修改。

歌词格式

API使用以 ; 分隔的结构化段落标签：

[intro-medium] ; [verse] 第一段歌词内容 ; [chorus] 副歌内容 ; [bridge] 桥段 ; [outro-short]

常用标签：[intro-short] [intro-medium] [verse] [chorus] [bridge] [outro-short] [outro-medium] [inst-short]

如果用户提供不带标签的纯歌词，则包裹为：[verse] <歌词> ; [chorus] <副歌>

步骤2：生成歌曲

根据用户偏好构建请求体：

bash
SONG_RESP=$(curl -s -X POST https://api.senseaudio.cn/v1/song/music/create \
-H Authorization: Bearer $SENSEAUDIOAPIKEY \
-H Content-Type: application/json \
-d {
\model\: \sensesong\,
\lyrics\: \<歌词>\,
\title\: \<标题>\,
\vocal_gender\: \\,
\style\: \<风格>\
})

SONGTASK=$(echo $SONGRESP | jq -r .task_id)

歌曲生成始终返回 task_id。轮询直至完成（可能需要30–120秒）：

bash
while true; do
POLL=$(curl -s https://api.senseaudio.cn/v1/song/music/pending/$SONG_TASK \
-H Authorization: Bearer $SENSEAUDIOAPIKEY)
STATUS=$(echo $POLL | jq -r .status)
{ [ $STATUS = SUCCESS ] || [ $STATUS = FAILED ]; } && break
echo 生成中... ($STATUS)
sleep 5
done

输出

成功时，提取并展示：

bash
echo $POLL | jq -r .response.data[0] | 标题：\(.title)\n时长：\(.duration) 秒\n音频：\(.audiourl)\n封面：\(.coverurl)

示例输出：

标题：夏日物语
时长：187 秒
音频：https://cdn.senseaudio.cn/songs/xxx.mp3
封面：https://cdn.senseaudio.cn/covers/xxx.jpg

失败时，报告状态并建议更换风格或简化歌词后重试。