音乐歌曲生成请求

请求生成歌曲。

接口概览

接口地址: https://api.senseaudio.cn/v1/music/song/create
请求方式: POST
Content-Type: application/json
鉴权方式: Bearer Token

请求配置

请求头 (Request Headers)

参数名	必填	说明	示例
Authorization	是	鉴权 Token。格式：Bearer SENSEAUDIO_API_KEY	Bearer sk-123456…
Content-Type	是	内容类型。固定为 application/json	application/json

请求参数 (Request Body)

必填参数

参数名	类型	必填	描述
model	string	是	模型，目前只能使用`senseaudio-music-1.0-260319`
custom_mode	bool	否	是否传入提示词而不是歌词
instrumental	bool	否	是否为纯音乐，纯音乐仍然需要传入歌词或提示词
lyrics	string	是	歌词或提示词，传入歌词时需要按照下文中的格式输入，提示词则无限制，不能超过 2000 码位
negative_tags	string	否	负面标签，排除的风格元素
style	string	否	歌曲风格
style_weight	float	否	风格权重 0-1
title	string	否	歌曲标题
vocal_gender	string	否	歌曲中人声的性别，`f`代表女性，`m`代表男性

歌词格式

歌词由多个歌曲段组成，每个段以结构标签开头。模型通过这些标签引导歌曲结构和歌词发展。

标签	段落类型	是否需要歌词	时长参考	说明
[intro-short]	前奏 Intro	❌ 无歌词	~0–10 秒	短前奏，纯伴奏引入
[intro-medium]	前奏 Intro	❌ 无歌词	~10–20 秒	中长前奏版本
[inst-short]	纯伴奏段	❌ 无歌词	~0–10 秒	中间的器乐演奏段
[inst-medium]	纯伴奏段	❌ 无歌词	~10–20 秒	较长的器乐段
[outro-short]	尾奏 Outro	❌ 无歌词	~0–10 秒	短尾部收束
[outro-medium]	尾奏 Outro	❌ 无歌词	~10–20 秒	中长尾部收束
[verse]	主歌 Verse	✅ 需要歌词	无固定时长	承担叙事内容，应有完整句子
[chorus]	副歌 Chorus	✅ 需要歌词	无固定时长	歌曲主题部分，应朗朗上口
[bridge]	过渡 Bridge	✅ 需要歌词	无固定时长	连接主歌与副歌，增强情绪转换

响应结构

参数名	类型	描述
task_id	string	任务 ID

响应示例

json

复制

{
  "task_id": "50f979f5-2b9e-4254-8653-c277644a31fa"
}

代码示例

CURL

bash

复制

curl -X POST "https://api.senseaudio.cn/v1/music/song/create" \
  -H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "lyrics": "[intro-medium] ; [verse] Wake up from the shadows! ; Rise up with your fire! ; Break the chains that hold you down! ; [chorus] Roar like a lion! ; Conquer the storm! ; We are the unstoppable force! ; [bridge] Nothing can stop us now! ; [outro-short] ; [inst-short]",
    "model": "senseaudio-music-1.0-260319",
    "title": "战歌",
    "vocal_gender": "m"
  }'

Python

python

复制

import requests
 
API_URL = "https://api.senseaudio.cn/v1/music/song/create"
HEADERS = {
    "Authorization": "Bearer SENSEAUDIO_API_KEY",
    "Content-Type": "application/json"
}
 
def create(data):
    resp = requests.post(API_URL, headers=HEADERS, json=data)
    if resp.status_code == 200:
        return resp.json()
    return None
 
result = create({
  "lyrics": "[intro-medium] ; [verse] Wake up from the shadows! ; Rise up with your fire! ; Break the chains that hold you down! ; [chorus] Roar like a lion! ; Conquer the storm! ; We are the unstoppable force! ; [bridge] Nothing can stop us now! ; [outro-short] ; [inst-short]",
  "model": "senseaudio-music-1.0-260319",
  "title": "战歌",
  "vocal_gender": "m"
})

JavaScript

javascript

复制

const axios = require('axios');
 
const API_URL = 'https://api.senseaudio.cn/v1/music/song/create';
const HEADERS = {
    'Authorization': 'Bearer SENSEAUDIO_API_KEY',
    'Content-Type': 'application/json'
};
 
async function create(data) {
    try {
        const res = await axios.post(API_URL, data, { headers: HEADERS });
        return res.data;
    } catch (err) {
        console.error('请求失败:', err.message);
        return null;
    }
}
 
create({
  "lyrics": "[intro-medium] ; [verse] Wake up from the shadows! ; Rise up with your fire! ; Break the chains that hold you down! ; [chorus] Roar like a lion! ; Conquer the storm! ; We are the unstoppable force! ; [bridge] Nothing can stop us now! ; [outro-short] ; [inst-short]",
  "model": "senseaudio-music-1.0-260319",
  "title": "战歌",
  "vocal_gender": "m"
}).then(result => {
    console.log(result);
});