사용 방법
- 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
- 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
- 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/tavus-engineering/tavus-skills --skill tavus-video-gen시작 전 확인
- 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
- 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서
원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.
Tavus Video Generation Skill
Generate personalized AI videos with replicas speaking your script.
Quick Start
bash
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": "Hey there! Welcome to our product demo."
}'Response:
json
{
"video_id": "1e30440cf9",
"status": "queued"
}Full API Options
bash
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
}'Parameters
| Param | Description |
|---|---|
replica_id | Required. Stock or custom replica ID |
script | Text for replica to speak (use this OR audio_url) |
audio_url | Pre-recorded audio (.wav/.mp3) for replica to lip-sync |
video_name | Display name |
callback_url | Webhook for completion/error |
background_url | Website URL to record as background |
background_source_url | Video file URL for background |
watermark_url | PNG/JPEG logo overlay |
fast | Quick render (disables some features) |
transparent_background | WebM with alpha (requires fast: true) |
Using Audio Instead of Script
json
{
"replica_id": "rfe12d8b9597",
"audio_url": "https://s3.../narration.mp3"
}Supported formats: .wav, .mp3
Background Options
Website Background
Records a scrolling website as the background:
json
{
"background_url": "https://example.com/landing-page"
}Video Background
Uses a video file:
json
{
"background_source_url": "https://s3.../promo-bg.mp4"
}Transparent Background
For compositing in video editors:
json
{
"fast": true,
"transparent_background": true
}Outputs .webm with alpha channel.
Check Video Status
bash
curl https://tavusapi.com/v2/videos/{video_id} \
-H "x-api-key: YOUR_API_KEY"Status values: queued, generating, ready, error, deleted
When ready:
json
{
"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"
}Webhook Callback
On completion:
json
{
"video_id": "1e30440cf9",
"status": "ready",
"hosted_url": "https://videos.tavus.io/video/1e30440cf9",
"download_url": "...",
"stream_url": "..."
}On error:
json
{
"video_id": "xxx",
"status": "error",
"status_details": "Error message here"
}Scripting Best Practices
- Keep under 5 minutes for quality/engagement
- Write conversationally (speak out loud to test)
- Use punctuation to indicate pauses
- Clear structure: intro → body → CTA
- Break long content into multiple videos
List & Delete Videos
bash
# 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"