{
  "schemaVersion": "1.0",
  "item": {
    "slug": "kameo",
    "name": "kameo",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/veya2ztn/kameo",
    "canonicalUrl": "https://clawhub.ai/veya2ztn/kameo",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/kameo",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kameo",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "package.json",
      "SKILL.md",
      "USAGE.md",
      "scripts/check_credits.sh",
      "scripts/enhance_prompt.sh",
      "scripts/generate_enhanced.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/kameo"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/kameo",
    "agentPageUrl": "https://openagent3.xyz/skills/kameo/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kameo/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kameo/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Kameo AI - Talking Head Video Generation",
        "body": "Transform static images into expressive talking-head videos with realistic motion and lip-sync."
      },
      {
        "title": "Quick Start",
        "body": "scripts/generate_video.sh <image_path> <prompt> [output_file]\n\nExample:\n\nscripts/generate_video.sh avatar.jpg \"Hello, I am an AI assistant\" output.mp4"
      },
      {
        "title": "What It Does",
        "body": "Takes a static image (portrait/avatar)\nAdds realistic facial motion, expressions, and lip-sync based on your prompt\nGenerates 5-second video in 9:16, 16:9, or 1:1 aspect ratio\nReturns CDN URL instantly (processing ~10-30 seconds)"
      },
      {
        "title": "Authentication",
        "body": "Set your Kameo API key:\n\nexport KAMEO_API_KEY=\"kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs\"\n\nOr store in ~/.config/kameo/credentials.json:\n\n{\n  \"api_key\": \"kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs\"\n}\n\nGetting an API Key:\n\nRegister at kameo.chat (requires email verification)\nLogin to get JWT token\nCreate API key via /api/public/keys endpoint\nOr use the registration helper: scripts/register.sh"
      },
      {
        "title": "Basic Prompts (Simple)",
        "body": "Just the dialogue:\n\n\"Hello, I'm here to help you today\"\n\"こんにちは、私はガッキーです。愛してます。\"\n\nWorks but results are generic."
      },
      {
        "title": "Enhanced Prompts (Recommended)",
        "body": "Format:\n\n[Detailed scene/environment], [person's complete appearance and expression], speaking in [tone], \"[DIALOGUE]\". [Camera and lighting details].\n\nExample:\n\nIn 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.\n\nWhy Enhanced Prompts Matter:\n\nBetter facial expressions matching the scene context\nMore natural motion and gestures\nImproved lip-sync quality\nContextual emotional delivery"
      },
      {
        "title": "Prompt Enhancement Workflow",
        "body": "For best results, use vision AI to analyze the image first:\n\nFeed the image to a vision model (Gemini, GPT-4V, Claude)\nAsk it to describe the scene in cinematic detail\nInsert your dialogue into the description\nUse the enhanced prompt for Kameo\n\nSee: scripts/enhance_prompt.sh for automated enhancement."
      },
      {
        "title": "API Details",
        "body": "Base URL: https://api.kameo.chat/api/public"
      },
      {
        "title": "Generate Video",
        "body": "curl -X POST https://api.kameo.chat/api/public/generate \\\n  -H \"X-API-Key: kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"image_base64\": \"<base64_encoded_image>\",\n    \"prompt\": \"Your detailed prompt here\",\n    \"seconds\": 5,\n    \"aspect_ratio\": \"9:16\"\n  }'\n\nParameters:\n\nimage_base64 (required): Base64-encoded JPEG/PNG\nprompt (required): Dialogue and/or scene description\nseconds (optional): 5 (default) or 10\naspect_ratio (optional): \"9:16\" (default), \"16:9\", or \"1:1\"\n\nResponse:\n\n{\n  \"job_id\": \"uuid\",\n  \"status\": \"completed\",\n  \"video_url\": \"https://cdn.kameo.chat/videos/{uuid}.mp4\",\n  \"duration_seconds\": 5,\n  \"processing_time_ms\": 15000\n}"
      },
      {
        "title": "Check Credits",
        "body": "curl -H \"X-API-Key: kam_...\" \\\n  https://api.kameo.chat/api/public/credits\n\nResponse:\n\n{\n  \"permanent_credits\": 294,\n  \"subscription_credits\": 0,\n  \"total_available\": 294\n}"
      },
      {
        "title": "Pricing",
        "body": "curl https://api.kameo.chat/api/public/pricing\n\nCost: 3 credits per video"
      },
      {
        "title": "Performance",
        "body": "Processing time: 8-35 seconds (depends on aspect ratio and queue)\n9:16 (portrait): ~30-35s\n16:9 (landscape): ~15-20s\n1:1 (square): ~10-15s"
      },
      {
        "title": "Best Practices",
        "body": "Optimize image size - Resize large images before encoding (saves bandwidth, faster upload)\nffmpeg -i large.jpg -vf scale=720:-1 optimized.jpg\n\n\n\nUse descriptive prompts - Enhanced prompts = better results\n\n\nChoose aspect ratio wisely\n\n9:16: Mobile/social media (TikTok, Instagram Stories)\n16:9: Desktop/YouTube\n1:1: Profile pictures, square posts\n\n\n\nMonitor credits - Check balance with scripts/check_credits.sh"
      },
      {
        "title": "Limitations",
        "body": "CDN access: Video URLs may have time-limited access or require authentication\nDownload: Videos may return 403 when downloaded via curl (use browser or authenticated session)\nRate limits: 10 generations per minute"
      },
      {
        "title": "Troubleshooting",
        "body": "\"401 Unauthorized\"\n\nCheck your API key is set correctly\nVerify key hasn't been revoked\n\n\"402 Insufficient credits\"\n\nCheck credit balance: scripts/check_credits.sh\nNeed to add credits at kameo.chat\n\n\"Timeout errors\"\n\n9:16 videos take longer (~30s)\nIncrease timeout in scripts\nRetry if server is busy\n\n\"403 when downloading video\"\n\nCDN URLs may be time-limited\nTry accessing in browser immediately after generation\nOr save the base64 response if available"
      },
      {
        "title": "Use Cases",
        "body": "AI character videos - Bring bot avatars to life\nSocial media content - Dynamic profile videos\nDemos and presentations - Talking product demos\nEducational content - Video tutorials with AI presenters\nMultilingual content - Same avatar speaking different languages"
      }
    ],
    "body": "Kameo AI - Talking Head Video Generation\n\nTransform static images into expressive talking-head videos with realistic motion and lip-sync.\n\nQuick Start\nscripts/generate_video.sh <image_path> <prompt> [output_file]\n\n\nExample:\n\nscripts/generate_video.sh avatar.jpg \"Hello, I am an AI assistant\" output.mp4\n\nWhat It Does\nTakes a static image (portrait/avatar)\nAdds realistic facial motion, expressions, and lip-sync based on your prompt\nGenerates 5-second video in 9:16, 16:9, or 1:1 aspect ratio\nReturns CDN URL instantly (processing ~10-30 seconds)\nAuthentication\n\nSet your Kameo API key:\n\nexport KAMEO_API_KEY=\"kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs\"\n\n\nOr store in ~/.config/kameo/credentials.json:\n\n{\n  \"api_key\": \"kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs\"\n}\n\n\nGetting an API Key:\n\nRegister at kameo.chat (requires email verification)\nLogin to get JWT token\nCreate API key via /api/public/keys endpoint\nOr use the registration helper: scripts/register.sh\nPrompt Engineering\nBasic Prompts (Simple)\n\nJust the dialogue:\n\n\"Hello, I'm here to help you today\"\n\"こんにちは、私はガッキーです。愛してます。\"\n\n\nWorks but results are generic.\n\nEnhanced Prompts (Recommended)\n\nFormat:\n\n[Detailed scene/environment], [person's complete appearance and expression], speaking in [tone], \"[DIALOGUE]\". [Camera and lighting details].\n\n\nExample:\n\nIn 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.\n\n\nWhy Enhanced Prompts Matter:\n\nBetter facial expressions matching the scene context\nMore natural motion and gestures\nImproved lip-sync quality\nContextual emotional delivery\nPrompt Enhancement Workflow\n\nFor best results, use vision AI to analyze the image first:\n\nFeed the image to a vision model (Gemini, GPT-4V, Claude)\nAsk it to describe the scene in cinematic detail\nInsert your dialogue into the description\nUse the enhanced prompt for Kameo\n\nSee: scripts/enhance_prompt.sh for automated enhancement.\n\nAPI Details\n\nBase URL: https://api.kameo.chat/api/public\n\nGenerate Video\ncurl -X POST https://api.kameo.chat/api/public/generate \\\n  -H \"X-API-Key: kam_I3rdx43IymFNbfBw1c0ZbSc7o3aUfQgz8cljZA6T7fs\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\n    \"image_base64\": \"<base64_encoded_image>\",\n    \"prompt\": \"Your detailed prompt here\",\n    \"seconds\": 5,\n    \"aspect_ratio\": \"9:16\"\n  }'\n\n\nParameters:\n\nimage_base64 (required): Base64-encoded JPEG/PNG\nprompt (required): Dialogue and/or scene description\nseconds (optional): 5 (default) or 10\naspect_ratio (optional): \"9:16\" (default), \"16:9\", or \"1:1\"\n\nResponse:\n\n{\n  \"job_id\": \"uuid\",\n  \"status\": \"completed\",\n  \"video_url\": \"https://cdn.kameo.chat/videos/{uuid}.mp4\",\n  \"duration_seconds\": 5,\n  \"processing_time_ms\": 15000\n}\n\nCheck Credits\ncurl -H \"X-API-Key: kam_...\" \\\n  https://api.kameo.chat/api/public/credits\n\n\nResponse:\n\n{\n  \"permanent_credits\": 294,\n  \"subscription_credits\": 0,\n  \"total_available\": 294\n}\n\nPricing\ncurl https://api.kameo.chat/api/public/pricing\n\n\nCost: 3 credits per video\n\nPerformance\nProcessing time: 8-35 seconds (depends on aspect ratio and queue)\n9:16 (portrait): ~30-35s\n16:9 (landscape): ~15-20s\n1:1 (square): ~10-15s\nBest Practices\n\nOptimize image size - Resize large images before encoding (saves bandwidth, faster upload)\n\nffmpeg -i large.jpg -vf scale=720:-1 optimized.jpg\n\n\nUse descriptive prompts - Enhanced prompts = better results\n\nChoose aspect ratio wisely\n\n9:16: Mobile/social media (TikTok, Instagram Stories)\n16:9: Desktop/YouTube\n1:1: Profile pictures, square posts\n\nMonitor credits - Check balance with scripts/check_credits.sh\n\nLimitations\nCDN access: Video URLs may have time-limited access or require authentication\nDownload: Videos may return 403 when downloaded via curl (use browser or authenticated session)\nRate limits: 10 generations per minute\nTroubleshooting\n\n\"401 Unauthorized\"\n\nCheck your API key is set correctly\nVerify key hasn't been revoked\n\n\"402 Insufficient credits\"\n\nCheck credit balance: scripts/check_credits.sh\nNeed to add credits at kameo.chat\n\n\"Timeout errors\"\n\n9:16 videos take longer (~30s)\nIncrease timeout in scripts\nRetry if server is busy\n\n\"403 when downloading video\"\n\nCDN URLs may be time-limited\nTry accessing in browser immediately after generation\nOr save the base64 response if available\nUse Cases\nAI character videos - Bring bot avatars to life\nSocial media content - Dynamic profile videos\nDemos and presentations - Talking product demos\nEducational content - Video tutorials with AI presenters\nMultilingual content - Same avatar speaking different languages"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/veya2ztn/kameo",
    "publisherUrl": "https://clawhub.ai/veya2ztn/kameo",
    "owner": "veya2ztn",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/kameo",
    "downloadUrl": "https://openagent3.xyz/downloads/kameo",
    "agentUrl": "https://openagent3.xyz/skills/kameo/agent",
    "manifestUrl": "https://openagent3.xyz/skills/kameo/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/kameo/agent.md"
  }
}