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

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

Request Examples

Response (HTTP 202)

id
string
Unique video request ID (prefixed vid_).
job_id
string
Job ID for polling status.
status
string
Always "queued" on creation.
created
string
ISO 8601 timestamp.
poll_url
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