Generate music with suno/chirp-v4-5-all

Authorization

BearerAuth

AuthorizationBearer <token>

API key is required to authorize requests. Create a key in the Atlas Cloud dashboard.

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

model*"suno/chirp-v4-5-all"

Model name.

Value in

"suno/chirp-v4-5-all"

prompt?string

With custom=false (default): an inspiration description of the song (style, mood, genre, theme). With custom=true: the actual lyrics, e.g. "[Verse]\n...\n[Chorus]\n...". Required unless custom=true and instrumental=true.

Lengthlength <= 3000

custom?boolean

false = inspiration mode (prompt is a description). true = custom mode (prompt is used as lyrics, and title / style / negative_tags / auto_lyrics / persona_id / style_weight / weirdness_constraint / audio_weight take effect).

Defaultfalse

instrumental?boolean

Instrumental only, no vocals.

Defaultfalse

vocal_gender?string

Vocal gender. Takes effect in both modes.

Value in

"Male"
"Female"

title?string

Song title. Only takes effect when custom=true (ignored otherwise).

Lengthlength <= 200

style?string

Style tags, e.g. "synthwave, female vocal, cinematic". Only takes effect when custom=true (ignored otherwise).

Lengthlength <= 500

negative_tags?string

Styles to avoid. Only takes effect when custom=true.

Lengthlength <= 500

auto_lyrics?boolean

Let the model rewrite the supplied lyrics creatively. Only when custom=true.

Defaultfalse

style_weight?number

How strongly to follow style. Only when custom=true.

Range0 <= value <= 1

weirdness_constraint?number

Creativity / weirdness. Only when custom=true.

Range0 <= value <= 1

audio_weight?number

Audio reference weight. Only when custom=true.

Range0 <= value <= 1

persona_id?string

Persona (voice identity) id. Only when custom=true.

Response Body

`application/json`

curl -X POST "https://example.com/api/v1/model/generateAudio" \  -H "Content-Type: application/json" \  -d '{    "model": "suno/chirp-v4-5-all"  }'

{  "id": "string",  "model": "string",  "status": "string",  "outputs": [    "string"  ],  "thumbnail": "string",  "urls": {}}

Generate music with suno/chirp-v4-5-all

Authorization

Request Body

Response Body

200application/json

`application/json`