Loading...
Loading...
Generate AI videos with Tavus replicas. Use when creating personalized videos from scripts or audio, adding custom backgrounds, watermarks, or generating videos at scale. Covers the video generation API, not real-time conversations.
npx skill4agent add tavus-engineering/tavus-skills tavus-video-gencurl -X POST https://tavusapi.com/v2/videos \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"replica_id": "rfe12d8b9597",
"script": "Hey there! Welcome to our product demo."
}'{
"video_id": "1e30440cf9",
"status": "queued"
}curl -X POST https://tavusapi.com/v2/videos \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"replica_id": "rfe12d8b9597",
"script": "Your script text here",
"video_name": "Product Demo v1",
"callback_url": "https://your-webhook.com/video-ready",
"background_url": "https://example.com/landing-page",
"background_source_url": "https://s3.../background.mp4",
"watermark_url": "https://s3.../logo.png",
"fast": false,
"transparent_background": false
}'| Param | Description |
|---|---|
| Required. Stock or custom replica ID |
| Text for replica to speak (use this OR audio_url) |
| Pre-recorded audio (.wav/.mp3) for replica to lip-sync |
| Display name |
| Webhook for completion/error |
| Website URL to record as background |
| Video file URL for background |
| PNG/JPEG logo overlay |
| Quick render (disables some features) |
| WebM with alpha (requires |
{
"replica_id": "rfe12d8b9597",
"audio_url": "https://s3.../narration.mp3"
}.wav.mp3{
"background_url": "https://example.com/landing-page"
}{
"background_source_url": "https://s3.../promo-bg.mp4"
}{
"fast": true,
"transparent_background": true
}.webmcurl https://tavusapi.com/v2/videos/{video_id} \
-H "x-api-key: YOUR_API_KEY"queuedgeneratingreadyerrordeleted{
"status": "ready",
"hosted_url": "https://videos.tavus.io/video/xxx",
"download_url": "https://stream.mux.com/.../high.mp4",
"stream_url": "https://stream.mux.com/xxx.m3u8"
}{
"video_id": "1e30440cf9",
"status": "ready",
"hosted_url": "https://videos.tavus.io/video/1e30440cf9",
"download_url": "...",
"stream_url": "..."
}{
"video_id": "xxx",
"status": "error",
"status_details": "Error message here"
}# List all videos
curl https://tavusapi.com/v2/videos -H "x-api-key: YOUR_API_KEY"
# Delete video
curl -X DELETE https://tavusapi.com/v2/videos/{video_id} \
-H "x-api-key: YOUR_API_KEY"