Price it: make a song or an instrumental

The price for exactly this body, the balance beside it and any notes. Nothing runs and nothing is charged. Run it with POST /api/v1/music, the same body, confirmCredits set to credits and the same Idempotency-Key.

Key needs: create · Make things and spend credits
Runs it: POST /music
Answers: A quote · free

Request

curl -X POST https://vessero.com/api/v1/music/quote \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Idempotency-Key: 47f8f6f5-ea00-4fb1-925f-76aac956a0ec" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "text"
  }'

Response200 OK

{
  "object": "quote",
  "credits": 12,
  "balance": 840,
  "lines": [
    "1 image × 12 (Nano Banana Pro · 4K)"
  ],
  "notes": [],
  "requestId": "47f8f6f5-ea00-4fb1-925f-76aac956a0ec",
  "run": {
    "method": "POST",
    "path": "/api/v1/images",
    "confirmCredits": 12,
    "idempotencyKey": "47f8f6f5-ea00-4fb1-925f-76aac956a0ec"
  }
}

Header

Idempotency-KeystringYour id for this request: 8–64 letters, digits, - or _. A repeat within 10 minutes gets the first answer back and never runs twice. Use the same one for the quote and the run.

Body

promptstringrequiredSimple: the song described, e.g. "An upbeat summer pop song about a road trip" (up to 500 characters are read). Custom: the lyrics as they are sung, with [Verse] and [Chorus] tags (up to 5,000), or for an instrumental, how it should feel.
customModebooleantrue for custom (lyrics, style and title as given); false for simple. Default: custom when a style or title is given.
stylestringCustom: the style, e.g. "lo-fi hip hop, warm Rhodes, vinyl crackle".
titlestringCustom: the track’s title.
instrumentalbooleantrue for no vocals. Default: with vocals.
modelstringA music model id from GET /api/v1/models (studio "music"). Default: the newest.V6V6_MINIV6_WILD
durationintegerA custom instrumental’s length in seconds, 10–360. Otherwise the song sets its own.
vocalGenderstringCustom: a male (m) or female (f) voice.mf
negativeTagsstringCustom: styles to keep out, e.g. "heavy metal, screaming".
styleWeightnumberCustom, 0–1: how strictly it keeps to the style.
weirdnessConstraintnumberCustom, 0–1: how experimental it may get.
audioWeightnumberCustom, 0–1: the balance of the audio.

Answers

200quoteThe price for exactly this body, your balance and any notes. Nothing ran.
400invalid_requestA field is missing or not accepted: see details.
403feature_unavailableThe studio this needs is switched off for the account right now.
429rate_limitedToo many calls this minute: see Retry-After.