kameo
by @veya2ztn
Generate expressive talking-head videos from static images using Kameo AI. Converts static avatars/portraits into dynamic 5-second videos with realistic facial expressions, lip-sync, and motion. Use when you need to bring static images to life, create AI character videos, demonstrate visual communication, or generate talking avatars from photos.
clawhub install kameoπ About This Skill
name: kameo description: Generate expressive talking-head videos from static images using Kameo AI. Converts static avatars/portraits into dynamic 5-second videos with realistic facial expressions, lip-sync, and motion. Use when you need to bring static images to life, create AI character videos, demonstrate visual communication, or generate talking avatars from photos.
Kameo AI - Talking Head Video Generation
Transform static images into expressive talking-head videos with realistic motion and lip-sync.
Quick Start
scripts/generate_video.sh [output_file]
Example:
scripts/generate_video.sh avatar.jpg "Hello, I am an AI assistant" output.mp4
What It Does
Authentication
Set your Kameo API key:
export KAMEO_API_KEY="kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs"
Or store in ~/.config/kameo/credentials.json:
{
"api_key": "kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs"
}
Getting an API Key:
1. Register at kameo.chat (requires email verification)
2. Login to get JWT token
3. Create API key via /api/public/keys endpoint
4. Or use the registration helper: scripts/register.sh
Prompt Engineering
Basic Prompts (Simple)
Just the dialogue:
"Hello, I'm here to help you today"
"γγγ«γ‘γ―γη§γ―γ¬γγγΌγ§γγζγγ¦γΎγγ"
Works but results are generic.
Enhanced Prompts (Recommended)
Format:
[Detailed scene/environment], [person's complete appearance and expression], speaking in [tone], "[DIALOGUE]". [Camera and lighting details].
Example:
In a bright outdoor winter setting with soft, overcast daylight, a young woman with long dark hair wearing a white knitted winter hat with ear flaps and a colorful patterned sweater stands centered in frame. She looks directly into the camera with a warm, genuine smile, her eyes crinkling with joy, speaking in a cheerful, affectionate tone, "γγγ«γ‘γ―γη§γ―γ¬γγγΌγ§γγζγγ¦γΎγγ" The scene is captured in a medium close-up shot, framed at eye level. The lighting is natural and diffused from above, creating soft, even illumination.
Why Enhanced Prompts Matter:
Prompt Enhancement Workflow
For best results, use vision AI to analyze the image first:
1. Feed the image to a vision model (Gemini, GPT-4V, Claude) 2. Ask it to describe the scene in cinematic detail 3. Insert your dialogue into the description 4. Use the enhanced prompt for Kameo
See: scripts/enhance_prompt.sh for automated enhancement.
API Details
Base URL: https://api.kameo.chat/api/public
Generate Video
curl -X POST https://api.kameo.chat/api/public/generate \
-H "X-API-Key: kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs" \
-H "Content-Type: application/json" \
-d '{
"image_base64": "",
"prompt": "Your detailed prompt here",
"seconds": 5,
"aspect_ratio": "9:16"
}'
Parameters:
image_base64 (required): Base64-encoded JPEG/PNGprompt (required): Dialogue and/or scene descriptionseconds (optional): 5 (default) or 10aspect_ratio (optional): "9:16" (default), "16:9", or "1:1"Response:
{
"job_id": "uuid",
"status": "completed",
"video_url": "https://cdn.kameo.chat/videos/{uuid}.mp4",
"duration_seconds": 5,
"processing_time_ms": 15000
}
Check Credits
curl -H "X-API-Key: kam_..." \
https://api.kameo.chat/api/public/credits
Response:
{
"permanent_credits": 294,
"subscription_credits": 0,
"total_available": 294
}
Pricing
curl https://api.kameo.chat/api/public/pricing
Cost: 3 credits per video
Performance
Best Practices
1. Optimize image size - Resize large images before encoding (saves bandwidth, faster upload)
ffmpeg -i large.jpg -vf scale=720:-1 optimized.jpg
2. Use descriptive prompts - Enhanced prompts = better results
3. Choose aspect ratio wisely - 9:16: Mobile/social media (TikTok, Instagram Stories) - 16:9: Desktop/YouTube - 1:1: Profile pictures, square posts
4. Monitor credits - Check balance with scripts/check_credits.sh
Limitations
Troubleshooting
"401 Unauthorized"
"402 Insufficient credits"
scripts/check_credits.sh"Timeout errors"
"403 when downloading video"
Use Cases
β‘ When to Use
π‘ Examples
scripts/generate_video.sh [output_file]
Example:
scripts/generate_video.sh avatar.jpg "Hello, I am an AI assistant" output.mp4
π Tips & Best Practices
1. Optimize image size - Resize large images before encoding (saves bandwidth, faster upload)
ffmpeg -i large.jpg -vf scale=720:-1 optimized.jpg
2. Use descriptive prompts - Enhanced prompts = better results
3. Choose aspect ratio wisely - 9:16: Mobile/social media (TikTok, Instagram Stories) - 16:9: Desktop/YouTube - 1:1: Profile pictures, square posts
4. Monitor credits - Check balance with scripts/check_credits.sh