Skip to content
Get your keyGet a key

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.

Bring in a file · freePOST/files
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"
  }'
Make an ad from itPOST/ugc-ads
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"
  }'

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 /files first, as a form; its key goes where the file does.
  • A clip’s or a recording’s length is read from the file when you leave its durationSec out.

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..