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

create 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 '{
    "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",
    "style_weight":0.5,
    "weirdness_constraint":0.5,
    "negative_tags":"piano",
    "gpt_description_prompt":"",
    "make_instrumental": false,
    "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
custom_mode
boolean 
required
If you want to customize the lyrics, this option should be true.
prompt
string 
required
song lyrics, should be less than 3000 characters
title
string 
optional
song title, should be less than 80 characters
tags
string 
optional
song tags, should be less than 200 characters
style_weight
number 
optional
The weight of the tags field
>= 0<= 1
weirdness_constraint
number 
optional
The randomness or weirdness of the song
>= 0<= 1
negative_tags
string 
optional
Elements you want to avoid in your songs
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
make_instrumental
boolean 
optional
instrumental mode
gpt_description_prompt
string 
optional
description of the music
Examples

Responses

🟢200success
application/json
Body
message
string 
required
task_id
string 
required
Modified at 2025-07-20 17:04:14
Previous
Suno Instructions
Next
extend music
Built with