Price it: turn a script into a narrated, captioned video

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

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

Request

curl -X POST https://vessero.com/api/v1/stories/quote \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Idempotency-Key: 47f8f6f5-ea00-4fb1-925f-76aac956a0ec" \
  -H "Content-Type: application/json" \
  -d '{
    "script": "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

scriptstringrequiredThe words the narrator reads, as they are to be heard.
voiceIdstringThe narrator: a voice id from GET /api/v1/voices. Give this or voiceoverMediaId.
voiceoverMediaIdstringTheir own voiceover instead of a narrator: the id of a voiceover take (POST /api/v1/voiceovers returns it) or a recording in their library. The story runs as long as it, and no narration is charged.
pacestringHow fast the narrator reads: slow, normal (the default) or fast. A slower read runs longer and costs more to compose.slownormalfast
lookstringA look id from GET /api/v1/models (studio "story"). Default: "bold-tiktok".bold-tiktokeditorial-serifios-glassmagazinewhiteboardmr-beastpodcast-clipnews-broadcastsports-highlightbeauty-luxurygaming-neonfinance-protech-explainerkids-explainerwellness
captionStylestringA caption style id from GET /api/v1/models (studio "story"), or "auto" to follow the look (the default).autoimpact-slameditorial-minimalluxury-serifglass-techmarker-energyretro-collageword-popclean-subtitle
aspectRatiostringThe shape: 9:16 (the default), 16:9 or 1:1.9:1616:91:1
directionstringA line of direction for the visuals, e.g. "keep it calm, mostly typography".
titlestringWhat the story is called in their library.

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.