Reference · Ads
POST/ugc-ads/{adId}/picture/quote
Price it: draw a new preview of a UGC ad, before its video is made
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}/picture, the same body, confirmCredits set to credits and the same Idempotency-Key.
- Key needs
create· Make things and spend credits- Runs it
POST /ugc-ads/{adId}/picture- Answers
- A quote · free
Request
curl -X POST https://vessero.com/api/v1/ugc-ads/8f1c2d3e-4b5a-4789-8abc-def012345678/picture/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., so8f1c…for the jobugc.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
- takeIdstringWhich take, by the takeId GET /api/v1/jobs/{jobId} gives for it, where the ad has several. Default: the first take.
- pictureIdstringWhere the take drew several previews to pick from, which one to draw again: its pictureId from GET /api/v1/jobs/{jobId}. Default: the one its video starts from.
- pictureModelstringAnother picture model to draw it with: an id from GET /api/v1/models (studio "ugc", pictureModels). Default: the one that drew it.
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.