查询任务 - 帮助/API文档

支持,返回结果无code层级
{{BASE_URL}}/suno/feed/{task_id}
支持查询歌词，返回结果无code层级
{{BASE_URL}}/suno/lyrics/{task_id}

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

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

Path 参数

task_id

string

任务ID

必需

Header 参数

Authorization

string

可选

示例值:

Bearer {{YOUR_API_KEY}}

Content-Type

string

可选

示例值:

application/json

string

可选

示例值:

application/json

Body 参数application/json

object {0}

示例

{}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

data

object

必需

task_id

string

必需

action

string

必需

status

string

必需

fail_reason

string

必需

submit_time

integer

必需

start_time

integer

必需

finish_time

integer

必需

progress

string

必需

data

array [object {22}]

必需

string

必需

示例

{
  "code": "success",
  "message": "",
  "data": {
    "task_id": "64dc8d98-5812-40f5-a99b-79a590452040",
    "action": "MUSIC",
    "status": "SUCCESS",
    "fail_reason": "",
    "submit_time": 1730776470,
    "start_time": 1730776481,
    "finish_time": 1730776576,
    "progress": "100%",
    "data": [
      {
        "id": "95afcdae-0719-4e22-9307-7d473b3f8624",
        "title": "City Lights",
        "handle": "disconcertedencore5997",
        "status": "complete",
        "user_id": "8b75dd78-7ca5-4d5b-8e3b-b2914697ad1e",
        "is_liked": false,
        "metadata": {
          "tags": "emotional punk",
          "type": "gen",
          "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
          "stream": true,
          "history": null,
          "duration": 120,
          "error_type": null,
          "error_message": null,
          "concat_history": null,
          "refund_credits": false,
          "audio_prompt_id": null,
          "gpt_description_prompt": null
        },
        "reaction": null,
        "audio_url": "https://cdn1.suno.ai/95afcdae-0719-4e22-9307-7d473b3f8624.mp3",
        "image_url": "https://cdn2.suno.ai/image_95afcdae-0719-4e22-9307-7d473b3f8624.jpeg",
        "is_public": false,
        "video_url": "https://cdn1.suno.ai/95afcdae-0719-4e22-9307-7d473b3f8624.mp4",
        "created_at": "2024-11-05T03:14:30.687Z",
        "is_trashed": false,
        "model_name": "chirp-v3",
        "play_count": 0,
        "display_name": "DisconcertedEncore5997",
        "upvote_count": 0,
        "image_large_url": "https://cdn2.suno.ai/image_large_95afcdae-0719-4e22-9307-7d473b3f8624.jpeg",
        "is_video_pending": false,
        "is_handle_updated": false,
        "major_model_version": "v3"
      },
      {
        "id": "cfe8403c-9986-47bf-a300-06ad12368a8d",
        "title": "City Lights",
        "handle": "disconcertedencore5997",
        "status": "complete",
        "user_id": "8b75dd78-7ca5-4d5b-8e3b-b2914697ad1e",
        "is_liked": false,
        "metadata": {
          "tags": "emotional punk",
          "type": "gen",
          "prompt": "[Verse]\nWalking down the streets\nBeneath the city lights\nNeon signs flickering\nLighting up the night\nHeart beating faster\nLike a drum in my chest\nI'm alive in this moment\nFeeling so blessed\n\nStilettos on the pavement\nStepping with grace\nSurrounded by the people\nMoving at their own pace\nThe rhythm of the city\nIt pulses in my veins\nLost in the energy\nAs my worries drain\n\n[Verse 2]\nConcrete jungle shining\nWith its dazzling glow\nEvery corner hiding secrets that only locals know\nA symphony of chaos\nBut it's music to my ears\nThe hustle and the bustle\nWiping away my fears",
          "stream": true,
          "history": null,
          "duration": 120,
          "error_type": null,
          "error_message": null,
          "concat_history": null,
          "refund_credits": false,
          "audio_prompt_id": null,
          "gpt_description_prompt": null
        },
        "reaction": null,
        "audio_url": "https://cdn1.suno.ai/cfe8403c-9986-47bf-a300-06ad12368a8d.mp3",
        "image_url": "https://cdn2.suno.ai/image_cfe8403c-9986-47bf-a300-06ad12368a8d.jpeg",
        "is_public": false,
        "video_url": "https://cdn1.suno.ai/cfe8403c-9986-47bf-a300-06ad12368a8d.mp4",
        "created_at": "2024-11-05T03:14:30.687Z",
        "is_trashed": false,
        "model_name": "chirp-v3",
        "play_count": 0,
        "display_name": "DisconcertedEncore5997",
        "upvote_count": 0,
        "image_large_url": "https://cdn2.suno.ai/image_large_cfe8403c-9986-47bf-a300-06ad12368a8d.jpeg",
        "is_video_pending": true,
        "is_handle_updated": false,
        "major_model_version": "v3"
      }
    ]
  },
  "id": ""
}