Get started
Pictures, clips and sounds
Every place a call takes a file takes a link to it: a reference picture, a start frame, a product’s pictures, a presenter, a video to look like, a recording.
curl -X POST https://vessero.com/api/v1/files \ -H "Authorization: Bearer $VESSERO_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "url": "https://example.com/products/linen-shirt.jpg", "as": "image" }'
curl -X POST https://vessero.com/api/v1/ugc-ads \ -H "Authorization: Bearer $VESSERO_API_KEY" \ -H "Idempotency-Key: 47f8f6f5-ea00-4fb1-925f-76aac956a0ec" \ -H "Content-Type: application/json" \ -d '{ "prompt": "@Presenter1 holds @Product1 up to the camera in @Image1 and says: “This serum has fifteen percent vitamin C, and it is light enough to wear under make-up.”", "videoModel": "seedance-2.5", "presenters": [ { "kind": "pictures", "pictureKeys": [ "https://example.com/people/zola.jpg" ], "whoIsIn": { "kind": "no-person" }, "name": "Zola" } ], "productPictureKeys": [ "https://example.com/products/glow-serum.jpg" ], "pictureKeys": [ "https://example.com/sets/sunny-kitchen.jpg" ], "aspect": "9:16", "captionStyle": "word-pop", "confirmCredits": 194, "webhookUrl": "https://example.com/hooks/vessero" }'
A link, or a storage key
Wherever a field takes a file — referenceKeys, firstKey, pictureKeys, productPictureKeys, lookLike.key, a voice’s key, an edit’s source.key, a mask — send either a public https link to the file or a storage key. A link is brought into your Uploads before the call runs, held to the same types, sizes and content check as a file sent to POST /files, and the call goes on with its key.
- Once an hour. The same link in the same slot is brought in once an hour, so a quote and the run that confirms it use one upload.
- A link that cannot be brought in — one that needs a sign-in, a page instead of the file, a file of another kind — refuses the call with
400 refused, naming the field. Nothing is priced or charged. - A file on your disk goes to
POST /filesfirst, as a form; itskeygoes where the file does. - A clip’s or a recording’s length is read from the file when you leave its
durationSecout.
Everything an ad is made from
A UGC ad takes what the UGC Ads page takes: presenters (a cast member, or a character you bring as pictures), the product (productPictureKeys, its pictures), other pictures, a video to look like, and a voice for each presenter. Name each in the words by its tag — @Presenter1, @Product1, @Image1, @Video1 — as on the page.
One shot, or step by step
One call makes the whole video, One shot, as the page does by default: the words and pictures go straight to the video model, and a first frame is drawn on the way only where the model can’t take them as they are — a real person in it, a model that takes no references, a lip-sync with no presenter. pictureModel: null never draws one.
Send pictureFirst: true to make it step by step, as Step by step does on the page: the call makes only the previews — the picture of the presenter with the product the video opens on, pictureChoices of them to pick from — for their own price, and its job ends waiting, the previews in files. Then POST /ugc-ads/{adId}/video makes the video from the one picked, or POST /ugc-ads/{adId}/picture draws a preview again, on the same picture model or another; each has its quote. adId is the job’s id after ugc..