- name
- senseaudio-music
- description
- SenseAudio Music Generation API for creating AI-generated lyrics and songs. Supports lyrics generation, song generation with style/vocal control, and async task polling.
- version
- 1.0.0
- metadata
- openclaw
- requires
- env
- primaryEnv
- SENSEAUDIO_API_KEY
- homepage
- https://senseaudio.cn/docs/song/lyrics_create
SenseAudio Music Generation
SenseAudio provides AI-powered music generation APIs for creating lyrics and full songs. The workflow is:
- Generate lyrics (sync or async)
- Generate a song using the lyrics (async, returns
task_id) - Poll for results
Base URL: https://api.senseaudio.cn Auth: Authorization: Bearer $SENSEAUDIO_API_KEY
1. Generate Lyrics
POST /v1/song/lyrics/create
| Parameter | Type | Required | Description |
|---|---|---|---|
| prompt | string | yes | Description of the lyrics to generate |
| provider | string | yes | Model provider, currently only sensesong |
Response (sync):
{
"data": [
{
"text": "[intro-medium] ; [verse] ... ; [chorus] ... ; [outro-medium]",
"title": ""
}
]
}Response (async): Returns task_id — poll with lyrics pending endpoint.
curl -X POST https://api.senseaudio.cn/v1/song/lyrics/create \
-H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"prompt": "一段慷慨激昂的歌词", "provider": "sensesong"}'2. Poll Lyrics (Async)
GET /v1/song/lyrics/pending/:task_id
Response:
{
"task_id": "bcee6b21-...",
"status": "SUCCESS",
"response": {
"task_id": "bcee6b21-...",
"data": [{"text": "...", "title": ""}]
}
}Status values: PENDING | SUCCESS | FAILED
curl https://api.senseaudio.cn/v1/song/lyrics/pending/{task_id} \
-H "Authorization: Bearer $SENSEAUDIO_API_KEY"3. Generate Song
POST /v1/song/music/create
| Parameter | Type | Required | Description |
|---|---|---|---|
| model | string | yes | Currently only sensesong |
| lyrics | string | no | Song lyrics (use format from lyrics API) |
| instrumental | bool | no | true for instrumental (no vocals) |
| style | string | no | Music style (e.g. "pop", "rock", "jazz") |
| style_weight | string | no | Style weight 0–1 |
| title | string | no | Song title |
| vocal_gender | string | no | f = female, m = male |
| negative_tags | string | no | Style elements to exclude |
Response:
{"task_id": "50f979f5-2b9e-4254-8653-c277644a31fa"}curl -X POST https://api.senseaudio.cn/v1/song/music/create \
-H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "sensesong",
"lyrics": "[verse] Your lyrics here...",
"style": "pop",
"vocal_gender": "f",
"title": "My Song"
}'4. Poll Song (Async)
GET /v1/song/music/pending/:task_id
Response:
{
"task_id": "50f979f5-...",
"status": "SUCCESS",
"response": {
"task_id": "50f979f5-...",
"data": [
{
"audio_url": "https://...",
"lyrics": "...",
"duration": 110
}
]
}
}Status values: PENDING | SUCCESS | FAILED
curl https://api.senseaudio.cn/v1/song/music/pending/{task_id} \
-H "Authorization: Bearer $SENSEAUDIO_API_KEY"Python Example (Full Flow)
import requests
import time
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
BASE = "https://api.senseaudio.cn"
# Step 1: Generate lyrics
resp = requests.post(f"{BASE}/v1/song/lyrics/create",
headers=HEADERS,
json={"prompt": "一首关于夏天的流行歌曲", "provider": "sensesong"})
lyrics_data = resp.json()
lyrics_text = lyrics_data["data"][0]["text"]
# Step 2: Generate song
resp = requests.post(f"{BASE}/v1/song/music/create",
headers=HEADERS,
json={"model": "sensesong", "lyrics": lyrics_text, "style": "pop", "vocal_gender": "f"})
task_id = resp.json()["task_id"]
# Step 3: Poll for result
while True:
resp = requests.get(f"{BASE}/v1/song/music/pending/{task_id}", headers=HEADERS)
result = resp.json()
if result["status"] == "SUCCESS":
print("Audio URL:", result["response"]["data"][0]["audio_url"])
break
elif result["status"] == "FAILED":
print("Failed")
break
time.sleep(5)SenseAudio 音乐生成
SenseAudio 提供 AI 驱动的音乐生成 API，支持歌词生成和完整歌曲生成。标准工作流程：
- 生成歌词（同步或异步）
- 使用歌词生成歌曲（异步，返回
task_id） - 轮询获取结果
基础 URL： https://api.senseaudio.cn 鉴权： Authorization: Bearer $SENSEAUDIO_API_KEY
1. 音乐歌词生成请求
POST /v1/song/lyrics/create
- 原始链接：https://senseaudio.cn/docs/song/lyrics_create
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| prompt | string | 是 | 歌词生成提示词 |
| provider | string | 是 | 模型，目前只支持 sensesong |
同步响应示例：
{
"data": [
{
"text": "[intro-medium] ; [verse] We stand upon the edge of dawn... ; [chorus] Rise up now...",
"title": ""
}
]
}异步响应： 返回 task_id，需通过歌词轮询接口获取结果。
2. 音乐歌词轮询
GET /v1/song/lyrics/pending/:task_id
- 原始链接：https://senseaudio.cn/docs/song/lyrics_pending
使用创建歌词任务得到的异步任务 ID 获取歌词数据。
响应示例：
{
"task_id": "bcee6b21-dcf9-44d1-9b85-7bfef0e840db",
"status": "SUCCESS",
"response": {
"task_id": "bcee6b21-dcf9-44d1-9b85-7bfef0e840db",
"data": [{"text": "...", "title": ""}]
}
}任务状态：PENDING（处理中）| SUCCESS（成功）| FAILED（失败）
3. 音乐歌曲生成请求
POST /v1/song/music/create
- 原始链接：https://senseaudio.cn/docs/song/music_create
| 参数名 | 类型 | 必填 | 描述 |
|---|---|---|---|
| model | string | 是 | 模型，目前只能使用 sensesong |
| lyrics | string | 否 | 歌词内容 |
| instrumental | bool | 否 | 是否为纯音乐（无人声） |
| style | string | 否 | 歌曲风格（如 "pop"、"rock"） |
| style_weight | string | 否 | 风格权重，取值 0–1 |
| title | string | 否 | 歌曲标题 |
| vocal_gender | string | 否 | 人声性别：f 女性，m 男性 |
| negative_tags | string | 否 | 排除的风格元素 |
响应示例：
{"task_id": "50f979f5-2b9e-4254-8653-c277644a31fa"}4. 音乐歌曲轮询
GET /v1/song/music/pending/:task_id
- 原始链接：https://senseaudio.cn/docs/song/music_pending
使用创建歌曲任务得到的异步任务 ID 获取歌曲数据。
响应示例：
{
"task_id": "50f979f5-...",
"status": "SUCCESS",
"response": {
"task_id": "50f979f5-...",
"data": [
{
"audio_url": "https://...",
"lyrics": "...",
"duration": 110
}
]
}
}任务状态：PENDING（处理中）| SUCCESS（成功）| FAILED（失败）
完整调用示例（Python）
import requests
import time
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}
BASE = "https://api.senseaudio.cn"
# 第一步：生成歌词
resp = requests.post(f"{BASE}/v1/song/lyrics/create",
headers=HEADERS,
json={"prompt": "一首关于夏天的流行歌曲", "provider": "sensesong"})
lyrics_text = resp.json()["data"][0]["text"]
# 第二步：生成歌曲
resp = requests.post(f"{BASE}/v1/song/music/create",
headers=HEADERS,
json={"model": "sensesong", "lyrics": lyrics_text, "style": "pop", "vocal_gender": "f"})
task_id = resp.json()["task_id"]
# 第三步：轮询结果
while True:
resp = requests.get(f"{BASE}/v1/song/music/pending/{task_id}", headers=HEADERS)
result = resp.json()
if result["status"] == "SUCCESS":
print("音频地址：", result["response"]["data"][0]["audio_url"])
break
elif result["status"] == "FAILED":
print("生成失败")
break
time.sleep(5)