Skip to content
Get your keyGet a key

Reference · Ads

POST/ugc-ads/{adId}/video/quote

Price it: make the video of a UGC ad made step by step, once its preview is in

The price for exactly this body, the balance beside it and any notes. Nothing runs and nothing is charged. Run it with POST /api/v1/ugc-ads/{adId}/video, the same body, confirmCredits set to credits and the same Idempotency-Key.

Key needs
create · Make things and spend credits
Answers
A quote · free
Request
curl -X POST https://vessero.com/api/v1/ugc-ads/8f1c2d3e-4b5a-4789-8abc-def012345678/video/quote \
  -H "Authorization: Bearer $VESSERO_API_KEY" \
  -H "Idempotency-Key: 47f8f6f5-ea00-4fb1-925f-76aac956a0ec" \
  -H "Content-Type: application/json" \
  -d '{}'
Response200 OK
{
  "object": "quote",
  "credits": 12,
  "balance": 840,
  "lines": [
    "1 image × 12 (Nano Banana Pro · 4K)"
  ],
  "notes": [],
  "requestId": "47f8f6f5-ea00-4fb1-925f-76aac956a0ec",
  "run": {
    "method": "POST",
    "path": "/api/v1/images",
    "confirmCredits": 12,
    "idempotencyKey": "47f8f6f5-ea00-4fb1-925f-76aac956a0ec"
  }
}

Path

  • adIdstringrequiredThe UGC ad: its job’s id after ugc., so 8f1c… for the job ugc.8f1c….

Header

  • Idempotency-KeystringYour id for this request: 8–64 letters, digits, - or _. A repeat within 10 minutes gets the first answer back and never runs twice. Use the same one for the quote and the run.

Body

  • pictureIdsstring[] · up to 4Where a take drew several previews to pick from (pictureChoices), the one its video starts from: a pictureId from GET /api/v1/jobs/{jobId}, one for each such take. Default: the one each take has, the first made.

Answers

  • 200quoteThe price for exactly this body, your balance and any notes. Nothing ran.
  • 400invalid_requestA field is missing or not accepted: see details.
  • 403feature_unavailableThe studio this needs is switched off for the account right now.
  • 429rate_limitedToo many calls this minute: see Retry-After.
Next in AdsPOST/ugc-ads/{adId}/picture