ToAPIsToAPIs
Suno Music

Music Generation

Suno music generation with inspiration and custom-lyrics modes, optional Max tier

POST
/v1/music/generations/generation
  • Generate full songs from a text description or custom lyrics (2 candidates per request)
  • Asynchronous task; poll by task ID
  • custom determines the meaning of prompt: custom lyrics vs inspiration description

Authorizations

Authorizationstringheaderrequired

Bearer Token. Get your API Key: API Key management

Body

modelstringbodyrequired

Fixed value "suno"

custombooleanbody

Mode switch, default false

  • false: inspiration mode — gpt_description (or prompt) describes the music
  • true: custom lyrics mode — prompt is the lyrics text; title/style/negative_tags apply
gpt_descriptionstringbody

Music description in inspiration mode, e.g. "lo-fi jazz for a rainy café". Not used in custom mode.

promptstringbody

Lyrics text in custom mode (supports [Verse]/[Chorus] structure tags)

titlestringbody

Song title (custom mode)

stylestringbody

Style tags (custom mode), e.g. "dreamy synthwave, female vocal"

negative_tagsstringbody

Elements to avoid (custom mode)

instrumentalbooleanbody

Generate instrumental-only music

versionstringbody

Engine version: v6 / v6-wild / v6-mini

max_modebooleanbody

Max quality tier, billed at 2× ($0.10). Requires custom=true

persona_idstringbody

Reuse a created vocal persona. Mutually exclusive with custom_model_id

custom_model_idstringbody

Use a custom-trained model. Mutually exclusive with version and persona_id

Optional tuning parameters

style_weight, weirdness, audio_weight, vocal_gender, auto_lyrics, variety are all optional; upstream defaults apply when omitted.

Response

task_idstring

Task ID (tsk_aud_ prefix); poll via music task status

statusstring

Initial status: submitted / queued / in_progress

On completion, result.music[] returns 2 candidates, each with audio_url, image_url, title, tags, lyrics, duration. Media URLs are mirrored to our CDN.

requestExample

curl --request POST \
  --url https://toapis.com/v1/music/generations/generation \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "suno",
    "gpt_description": "lo-fi jazz for a rainy café",
    "instrumental": false,
    "version": "v6"
  }'
import requests

resp = requests.post(
    "https://toapis.com/v1/music/generations/generation",
    headers={"Authorization": "Bearer <token>"},
    json={
        "model": "suno",
        "custom": True,
        "prompt": "[Verse]\nNeon lights are glowing\n[Chorus]\nWe ride until the morning",
        "title": "Neon Ride",
        "style": "synthwave",
        "max_mode": True
    }
)
print(resp.json())
const resp = await fetch("https://toapis.com/v1/music/generations/generation", {
  method: "POST",
  headers: {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    model: "suno",
    gpt_description: "dreamy synthwave with female vocals",
    version: "v6-wild"
  })
});
console.log(await resp.json());