# Generate AI video (https://docs.propertypixel.app/api/listing-videos/generate_listing_video_ai)

Turn a listing video's still-photo clips into AI video clips (generated camera motion), or make chosen AI clips again. Spends credits. A photo's first AI clip in a video costs 250 credits; any later new clip of the same photo (new camera move, new version, or a regenerate) costs 150. Clips that fail are refunded automatically.

Defaults: with neither shot_ids nor regenerate_shot_ids, every still clip becomes AI video. Each clip uses its current camera move; change it first with edit_listing_video (set_shot_motion, motion pan_zoom, move …), which is free.

Clips are made in the background (a few minutes). Poll get_listing_video, waiting poll_after_ms, until every clip is ready or failed, then call export_listing_video. Once a clip is AI video it stays AI video: a failed clip is refunded and stays an AI clip, so retry it with regenerate_shot_ids (charged again, since the refund returned its credits).

Spending works in two steps. If the request costs credits, the first call (without quote_id) returns a quote and changes nothing. Show the user the cost and wait for a yes, then call again with the same arguments plus quote_id. The quote lasts 10 minutes and only matches identical arguments. A request that costs nothing runs straight away.

Requires a connection with edit access. Can spend credits. A request that costs nothing runs immediately. One that costs credits returns 409 `quote_required` with a quote when sent without `quote_id`, and spends nothing. Resend with `quote_id` to run it, or send `auto_confirm: true` to skip the quote.

REST reference. The OpenAPI 3.1 document is at https://api.propertypixel.app/v1/openapi.json.