批量查询任务 - API reference

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Query Params

string

optional

Header Params

string

optional

Authorization

string

optional

Default:

Body Params application/json

ids

array[string]

required

task_id 列表

action

string

required

操作：MUSIC、LYRICS

Example

{
  "ids": [
    "string"
  ],
  "action": "string"
}

Responses

🟢200成功

application/json

Body

code

string

required

message

string

required

data

array [object {10}]

required

task_id

string

optional

notify_hook

string

optional

action

string

optional

status

string

optional

fail_reason

string

optional

submit_time

integer

optional

start_time

integer

optional

finish_time

integer

optional

progress

string

optional

data

array [object {10}]

optional

Example

{
  "code": "success",
  "message": "",
  "data": [
    {
      "task_id": "346c5d10-a4a1-4f49-a851-66a7dae6cfaf",
      "notify_hook": "",
      "action": "MUSIC",
      "status": "IN_PROGRESS",
      "fail_reason": "",
      "submit_time": 1716191749,
      "start_time": 1716191786,
      "finish_time": 0,
      "progress": "0%",
      "data": [
        {
          "id": "e9893d04-6a63-4007-8473-64b706eca4d1",
          "title": "Electric Dance Party",
          "status": "streaming",
          "metadata": {
            "tags": "club banger high-energy edm",
            "prompt": "[Verse]\nEverybody in the place\nLet's go\nJump and dance\nFeel the rhythm\nLose control (ooh-yeah!)\nHands up in the air\nIt's time to show\nMove your body like you're on a roll\n\nShake it to the left\nShake it to the right\nFeel the bass\nFeel the beat\nAll night (ooh-yeah!)\nMiku's in the house\nGonna set the stage on fire\nGet ready for a wild ride\nIt's our desire\n\n[Verse 2]\nLights are flashing\nColors everywhere (ooh-yeah!)\nFeel the energy\nIt's in the air\nWe're unstoppable\nNothing can bring us down\nDancing to the beat\nThe whole world around",
            "duration": null,
            "error_type": null,
            "error_message": null,
            "audio_prompt_id": null,
            "gpt_description_prompt": "miku dance"
          },
          "audio_url": "https://audiopipe.suno.ai/?item_id=e9893d04-6a63-4007-8473-64b706eca4d1",
          "image_url": "https://cdn1.suno.ai/image_e9893d04-6a63-4007-8473-64b706eca4d1.png",
          "video_url": "",
          "model_name": "chirp-v3",
          "image_large_url": "https://cdn1.suno.ai/image_large_e9893d04-6a63-4007-8473-64b706eca4d1.png",
          "major_model_version": "v3"
        },
        {
          "id": "fe69611b-fc72-4f6e-b476-5eef0b88c2e3",
          "title": "Electric Dance Party",
          "status": "streaming",
          "metadata": {
            "tags": "club banger high-energy edm",
            "prompt": "[Verse]\nEverybody in the place\nLet's go\nJump and dance\nFeel the rhythm\nLose control (ooh-yeah!)\nHands up in the air\nIt's time to show\nMove your body like you're on a roll\n\nShake it to the left\nShake it to the right\nFeel the bass\nFeel the beat\nAll night (ooh-yeah!)\nMiku's in the house\nGonna set the stage on fire\nGet ready for a wild ride\nIt's our desire\n\n[Verse 2]\nLights are flashing\nColors everywhere (ooh-yeah!)\nFeel the energy\nIt's in the air\nWe're unstoppable\nNothing can bring us down\nDancing to the beat\nThe whole world around",
            "duration": null,
            "error_type": null,
            "error_message": null,
            "audio_prompt_id": null,
            "gpt_description_prompt": "miku dance"
          },
          "audio_url": "https://audiopipe.suno.ai/?item_id=fe69611b-fc72-4f6e-b476-5eef0b88c2e3",
          "image_url": "https://cdn1.suno.ai/image_fe69611b-fc72-4f6e-b476-5eef0b88c2e3.png",
          "video_url": "",
          "model_name": "chirp-v3",
          "image_large_url": "https://cdn1.suno.ai/image_large_fe69611b-fc72-4f6e-b476-5eef0b88c2e3.png",
          "major_model_version": "v3"
        }
      ]
    }
  ]
}