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

extend music

POST
/api/v1/suno/create
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.sunoapi.com/api/v1/suno/create' \
--header 'Content-Type: application/json' \
--data-raw '{
    "task_type":"extend_music",
    "custom_mode": true,
    "prompt": "[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",
    "title": "Starts",
    "tags": "pop",
    "continue_clip_id": "a533515b-56c9-4eb2-8cb8-7f3dfa165eb8",
    "continue_at": 30,
    "mv": "chirp-v3-5"
}'
Response Response Example
{
    "message": "success",
    "task_id": "468d0e42-f7a6-40ce-9a4c-37db56b13b99"
}

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params application/json
task_type
string 
required
Task type, can be create_music, extend_music, concat_music, cover_music, extend_upload_music, persona_music
custom_mode
boolean 
required
If you want to customize the lyrics, this option should be true.
prompt
string 
required
song lyrics
title
string 
optional
song title
tags
string 
optional
song styles
continue_clip_id
string 
required
The clip id of the song to be extended
continue_at
integer 
required
The starting number of seconds to extend
mv
enum<string> 
required
music model, which can be chrip-v3-5, chrip-v4,chrip-v4-5
Allowed values:
chirp-v3-5chirp-v4chirp-v4-5chirp-v4-5-plus
Examples

Responses

🟢200success
application/json
Body
message
string 
required
task_id
string 
required
Modified at 2025-07-20 17:04:15
Previous
create music
Next
concat music
Built with