Dispatch a single atomic video generation. Sibling of `lamina_generate_image` — same shape, but outputs a video URL.
WORKFLOW: (1) `lamina_models_list({ modality: "video" })` → pick a model. (2) `lamina_models_describe({ modelId })` → read its flat `paramSchema` to learn required inputs. (3) `lamina_generate_video({ model, prompt, params })` → dispatch, get runId. (4) `lamina_status({ runId, wait: true })` → poll until completed; the response has `output.url`.
ONE TOOL, EVERY VIDEO OPERATION. Model id selects the operation; `params` matches the model's paramSchema:
• Text-to-video — Kling t2v variants, Wan-2.6-text-to-video, Wan-turbo, Minimax, Seedance t2v, Veo3-text-to-video. Just `prompt` (+ duration / aspectRatio / etc. per the model).
• Image-to-video — Kling i2v variants, Wan-2.6/turbo image-to-video, Minimax i2v, Seedance i2v (uses `startImageUrl`), `happy-horse-image-to-video`, `veo3-image-to-video` (sync). `params` includes `imageUrl` (or `startImageUrl` for Seedance, `firstFrameUrl` for Veo3 first-frame).
• Keyframe — `veo3-keyframe-to-video` (sync). `params` requires `firstFrameUrl` AND `lastFrameUrl` — model interpolates between them.
• Motion-control — `kling-v26-motion-control`, `kling-v26-motion-control-pro`. `params` requires `imageUrl` (character) AND `videoUrl` (motion reference).
• Video-to-video (edit) — `wan-video-to-video`, Kling v2v variants. `params` requires `videoUrl` (source).
• Reference-to-video — Kling/Seedance/Wan reference variants. `params` uses `referenceImageUrls`.
INPUTS:
• `model` (required): a model id from `lamina_models_list({modality:"video"})`.
• `prompt`: most models require it; some (motion-control variants) are optional. Check `paramSchema.prompt.required` from `lamina_models_describe`. Some models omit `prompt` from `paramSchema` entirely (prompt-less).
• `params`: model-specific fields per the model's `paramSchema`. Required URL fields vary by operation — see list above.
• `webhookUrl` (optional): HTTPS URL for HMAC-signed completion POST.
• `includeCitationKit` (optional, PREVIEW): set `true` to request a citation-ready kit alongside the video — cleaned transcript, question-formatted chapters, a 30–60 word summary, and drop-in `VideoObject` JSON-LD — so wherever you host the video it is answer-engine-citable. Preview signal only: it records interest and returns a `coming_soon` note; the kit is not yet produced.
RESPONSE: `{runId, status: "queued"|"completed", model, mode, prompt, resolvedParams}`. `mode` is the resolved operation. Pass `runId` to `lamina_status`. If `includeCitationKit` was set, the response also carries `citationKit: {status: "coming_soon"}`.
SYNC vs ASYNC: identical contract. Veo3 variants (`veo3-text-to-video`, `veo3-image-to-video`, `veo3-first-frame-to-video`, `veo3-keyframe-to-video`) are Vertex-backed and complete in seconds. fal-backed models queue and take 30s–5min. `lamina_status({ wait: true, timeoutSeconds: 240 })` handles either transparently.
ERROR HANDLING: same shape as `lamina_generate_image` — `code` + `details.errors[]` with `field` + `allowed`/`range`/`got`.