---

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: - SENSEAUDIO_API_KEY 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:

1. Generate lyrics (sync or async)
2. Generate a song using the lyrics (async, returns task_id)
3. 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，支持歌词生成和完整歌曲生成。标准工作流程：

1. 生成歌词（同步或异步）
2. 使用歌词生成歌曲（异步，返回 task_id）
3. 轮询获取结果

基础 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)