Create Video
create_videoStart a new video from a topic (10-1500 chars: subject, style, message, call to action). Multi-scene videos first get a script for review (free); nothing is rendered or billed until approve_script. single_scene=True makes one short clip (<=11s) that renders immediately and spends credits right away. aspect_ratio: '9:16' (vertical) or '16:9'. video_type: one of Fabeo's seven styles (see get_started); its style is written into the brief. reference_image_keys (from upload_reference_image / get_reference_upload_url) and/or reference_upload_id (from get_reference_upload_page, after the user uploaded): up to 5 images in total; every scene is then rendered to match them (the person's face/outfit, the product), so describe the person in the topic consistently with those images. product_id (from list_catalog): the video is for that product -- its description goes into the brief, and catalog_image_keys (from get_product) adds its stored photos as references.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| topic | Yes | The brief: subject, audience, style, key message and call to action. Describe any person consistently with the reference images. | |
| product_id | No | The product (from list_catalog) the video is for. It is filed under it, and create_video writes the script from the product's own description too. Omit for the account's default product. | |
| video_type | No | The style: ugc_style = UGC-Style Content / Avatar (Looks like a real person filming on their phone — testimonial, unboxing, "get ready with me."); before_after = Before & After / Transformation (Split-screen or morph reveal — skincare, fitness, renovation, makeover.); product_demo = Product Demo / Showcase (Item rotating, zooming, "in use" shots for a listing or ad.); explainer = Explainer / How-To (A presenter walking through steps, or text-to-scene diagrams brought to life.); social_ad = Advertisement / Commercial (Short, high-energy hook clips for paid social — often stylized, exaggerated motion.); animation = Animation / Cartoon Video (A recurring animated character across the video.); cinematic_trailer = Cinematic Trailer / Brand Video (Mood pieces, fantasy/sci-fi concept trailers, pitch visuals.). | explainer |
| aspect_ratio | No | '9:16' vertical (Reels, TikTok, Shorts) or '16:9' horizontal (YouTube, web). | 9:16 |
| single_scene | No | True: one short clip (<=11s) that skips script review, renders immediately and spends credits. False (default): multi-scene script for review first, free. | |
| idempotency_key | No | A unique string for this request (e.g. a UUID). Reuse it when retrying: a repeat within 24h returns the first result instead of starting (and charging for) a second render. | |
| duration_seconds | No | Target length in seconds (5-60; a single_scene video is capped at 11). The rendered length follows the narration, so this is approximate. | |
| catalog_image_keys | No | image_key values of photos already stored on the product, its brand or client (from get_product) to use as reference images; needs product_id. No rights confirmation needed. | |
| reference_upload_id | No | upload_id from get_reference_upload_page, once the user has uploaded their photos there. | |
| use_product_details | No | With product_id: add the product's title, description and brand to the brief (default). False to write from the topic alone. | |
| reference_image_keys | No | reference_image_key values from upload_reference_image / get_reference_upload_url (up to 5 images in total with reference_upload_id). |