名称： kameo
描述： 使用 Kameo AI 从静态图像生成富有表现力的说话头部视频。将静态头像/肖像转换为具有逼真面部表情、唇形同步和动作的动态 5 秒视频。适用于需要让静态图像活起来、创建 AI 角色视频、展示视觉交流或从照片生成说话头像的场景。
将静态图像转换为具有逼真动作和唇形同步的富有表现力的说话头部视频。
scripts/generate_video.sh <图片路径> <提示词> [输出文件]
示例：
scripts/generate_video.sh avatar.jpg "你好，我是一个 AI 助手" output.mp4
设置您的 Kameo API 密钥：
export KAMEO_API_KEY="kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs"
或存储在 ~/.config/kameo/credentials.json 文件中：
{
"api_key": "kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs"
}
获取 API 密钥：
/api/public/keys 端点创建 API 密钥scripts/register.sh仅包含对话：
"你好，我今天来帮助你"
"こんにちは、私はガッキーです。愛してます。"
可以使用，但效果较为通用。
格式：
[详细场景/环境描述]，[人物完整外貌和表情]，以[语气]说话，"[对话内容]"。[镜头和灯光细节]。
示例：
在一个明亮的户外冬日场景中，柔和、阴天的日光下，一位年轻女子留着深色长发，戴着白色针织冬帽（带耳罩），身穿彩色图案毛衣，居中站立在画面中。她直视镜头，带着温暖、真诚的微笑，眼睛因喜悦而微眯，以欢快、亲切的语气说道："こんにちは、私はガッキーです。愛してます。" 场景采用中近景拍摄，取景于视线高度。光线自然，从上方漫射下来，形成柔和均匀的照明。
为何使用增强提示词：
- 面部表情更贴合场景上下文
- 动作和手势更自然
- 唇形同步质量更高
- 情感表达更具情境感
为获得最佳效果，建议先用视觉 AI 分析图像：
参考： scripts/enhance_prompt.sh 脚本可实现自动化增强。
基础 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编码的图片>",
"prompt": "您的详细提示词",
"seconds": 5,
"aspect_ratio": "9:16"
}'
参数：
- image_base64（必需）：Base64 编码的 JPEG/PNG 图像
- prompt（必需）：对话和/或场景描述
- seconds（可选）：5（默认）或 10
- aspect_ratio（可选）："9:16"（默认）、"16:9" 或 "1:1"
响应：
{
"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/credits
响应：
{
"permanent_credits": 294,
"subscription_credits": 0,
"total_available": 294
}
curl https://api.kameo.chat/api/public/pricing
费用： 每视频 3 个额度
优化图像尺寸 - 编码前调整大图尺寸（节省带宽，上传更快）
bash
ffmpeg -i large.jpg -vf scale=720:-1 optimized.jpg
使用描述性提示词 - 增强提示词 = 更好效果
明智选择宽高比
监控额度 - 使用 scripts/check_credits.sh 检查余额
"401 未授权"
- 检查 API 密钥是否正确设置
- 确认密钥未被撤销
"402 额度不足"
- 检查额度余额：scripts/check_credits.sh
- 需要在 kameo.chat 添加额度
"超时错误"
- 9:16 视频处理时间较长（约 30 秒）
- 在脚本中增加超时时间
- 服务器繁忙时可重试
"下载视频时返回 403"
- CDN 链接可能有时限
- 生成后立即在浏览器中访问
- 或者保存可用的 base64 响应