Create video gift
create_giftCreate a personalized video gift from photos and an original song. Optionally render the film, consuming one prepaid credit and requiring consent that you hold rights to the photos and recipient's depiction.
Instructions
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).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tier | No | Film tier. Defaults to 'signature'. | |
| style | No | Render style preset. Defaults to 'gift' (unchanged). 'social' biases delivery toward vertical 9:16; 'brand' is for branded gifts. | |
| memory | No | A sentence or two the song can lean on. | |
| render | No | Render the film now (spends one credit). If false, create a draft only. Defaults to false. | |
| consent | No | REQUIRED to render: you attest you hold the rights to these photos and the recipient's depiction. | |
| occasion | Yes | Occasion id from list_occasions, e.g. 'anniversary-video'. Drives the song and tone. | |
| photo_urls | No | Public image URLs of the recipient (up to 30). Required to render. | |
| story_note | No | Extra context for the film's narrative. | |
| relationship | Yes | Relationship to the recipient, e.g. 'my wife', 'grandpa', 'our team'. | |
| feeling_words | No | Up to 6 tone words, e.g. ['joyful','grateful','proud']. | |
| recipient_name | Yes | Who the gift is for, e.g. 'Jamie'. |