Skip to content
Braiv Docs

Credits

Most creates spend credits. You can price first, hold a reservation, then attach it — or let the create call reserve on its own.

  1. Quote — POST /videos/{videoId}/quote returns line items and a total.
  2. Reserve (optional) — POST /videos/{videoId}/reservations holds those credits and returns a reservationId.
  3. Create — pass reservationId (and reservationLineItemIdByLanguage when you spend per locale).

If you omit reservationId, the handler quotes and reserves internally. A shortfall is 429 INSUFFICIENT_CREDITS.

Zero-prompt thumbnails quote under zeroPromptThumbnail. characterCount adds character-reference line items. translateLanguageCodes adds one thumbnail-translate line each. Precision key-moment detect is priced with autoDetectContentMoments: true (maps to the content-moment-detect action) when the generate recipe uses autoDetectContentReferences. See Generate a thumbnail.

Preview dubs can become playable before the full mix is done. A full-length download needs completion: full_ready — see Get a dub.

Endpoint details: Credits API reference.