List the supported occasions (anniversary, birthday, wedding, memorial, graduation, …). Use an occasion id when creating a gift; it drives the song and tone.

Return the API key's account status and prepaid credit balance. Use before rendering to confirm there are enough credits.

Create a personalized video gift from photos + an original song and (optionally) render the film. Rendering spends one prepaid credit and takes a few minutes — poll with get_gift, or watch list_gifts for status 'delivered'. You MUST pass consent=true to render (you attest you hold the rights to the photos and the recipient's depiction).

Fetch one gift by id — its status and, once delivered, the film_url. Poll this after create_gift with render=true.

List this key's gifts, newest first. Filter by status (e.g. 'delivered') to find finished films.