AI Music API
  1. suno
AI Music API
  • Introduction
  • Credits Usage Guide
  • Error handling
  • suno
    • Suno Instructions
    • create music
      POST
    • extend music
      POST
    • concat music
      POST
    • cover music
      POST
    • create persona
      POST
    • create music with persona
      POST
    • upload music
      POST
    • get music
      GET
  • riffusion
    • Riffusion instructions
    • create music (with lyrics)
      POST
    • create music (with description)
      POST
    • cover music
      POST
    • extend music
      POST
    • replace music section
      POST
    • swap music sound
      POST
    • swap music vocals
      POST
    • upload
      POST
    • get music
      GET
  • nuro
    • Nuro Instruction
    • Error handling
    • create vocal music
      POST
    • create instrument music
      POST
    • get music
      GET
  • lyrics generation
    • Make Lyrics
  • get-credits
    GET
  1. suno

get music

GET
/api/v1/suno/task/{task_id}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.sunoapi.com/api/v1/suno/task/'
Response Response Example
{
    "code": 200,
    "data": [
        {
            "clip_id": "26c9c592-0566-46cf-bb71-91ac1deaa7b5",
            "state": "succeeded",
            "title": "Starts",
            "tags": "pop",
            "lyrics": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
            "image_url": "https://cdn2.suno.ai/image_26c9c592-0566-46cf-bb71-91ac1deaa7b5.jpeg",
            "audio_url": "https://cdn1.suno.ai/26c9c592-0566-46cf-bb71-91ac1deaa7b5.mp3",
            "video_url": "https://cdn1.suno.ai/26c9c592-0566-46cf-bb71-91ac1deaa7b5.mp4",
            "created_at": "2024-11-27T10:26:46.552Z",
            "mv": "chirp-v3-5",
            "gpt_description_prompt": null,
            "duration": 179
        },
        {
            "clip_id": "626f2fb1-b1cb-43e3-aabd-7ef64e1ab6b0",
            "state": "succeeded",
            "title": "Starts",
            "tags": "pop",
            "lyrics": "[Verse]\nStars they shine above me\nMoonlight softly glows\nWhispers in the night sky\nDreams that only grow\n\n[Verse 2]\nMidnight winds are calling\nCarrying a tune\nHeartbeats echo softly\nDancing with the moon\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way\n\n[Verse 3]\nShadows move and twinkle\nNighttime come alive\nMystery in the heavens\nStories that survive\n\n[Bridge]\nMagic fills the darkness\nWonder in the air\nEvery star a secret\nIn the sky I stare\n\n[Chorus]\nStarry night starry night\nLet your light ignite ignite\nBright as day bright as day\nGuide my way guide my way",
            "image_url": "https://cdn2.suno.ai/image_626f2fb1-b1cb-43e3-aabd-7ef64e1ab6b0.jpeg",
            "audio_url": "https://cdn1.suno.ai/626f2fb1-b1cb-43e3-aabd-7ef64e1ab6b0.mp3",
            "video_url": "https://cdn1.suno.ai/626f2fb1-b1cb-43e3-aabd-7ef64e1ab6b0.mp4",
            "created_at": "2024-11-27T10:26:46.552Z",
            "mv": "chirp-v3-5",
            "gpt_description_prompt": null,
            "duration": 208
        }
    ],
    "message": "success"
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Path Params
task_id
string 
required

Responses

🟢200success
application/json
Body
code
integer 
required
data
array [object {12}] 
required
clip_id
string 
required
title
string 
required
tags
string 
required
lyrics
string 
required
image_url
string 
required
audio_url
string 
required
video_url
string 
required
created_at
string 
required
mv
string 
required
gpt_description_prompt
null 
required
duration
integer 
required
state
string 
required
pending;running;succeeded
message
string 
required
Modified at 2025-07-14 17:19:25
Previous
upload music
Next
Riffusion instructions
Built with