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

Reference · Video

POST/influencer-clips/quote

Price it: animate an AI influencer from Cast

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

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

  • castMemberIdstringrequiredThe AI influencer: their cast member id, from GET /api/v1/cast.
  • usestringmotion (the default): they move as the clip does. swap: they go in place of someone or something in it.motionswap
  • trendIdstringA trend clip of ours: holds-it-to-camera (Holds it to camera, 8 s), morning-routine (Morning routine, 8 s), cafe-patio (Café patio, 8 s), street-walk-by (Street walk-by, 5 s), pool-turn (Pool turn, 5 s), city-window (City window, 5 s), rooftop-stretch (Rooftop stretch, 5 s), desk-to-lens (Desk to lens, 5 s), talks-it-through (Talks it through, 8 s), unboxing (Unboxing, 8 s), hook-then-body (Hook, then body, 8 s), reaction (Reaction, 8 s). Give this or clipKey.holds-it-to-cameramorning-routinecafe-patiostreet-walk-bypool-turncity-windowrooftop-stretchdesk-to-lenstalks-it-throughunboxinghook-then-bodyreaction
  • clipKeystringOr a clip of theirs (MP4 or MOV): a storage key from POST /api/v1/files or POST /api/v1/library/use, or an https link to the file (brought into their Uploads first).
  • whoIsInClipobject · kind no-person | personSwap with an uploaded clip: who is in it, as the person says.
  • referenceKeysstring[] · up to 7What they wear or hold, up to 7 pictures.
  • promptstringAnything to add in words, e.g. "holding the green bottle in her right hand".
  • resolutionstringThe quality: 480p, 720p or 1080p. Default: the model’s own.480p720p1080p

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 VideoPOST/enhance