音乐歌词生成请求

请求生成歌词。

接口概览

接口地址: https://api.senseaudio.cn/v1/music/lyrics/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)

必填参数

参数名	类型	必填	描述
prompt	string	是	提示词（必填），不能超过 2000 码位
provider	string	是	模型（必填），目前只支持`senseaudio-music-1.0-260319`

响应结构

参数名	类型	描述
data	array	如果此模型为同步生成模型，则此项存在且包含生成的歌词数据

data 对象结构

参数名	类型	描述
text	string	生成的歌词
title	string	与此歌词相应的曲目标题，可能为空

响应示例

json

复制

{
  "data": [
    {
      "text": "[intro-medium] ; [verse] We stand upon the edge of dawn. The fire burns within our chest. ; [chorus] Rise up now and take the reigns. Break the chains that hold us down. ; [bridge] No voice can silence our song. We will march until the end. ; [outro-medium]",
      "title": ""
    }
  ]
}

代码示例

CURL

bash

复制

curl -X POST "https://api.senseaudio.cn/v1/music/lyrics/create" \
  -H "Authorization: Bearer $SENSEAUDIO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "一段慷慨激昂的歌词",
    "provider": "senseaudio-music-1.0-260319"
  }'

Python

python

复制

import requests
 
API_URL = "https://api.senseaudio.cn/v1/music/lyrics/create"
HEADERS = {
    "Authorization": "Bearer SENSEAUDIO_API_KEY",
    "Content-Type": "application/json"
}
 
def create(prompt, provider):
    data = {
        "prompt": prompt,
        "provider": provider,
    }
    resp = requests.post(API_URL, headers=HEADERS, json=data)
    if resp.status_code == 200:
        return resp.json()
    return None
 
result = create("一段慷慨激昂的歌词", "senseaudio-music-1.0-260319")

JavaScript

javascript

复制

const axios = require('axios');
 
const API_URL = 'https://api.senseaudio.cn/v1/music/lyrics/create';
const HEADERS = {
    'Authorization': 'Bearer SENSEAUDIO_API_KEY',
    'Content-Type': 'application/json'
};
 
async function create(prompt, provider) {
    const data = {
        prompt: prompt,
        provider: provider,
    };
 
    try {
        const res = await axios.post(API_URL, data, { headers: HEADERS });
        return res.data;
    } catch (err) {
        console.error('请求失败:', err.message);
        return null;
    }
}
 
create("一段慷慨激昂的歌词", "senseaudio-music-1.0-260319").then(result => {
    console.log(result);
});