批量查询任务

POST  v1/suno/fetch

请求参数

Authorization

在 Header 添加参数 Authorization，其值为在 Bearer 之后拼接 Token。

Authorization: Bearer ******************

Body 参数

Content-Type: application/json

参数名	类型	必填	说明
ids	array[string]	必需	目标ID列表。这是一个字符串数组，包含了需要被操作的所有对象的唯一标识符。例如：["id_1", "id_2", "id_3"]。
action	string	必需	操作指令。定义了要对上述 ID 列表执行的具体动作。

请求示例 (JSON)

{
    "ids": [
        "task_id"
    ],
    "action": "MUSIC"
}

返回响应

200 成功

Content-Type: application/json

响应参数

字段名	类型	必填	说明
id	string	必需	任务 ID。该绘画任务的唯一标识符。
action	string	必需	操作类型。例如 IMAGINE（生成）、UPSCALE（放大）、VARIATION（变体）等。
status	string	必需	当前状态。如 SUBMITTED（已提交）、IN_PROGRESS（进行中）、SUCCESS（成功）、FAILURE（失败）。
state	string	必需	内部状态。通常用于传递自定义的上下文或追踪状态。
progress	string	必需	生成进度。例如 "100%" 或具体的百分比字符串。
prompt	string	必需	原始提示词。用户提交的原始 Prompt 文本。
promptEn	string	必需	英文提示词。经过翻译或处理后的英文 Prompt。
description	string	必需	任务描述。对当前任务状态的简短文字说明。
imageUrl	string	必需	图片链接。生成结果的图片 URL 地址。
failReason	string	必需	失败原因。如果任务失败，这里会包含具体的错误信息；成功则为空。
submitTime	integer	必需	提交时间戳。任务被提交时的 Unix 时间戳。
startTime	integer	必需	开始时间戳。任务正式开始处理的时间戳。
finishTime	integer	必需	完成时间戳。任务结束（无论成功或失败）的时间戳。
properties	object	必需	属性对象。包含任务的额外配置或元数据信息。
buttons	array [object]	必需	交互按钮。返回可供下一步操作的按钮数组（如 U1-U4, V1-V4 等）。
├─ customId	string	可选	按钮的唯一标识符，用于回调操作。
├─ emoji	string	可选	按钮上显示的 Emoji 图标。
├─ label	string	可选	按钮上显示的文字标签。
├─ style	integer	可选	按钮的样式代码（如主要、次要等）。
└─ type	integer	可选	按钮的类型代码。

响应示例

[
    {
        "action": "IMAGINE",
        "buttons": [
            {
                "customId": "string",
                "emoji": "string",
                "label": "string",
                "style": 0,
                "type": 0
            }
        ],
        "description": "string",
        "failReason": "string",
        "finishTime": 0,
        "id": "string",
        "imageUrl": "string",
        "progress": "string",
        "prompt": "string",
        "promptEn": "string",
        "properties": {},
        "startTime": 0,
        "state": "string",
        "status": "NOT_START",
        "submitTime": 0
    }
]

示例代码

import http.client
import json

conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({
   "ids": [
      "task_id"
   ],
   "action": "MUSIC"
})
headers = {
   'Authorization': 'Bearer <token>',
   'Content-Type': 'application/json'
}
conn.request("POST", "/v1/suno/fetch", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))