查询歌曲生成状态

使用创建歌曲任务得到的异步任务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

Python

JavaScript

bash

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

查询歌曲生成状态

使用创建歌曲任务得到的异步任务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

Python

JavaScript

bash

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