Skip to main content

​
Suno Model

Unofficial API — sunor is not affiliated with, endorsed by, or officially connected to Suno Inc. This is a third-party integration that provides programmatic access to Suno’s music generation capabilities.
Suno is an AI music generation model that can create songs with vocals, instrumental tracks, and lyrics from text descriptions.

​
Available task types

Task TypeCreditsDescription
music10Generate a complete music clip with audio and optional vocals
lyrics5Generate song lyrics from a text prompt
upload1Upload an audio file for use as input to other tasks
concat5Concatenate clips into a longer composition

​
Model version

sunor defaults to Suno V5.5 (chirp-fenix) — the latest model with the best audio quality, improved vocals, and instrumentation. V5 (chirp-crow) is also available. The model version is automatically set to V5.5 and does not need to be specified in requests. Pricing is the same for both versions.

​
V5 vs V5.5

V5 (chirp-crow)V5.5 (chirp-fenix)
Audio qualityGoodImproved — cleaner mix, less artifacts
VocalsNaturalMore expressive, better pronunciation
Style adherenceGoodMore accurate to tags and descriptions
InstrumentationStandardRicher, more detailed arrangements
Pricing10 credits10 credits
API parametersSameSame — no code changes needed

​
Music generation modes

​
Inspiration mode

The simplest way to generate music. Provide a natural language description and let the AI handle everything — lyrics, melody, arrangement, and production. When to use: You have a general idea but want the AI to make creative decisions. 
{
  "model": "suno",
  "task_type": "music",
  "input": {
    "gpt_description_prompt": "An upbeat electronic dance track with a catchy synth melody",
    "make_instrumental": false
  }
}
Key fields:
  • gpt_description_prompt — Describe the music you want in plain language
  • make_instrumental — Set to true if you want no vocals

​
Custom mode

Full control over lyrics and style. You provide the exact lyrics and specify genre/style tags. When to use: You have specific lyrics or want precise genre control. 
{
  "model": "suno",
  "task_type": "music",
  "input": {
    "prompt": "[Verse]\nStars are falling from the sky\nDancing shadows passing by\n\n[Chorus]\nWe are the dreamers of the night\nChasing every fading light",
    "tags": "indie rock, dreamy, reverb, female vocals",
    "negative_tags": "heavy metal, rap",
    "title": "Dreamers of the Night"
  }
}
Key fields:
  • prompt — Your lyrics. Use structure tags like [Verse], [Chorus], [Bridge], [Outro]
  • tags — Comma-separated style descriptors
  • negative_tags — Styles to explicitly avoid
  • title — Song title

​
Continuation mode

Extend an existing clip from a specific point. Use this to build longer songs by continuing from where a previous generation ended. When to use: You want to extend a clip you already generated. 
{
  "model": "suno",
  "task_type": "music",
  "input": {
    "continue_clip_id": "abc123-clip-id",
    "continue_at": 30,
    "prompt": "[Bridge]\nBut tonight we let it go"
  }
}
Key fields:
  • continue_clip_id — The clip ID from a previous music task output
  • continue_at — Timestamp in seconds to start the continuation
  • prompt — Optional lyrics for the continuation

​
Lyrics generation

Generate song lyrics from a text description. 
{
  "model": "suno",
  "task_type": "lyrics",
  "input": {
    "prompt": "A melancholy ballad about leaving home for the first time"
  }
}

​
Audio upload

Upload an audio file by providing a publicly accessible URL. The uploaded audio can then be used as input for other tasks. 
{
  "model": "suno",
  "task_type": "upload",
  "input": {
    "url": "https://example.com/my-audio.mp3"
  }
}

​
Clip concatenation

Combine clips into a single longer track. Useful for assembling a full song from individually generated sections. 
{
  "model": "suno",
  "task_type": "concat",
  "input": {
    "clip_id": "abc123-clip-id"
  }
}

​
Tips for better results

Be specific with descriptions

Instead of “a good song”, try “an upbeat indie pop song with jangly guitars, handclaps, and a catchy whistle hook in the chorus”.

Use structure tags

In custom mode, use [Verse], [Chorus], [Bridge], [Outro], and [Intro] to control song structure.

Leverage negative tags

Use negative_tags to steer away from unwanted styles rather than only specifying what you want.

V5.5 quality

sunor uses the latest Suno v5.5 model automatically for the best audio quality and most natural vocals.