Skip to content
Get your keyGet a key

Reference · Library

GET/cast

Cast members: the account’s own and the starters

The AI actors and AI influencers the person can put in their work: their own, and the starter cast every account has. Each with its id, name, label (every synthetic person is labelled: "AI actor", or "AI likeness" for a real person's), look, voice and languages, and every picture of theirs — the hero, each page of their sheet, each view — with a link to open or download it. Use an id as a presenter in a UGC ad or an avatar, to animate an influencer, or on a board as a cast card, the starter cast’s as well as their own (POST /api/v1/boards/{boardId}/place, or a cast card in POST /api/v1/boards/{boardId}/cards); a voiceId reads words in their voice (POST /api/v1/voiceovers, or an avatar’s script); for one of their pictures in another create tool, pass {kind: "cast", id} to POST /api/v1/library/use. Free.

Key needs
account:read · See your account
Spends
Nothing
Answers
Data
Request
curl https://vessero.com/api/v1/cast \
  -H "Authorization: Bearer $VESSERO_API_KEY"

Query

  • minebooleantrue for the person's own cast only, leaving out the starter cast. Default false.
  • limitintegerHow many, 1–100. Default 30.
  • cursorstringThe nextCursor of the previous page; leave it out for the first page.

Answers

  • 200okThe answer, as data.
  • 404not_foundNot found on this account.
  • 429rate_limitedToo many calls this minute: see Retry-After.