音乐歌曲轮询

使用创建歌曲任务得到的异步任务ID获取歌曲数据。

接口概览

接口地址: https://api.senseaudio.cn/v1/music/song/pending/:task_id
请求方式: GET
鉴权方式: Bearer Token

请求配置

请求头 (Request Headers)

参数名	必填	说明	示例
Authorization	是	鉴权 Token。格式：Bearer SENSEAUDIO_API_KEY	Bearer sk-123456…

路径参数 (Path Parameter)

参数名	类型	必填	描述
task_id	string	是	异步任务 ID

响应结构

参数名	类型	描述
response	object	任务响应数据
task_id	string	任务 ID
status	string	任务状态：`PENDING`代表任务还未执行完毕，`SUCCESS`代表任务执行成功，`FAILED`代表任务执行失败

response 对象结构

参数名	类型	描述
task_id	string	任务 ID
data	array	状态为成功时此项存储生成的歌曲数据

data 对象结构

参数名	类型	描述
audio_url	string	歌曲下载地址
cover_url	string	歌曲封面下载地址
duration	int	时长（秒）
id	string	歌曲 ID
lyrics	string	歌词
title	string	曲目标题

响应示例

json

复制

{
  "task_id": "50f979f5-2b9e-4254-8653-c277644a31fa",
  "status": "SUCCESS",
  "response": {
    "task_id": "50f979f5-2b9e-4254-8653-c277644a31fa",
    "data": [
      {
        "id": "4d665c9e-bda2-4aff-891f-1822c4a7543f",
        "title": "战歌",
        "audio_url": "https://example.com/audio",
        "cover_url": "https://example.com/cover",
        "lyrics": "[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]",
        "duration": 110
      }
    ]
  }
}

代码示例

CURL

bash

复制

curl "https://api.senseaudio.cn/v1/music/song/pending/50f979f5-2b9e-4254-8653-c277644a31fa" \
  -H "Authorization: Bearer $SENSEAUDIO_API_KEY"

Python

python

复制

import requests
 
API_URL = "https://api.senseaudio.cn/v1/music/song/pending/"
HEADERS = {
    "Authorization": "Bearer SENSEAUDIO_API_KEY"
}
 
def pending(task_id):
    resp = requests.get(API_URL + task_id, headers=HEADERS)
    if resp.status_code == 200:
        return resp.json()
    return None
 
result = pending("50f979f5-2b9e-4254-8653-c277644a31fa")

JavaScript

javascript

复制

const axios = require('axios');
 
const API_URL = 'https://api.senseaudio.cn/v1/music/song/pending/';
const HEADERS = {
    'Authorization': 'Bearer SENSEAUDIO_API_KEY'
};
 
async function pending(task_id) {
    try {
        const res = await axios.get(API_URL + task_id, { headers: HEADERS });
        return res.data;
    } catch (err) {
        console.error('请求失败:', err.message);
        return null;
    }
}
 
pending("50f979f5-2b9e-4254-8653-c277644a31fa").then(result => {
    console.log(result);
});