Skip to main content
POST
Generate Video
Generate video from a text prompt. This is an asynchronous endpoint — it returns a job ID immediately (HTTP 202) and the video is generated in the background.
Video generation is async. Poll the job status with Get Job Status or use theo.waitForJob() in the SDK.
AI-disclosure watermark. Every video returned from Theo carries a small, semi-transparent Theo logo in the bottom-right corner. This is a provenance signal that identifies the clip as AI-generated and is always applied (regardless of any branding preference). Expect +2–15 seconds of re-encode latency per clip.

Authentication

Requires a Bearer token. See Authentication.

Request Body

string
required
Text description of the video to generate.
string
Target video duration (e.g., "5s", "10s", "15s").
string
Visual style (e.g., "cinematic", "animation", "timelapse").

Request Examples

Response (HTTP 202)

string
Unique video request ID (prefixed vid_).
string
Job ID for polling status.
string
Always "queued" on creation.
string
ISO 8601 timestamp.
string
Relative URL to poll for job status (e.g., /api/v1/jobs/{job_id}).

Example Response

Polling for Results

Use the Get Job Status endpoint to check progress. When status is "completed", the result field contains the video URL.

Errors