
Suno chirp-v4 API by SUNO
Suno text-to-music via APIMart: inspiration mode (custom=false) turns a description into a song; custom mode (custom=true) uses your own lyrics. Async; returns 2 tracks per generation.
Suno chirp-v4
Generate a full song — vocals or instrumental — from a text prompt, powered by Suno
(version v4). Each generation returns 2 tracks plus cover art.
Two modes
| mode | set | prompt means |
|---|---|---|
| Inspiration | custom: false (default) | a description of the song: style, mood, genre, theme |
| Custom | custom: true | the actual lyrics, e.g. [Verse] ... [Chorus] ... |
In custom mode you can also set title, style, negative_tags, auto_lyrics,
persona_id, style_weight, weirdness_constraint and audio_weight. Those fields are
silently ignored in inspiration mode. vocal_gender and instrumental work in both.
Parameters
| field | required | notes |
|---|---|---|
prompt | yes | description (inspiration mode) or lyrics (custom mode), ≤3000 chars. Optional only when custom: true and instrumental: true |
custom | no | false = inspiration (default), true = your own lyrics |
instrumental | no | instrumental only, no vocals |
vocal_gender | no | Male / Female — both modes |
title | no | song title — custom mode only |
style | no | style tags, e.g. synthwave, female vocal, cinematic — custom mode only |
negative_tags | no | styles to avoid — custom mode only |
auto_lyrics | no | let the model rewrite your lyrics — custom mode only |
style_weight | no | 0.00–1.00 — custom mode only |
weirdness_constraint | no | 0.00–1.00 — custom mode only |
audio_weight | no | 0.00–1.00 — custom mode only |
persona_id | no | voice identity id — custom mode only |
Output
outputs holds 2 audio URLs (two takes of the same request); the cover art is returned
separately in thumbnail so it is never mixed into the audio list.
Notes
- Async: submitting returns a request id; poll
/api/v1/model/prediction/{request_id}untilstatusiscompletedorfailed. Generation typically takes 30–120s. - Billing: $0.12 per generation (both tracks included) — charged per request, not per track.
Example
Inspiration mode:
{ "model": "suno/chirp-v4", "prompt": "Late-night city lo-fi piano with the sound of rain" }
Custom mode with your own lyrics:
{ "model": "suno/chirp-v4", "custom": true, "prompt": "[Verse]\nNeon streets on a rainy night\n[Chorus]\nDrive on, drive on", "title": "Midnight Drive", "style": "synthwave, female vocal, cinematic", "vocal_gender": "Female" }














