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.
Try it · freeGET/account
curl https://vessero.com/api/v1/account \ -H "Authorization: Bearer $VESSERO_API_KEY"
Response200 OK
{ "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 products, cast and voices.
- GET/libraryWhat the account made, uploaded and saved
- POST/library/useA storage key for a Library piece, to pass to a create
- GET/workRecent work from one studio
- GET/productsThe account’s products
- POST/productsAdd a product by hand, with its pictures
- GET/products/{productId}One product, with its pictures
- PATCH/products/{productId}Change a product: its words, its price, its pictures
- POST/products/importA product read from its page’s link
- GET/castCast members: the account’s own and the starters
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/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 product 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