AI Music API
  1. nuro
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. nuro

get music

GET
/api/v1/nuro/task/{task_id}
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.sunoapi.com/api/v1/nuro/task/'
Response Response Example
{
    "task_id": "4c35433b-1649-433d-b513-8422af70fbaa",
    "status": "succeeded",
    "progress": 100,
    "audio_url": "https://cdn.musicapi.ai/storage/v1/object/public/songs/song-4c35433b-1649-433d-b513-8422af70fbaa.wav",
    "lyrics": "[intro]\n[verse]\nWe were both young when I first saw you I close my eyes and the flashback starts I'm standin' there On a balcony in summer air\nSee the lights see the party the ball gowns See you make your way through the crowd And say 'Hello' Little did I know\n[bridge]\nThat you were Romeo you were throwin' pebbles And my daddy said 'Stay away from Juliet' And I was cryin' on the staircase Escape this town for a little while oh oh\n[chorus]\nAnd said 'Marry me Juliet You'll never have to be alone I love you and that's all I really know I talked to your dad go pick out a white dress It's a love story baby just say 'Yes''\n[inst]\n[verse]\nInstrumental break\n[bridge]\nI got tired of waiting Wondering if you were ever coming around My faith in you was fading When I met you on the outskirts of town\n[chorus]\nAnd I said 'Romeo save me I've been feeling so alone I keep waiting for you but you never come Is this in my head I don't know what to think'\n[inst]\n[verse]\nI talked to your dad go pick out a white dress It's a love story baby just say 'Yes' Oh oh oh 'Cause we were both young when I first saw you\n[outro]",
    "duration": 199.04325,
    "genre": "Pop",
    "mood": "Dynamic/Energetic",
    "gender": "Female",
    "timbre": "Sweet_AUDIO_TIMBRE"
}

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
task id

Responses

🟢200success
application/json
Body
task_id
string 
required
task id
status
enum<string> 
required
task status, When "succeeded", it means the song is generated.
Allowed values:
pendingrunningsucceeded
progress
integer 
required
The song generation progress, when it is 100, it means the song was generated successfully
<= 100
audio_url
string 
required
Online audio URL in wav format
lyrics
string 
required
song lyrics
duration
number 
required
song duration
genre
string 
required
genre of the song
mood
string 
required
mood of the song
gender
string 
required
gender of the song
timbre
string 
required
timbre of the song
Modified at 2025-07-15 14:59:12
Previous
create instrument music
Next
Make Lyrics
Built with