Reference
Every address of the API
Each address, by section: what it takes, what it answers, and the code to call it. Every address that spends has a free twin ending in /quote. The reference is also OpenAPI 3.1, and a primer for AI coding agents is at llms.txt.
curl https://vessero.com/api/v1/account \ -H "Authorization: Bearer $VESSERO_API_KEY"
{ "email": "ada@okafor.studio", "credits": { "total": 840, "fromPlan": 600, "purchased": 240, "withAnEnd": [], "unmetered": false }, "plan": { "name": "Pro", "status": "active", "creditsPerPeriod": 1200, "refillsAt": "2026-11-21T09:12:00.000Z", "endsAtPeriodEnd": false }, "purchasesOpen": true, "oneOffBuys": null, "addCreditsUrl": "https://vessero.com/pricing", "studios": [ { "id": "video", "name": "Video", "on": true, "tools": [ "POST /api/v1/videos" ] }, { "id": "images", "name": "Images", "on": true, "tools": [ "POST /api/v1/images" ] } ] }
Account
The account a key belongs to: its credits, plan and the studios that are on.
Models
The models each studio offers, with their options and prices.
Files
Files in — a picture, a clip, a recording, from your server or a public link — and lasting links out.
Library
What the account has made and uploaded, its cast and voices.
Images
Pictures from words and reference pictures.
Video
Clips, talking avatars, AI influencer clips, upscales and captions.
- POST/videosMake a clip from words, frames, references or a video to follow
- POST/videos/quotePrice it: make a clip from words, frames, references or a video to follow
- POST/avatarsMake a talking avatar clip, or lip-sync a clip to a voice
- POST/avatars/quotePrice it: make a talking avatar clip, or lip-sync a clip to a voice
- POST/influencer-clipsAnimate an AI influencer from Cast
- POST/influencer-clips/quotePrice it: animate an AI influencer from Cast
- POST/enhanceUpscale, reframe or edit a picture or a clip
- POST/enhance/quotePrice it: upscale, reframe or edit a picture or a clip
- POST/captionsBurn captions into a clip
- POST/captions/quotePrice it: burn captions into a clip
Audio
Voiceovers, dialogue and music.
Ads
UGC video ads with presenters, picture ads, and stories from a script.
- POST/ugc-adsMake a UGC video ad: presenters, product, voice and captions
- POST/ugc-ads/quotePrice it: make a UGC video ad: presenters, product, voice and captions
- POST/ugc-ads/{adId}/videoMake the video of a UGC ad made step by step, once its preview is in
- POST/ugc-ads/{adId}/video/quotePrice it: make the video of a UGC ad made step by step, once its preview is in
- POST/ugc-ads/{adId}/pictureDraw a new preview of a UGC ad, before its video is made
- POST/ugc-ads/{adId}/picture/quotePrice it: draw a new preview of a UGC ad, before its video is made
- POST/picture-adsMake picture ads from a template, a product or a brief
- POST/picture-ads/quotePrice it: make picture ads from a template, a product or a brief
- POST/storiesTurn a script into a narrated, captioned video
- POST/stories/quotePrice it: turn a script into a narrated, captioned video
Jobs
Work that finishes later: its stage, its files, or why it failed.
Creative Board
Boards of cards wired together — words, pictures, clips, voices — built, edited and run.
- GET/boardsThe account’s boards
- POST/boardsMake a board, empty, from a template, or with cards and wires
- GET/boards/guideThe card kinds, their settings and the wiring rules
- GET/boards/{boardId}A board: its cards, wires and what each card made
- PATCH/boards/{boardId}Rename a board
- POST/boards/{boardId}/duplicateCopy a board
- POST/boards/{boardId}/arrangeTidy a board’s cards along their wires
- POST/boards/{boardId}/coverSet or clear a board’s cover
- POST/boards/{boardId}/runRun every card of a board, or the ones named
- POST/boards/{boardId}/run/quotePrice it: run every card of a board, or the ones named
- POST/boards/{boardId}/cardsAdd cards, and the wires between them
- POST/boards/{boardId}/cards/removeTake cards off a board (they can be restored)
- PATCH/boards/{boardId}/cards/{cardId}Change a card: its words, model, settings or place
- POST/boards/{boardId}/cards/{cardId}/runRun one card
- POST/boards/{boardId}/cards/{cardId}/run/quotePrice it: run one card
- POST/boards/{boardId}/cards/{cardId}/duplicateCopy a card
- POST/boards/{boardId}/cards/{cardId}/restorePut a removed card back
- POST/boards/{boardId}/cards/{cardId}/next-shotAdd the next shot after a clip card, wired from its last frame
- POST/boards/{boardId}/wiresWire cards together
- POST/boards/{boardId}/wires/removeTake wires away
- POST/boards/{boardId}/placePut a Library piece, an upload or a cast member on a board
Creative Director
The Creative Director as an agent: send a brief, read its plan, approve what it proposes to make.
- POST/director/messagesSend the Creative Director a message, and stream or fetch its reply
- POST/director/messages/quotePrice a message to the Creative Director
- GET/director/threadsThe account’s Creative Director conversations
- GET/director/threads/{threadId}A conversation: its messages and what the director proposed
- GET/director/batches/{batchId}A proposal’s calls as they are made
- POST/director/batches/{batchId}/approveMake what the director proposed, at its quoted price
- POST/director/batches/{batchId}/cancelClose a proposal without making it
Your page
The account’s link-in-bio page and its short links.
- GET/pageThe account’s link-in-bio page
- POST/page/blocksAdd a block to the page
- PATCH/page/blocks/{blockId}Change, move, show or hide a block
- PATCH/page/lookThe page’s theme, layout, socials and top
- GET/short-linksThe account’s short links
- POST/short-linksMake a short link
- PATCH/short-links/{linkId}Change a short link, or turn it off