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 Type	Credits	Description
`music`	10	Generate a complete music clip with audio and optional vocals
`lyrics`	5	Generate song lyrics from a text prompt
`upload`	1	Upload an audio file for use as input to other tasks
`concat`	5	Concatenate 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 quality	Good	Improved — cleaner mix, less artifacts
Vocals	Natural	More expressive, better pronunciation
Style adherence	Good	More accurate to tags and descriptions
Instrumentation	Standard	Richer, more detailed arrangements
Pricing	10 credits	10 credits
API parameters	Same	Same — 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 — provide your own lyrics and/or genre/style tags. For a style-driven instrumental, omit prompt and set make_instrumental: true. When to use: You have specific lyrics, want precise genre control, or want a tag-driven instrumental.

{
  "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 (structure tags like [Verse], [Chorus], [Bridge], [Outro]). Omit for an instrumental.
tags — Comma-separated style descriptors
negative_tags — Styles to explicitly avoid
make_instrumental — Set to true for an instrumental with no vocals (pair with tags)
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 to continue from. This can be a clip from a previous music task output or an uploaded audio clip (see Audio upload — upload your audio, then pass the returned clip ID here to extend it into a full song)
continue_at — Timestamp in seconds (within the source clip) 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 upload returns a clip that you can then feed into a continuation to extend your audio into a full song.

{
  "model": "suno",
  "task_type": "upload",
  "input": {
    "url": "https://example.com/my-audio.mp3"
  }
}

The upload response includes a clip id (at output.result[0].id). Pass that id as continue_clip_id in a music task to generate a full song from your uploaded audio:

{
  "model": "suno",
  "task_type": "music",
  "input": {
    "continue_clip_id": "<id from your upload result>",
    "continue_at": 3
  }
}

continue_at is the timestamp (in seconds, within your uploaded clip) to continue from.

Continuation extends your uploaded audio and keeps its existing style. Generating a new song in a different style from an uploaded reference (an “audio cover”) is not currently supported.

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.

Getting Started

Models

Guides

Resources

Suno Model

Suno Model

Available task types

Model version

V5 vs V5.5

Music generation modes

Inspiration mode

Custom mode

Continuation mode

Lyrics generation

Audio upload

Clip concatenation

Tips for better results

Be specific with descriptions

Use structure tags

Leverage negative tags

V5.5 quality

​Suno Model

​Available task types

​Model version

​V5 vs V5.5

​Music generation modes

​Inspiration mode

​Custom mode

​Continuation mode

​Lyrics generation

​Audio upload

​Clip concatenation

​Tips for better results

Be specific with descriptions

Use structure tags

Leverage negative tags

V5.5 quality

Suno Model

Available task types

Model version

V5 vs V5.5

Music generation modes

Inspiration mode

Custom mode

Continuation mode

Lyrics generation

Audio upload

Clip concatenation

Tips for better results