Media · Generate · Generate AI video
Generate an AI video from a prompt, an image, two frames, several images, or a source video. One call: POST {model, parameters} (capability is optional — derived from which inputs you send). It blocks and returns the final result — do not poll. Use the input slot names below as-is for every model; the server adapts the payload to the model you chose. If something does not fit that model (a ratio, duration or resolution it lacks, too many images for the mode), the error says exactly what to change. getModelFields (type=video) is optional — call it only when you want the model's duration/resolution options before choosing.
Why task_id is misleading here
The endpoint also returns a task_id, but it tracks the submission Celery task that hands the request off to FAL/Kie — it flips to SUCCESS almost immediately, well before the actual video is rendered. Do not call getTaskResult on this task_id — it tells you nothing useful about generation completion. Always poll getVideoVariation instead. The apikit middleware strips task_id from this response automatically to avoid confusion.
Storage modes
- default — persists into the AiImageArt gallery (recommended).
- transient — generated without surfacing in the gallery; useful for one-shot agent runs.
- asset — saves the rendered video as a standalone reusable TldrAsset (no gallery entry).
Request
- Base URLhttps://api.simplified.com
- AuthAPI key in header Authorization
Request body
Response
Video generation completed (apikit blocks here until job_status is terminal — the post-hook polls the AIArtVariation internally). Final body is the AIArtVariation with job_status="DONE"; on terminal failure the body is {error: true, id, art_variation_id, status, message, payload}. Useful keys on success: output.file_url (rendered video), output.thumbnail_cover_image, id (variation id), payload.input (echo of the request).
Changes
No recorded changes to this operation across all 1 revision of this API.