kameo-freeGenerate 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.
Install via ClawdBot CLI:
clawdbot install veya2ztn/kameo-freeTransform static images into expressive talking-head videos with realistic motion and lip-sync.
scripts/generate_video.sh <image_path> <prompt> [output_file]Example:
scripts/generate_video.sh avatar.jpg "Hello, I am an AI assistant" output.mp4Set 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:
/api/public/keys endpointscripts/register.shJust the dialogue:
"Hello, I'm here to help you today"
"こんにちは、私はガッキーです。愛してます。"Works but results are generic.
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:
For best results, use vision AI to analyze the image first:
See: scripts/enhance_prompt.sh for automated enhancement.
Base URL: https://api.kameo.chat/api/public
curl -X POST https://api.kameo.chat/api/public/generate \
-H "X-API-Key: kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs" \
-H "Content-Type: application/json" \
-d '{
"image_base64": "<base64_encoded_image>",
"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
}curl -H "X-API-Key: kam_..." \
https://api.kameo.chat/api/public/creditsResponse:
{
"permanent_credits": 294,
"subscription_credits": 0,
"total_available": 294
}curl https://api.kameo.chat/api/public/pricingCost: 3 credits per video
ffmpeg -i large.jpg -vf scale=720:-1 optimized.jpgscripts/check_credits.sh"401 Unauthorized"
"402 Insufficient credits"
scripts/check_credits.sh"Timeout errors"
"403 when downloading video"
Generated Mar 1, 2026
Enhance AI chatbots or virtual assistants by converting static avatar images into dynamic talking-head videos that greet users or deliver responses. This creates a more engaging and human-like interaction, improving user experience and trust in automated systems.
Generate short, expressive videos from portrait photos for platforms like TikTok or Instagram Stories, allowing influencers to post dynamic content without filming. Use enhanced prompts to match specific moods or themes, increasing follower engagement and content variety.
Create talking-head videos from static images of educators or characters to produce video tutorials or online courses. This reduces production costs and time, enabling rapid content generation in multiple languages for global e-learning platforms.
Transform product photos or spokesperson images into animated videos that demonstrate features or pitch sales. Use this to add a personal touch to marketing materials, making them more compelling for B2B or B2C audiences.
Generate videos of company representatives speaking in different languages from a single image, facilitating global outreach. This is useful for internal announcements, training, or external messaging without needing multilingual actors.
Offer limited free credits to attract users, then charge for additional video generations via subscription or pay-per-use plans. Monetize by selling API keys and premium features like faster processing or higher-quality outputs.
License the technology to businesses for integrating into their own applications, such as customer service tools or content creation software. Charge based on user volume or enterprise agreements, providing customization and support services.
Build a platform where users can generate and sell custom talking-head videos for specific niches like education or marketing. Take a commission on transactions and offer premium templates or enhanced prompt services to boost sales.
💬 Integration Tip
Start by setting up the API key via environment variables and test with simple prompts before scaling to enhanced prompts for better results.
iMessage/SMS CLI for listing chats, history, watch, and sending.
Use when you need to control Discord from Clawdbot via the discord tool: send messages, react, post or upload stickers, upload emojis, run polls, manage threads/pins/search, fetch permissions or member/role/channel info, or handle moderation actions in Discord DMs or channels.
Use when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Send WhatsApp messages to other people or search/sync WhatsApp history via the wacli CLI (not for normal user chats).
Build or update the BlueBubbles external channel plugin for Clawdbot (extension package, REST send/probe, webhook inbound).
OpenClaw skill for designing Telegram Bot API workflows and command-driven conversations using direct HTTPS requests (no SDKs).