Skip to content
Log in
Developer API
Get your keyGet a key

Reference · Audio

POST/voiceovers/quote

Price it: read a script, or a dialogue between voices

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/voiceovers, the same body, confirmCredits set to credits and the same Idempotency-Key.

Key needs
create · Make things and spend credits
Runs it
POST /voiceovers
Answers
A quote · free
Request
curl -X POST https://vessero.com/api/v1/voiceovers/quote \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Idempotency-Key: 47f8f6f5-ea00-4fb1-925f-76aac956a0ec" \
  -H "Content-Type: application/json" \
  -d '{}'
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

  • textstringOne voice reading this script, e.g. "Meet the shirt that keeps you cool all summer." Up to the model’s maxCharacters (10,000 at most). Give text or lines, not both.
  • voiceIdstringFor text: a voice id from GET /api/v1/voices. Default: the Voice page’s own voice.
  • linesobject[] · up to 100A dialogue, read as one take: up to 100 lines and 10 voices, 10,000 characters in all. Give text or lines, not both.
    • voiceIdstringrequiredThe voice reading this line, from GET /api/v1/voices.
    • textstringrequiredWhat it says.
  • modelIdstringA voice model id from GET /api/v1/models (studio "voice"). Default: the recommended one.
  • stabilitynumber0–1: lower is more expressive, higher more even.
  • similarityBoostnumber0–1: how closely it keeps to the voice.
  • stylenumberOne voice only, 0–1: how much of the voice’s own style is exaggerated.
  • useSpeakerBoostbooleanOne voice only: lift the likeness to the voice.
  • outputFormatstringA format id from GET /api/v1/models (studio "voice"), e.g. "mp3_44100_128".
  • languageCodestringThe language it is read in, e.g. "en", where the model reads it. Default: worked out from the words.

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.
Next in AudioPOST/music