{ "schemaVersion": "1.0", "item": { "slug": "kie-ai-skill", "name": "Kie Ai Skill", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/jon-xo/kie-ai-skill", "canonicalUrl": "https://clawhub.ai/jon-xo/kie-ai-skill", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/kie-ai-skill", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=kie-ai-skill", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "README.md", "SKILL.md", "config.example.json", "kie-ai.sh", "lib/balance.py", "lib/generate-image.py" ], "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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/kie-ai-skill" }, "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/kie-ai-skill", "agentPageUrl": "https://openagent3.xyz/skills/kie-ai-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/kie-ai-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/kie-ai-skill/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "kie.ai API Wrapper", "body": "Unified access to multiple AI models through kie.ai's API. Generate images, videos, and music at 30-80% lower cost than official APIs." }, { "title": "Features", "body": "🎨 Image Generation: Nano Banana Pro (Gemini 3 Pro), Flux, 4o-image\n📤 Google Drive Upload: Optional automatic upload to Drive folder\n📊 Usage Tracking: Local task history and cost estimation\n💾 Local Storage: All files saved to images/ before optional upload\n🎬 Video Generation (coming soon): Veo 3.1, Runway Gen-4 Aleph\n🎵 Music Generation (coming soon): Suno V4/V4.5" }, { "title": "Quick Start", "body": "# Generate an image\n./kie-ai.sh generate-image \"A serene Japanese garden at sunset\"\n\n# With custom options\n./kie-ai.sh generate-image \"Cyberpunk city\" --resolution 2K --aspect 16:9\n\n# Upload to Google Drive\n./kie-ai.sh generate-image \"Space nebula\" --upload-drive\n\n# Check usage\n./kie-ai.sh balance" }, { "title": "Prerequisites", "body": "kie.ai API Key:\n\nSign up at https://kie.ai\nGet API key from dashboard\nAdd to ~/.openclaw/openclaw.json:\n\"env\": {\n \"vars\": {\n \"KIE_API_KEY\": \"your-key-here\"\n }\n}\n\n\n\n\n\n(Optional) Maton API Key for Google Drive uploads:\n\nSign up at https://maton.ai\nGet API key from https://maton.ai/settings\nSet up Google Drive connection at https://ctrl.maton.ai\nAdd to config:\n\"MATON_API_KEY\": \"your-maton-key\"" }, { "title": "Setup", "body": "# Clone to ~/src\ncd ~/src\ngit clone https://github.com/jon-xo/kie-ai-skill.git\ncd kie-ai-skill\n\n# Make executable\nchmod +x kie-ai.sh lib/*.py\n\n# Create symlink for OpenClaw\nln -s ~/src/kie-ai-skill ~/.openclaw/workspace/skills/kie-ai-skill\n\n# Test it\n./kie-ai.sh generate-image \"test image\"" }, { "title": "Google Drive Upload (Optional)", "body": "# View/edit config\n./kie-ai.sh config\n\n# Edit config.json\n{\n \"drive\": {\n \"enabled\": true,\n \"folder_id\": \"YOUR_GOOGLE_DRIVE_FOLDER_ID\"\n }\n}\n\nGet your folder ID from the Google Drive URL:\n\nhttps://drive.google.com/drive/folders/1abc...xyz\n ^^^^ this part" }, { "title": "generate-image", "body": "Generate images with various models.\n\n./kie-ai.sh generate-image [options]\n\nOptions:\n --model Model: nano-banana-pro (default), google/nano-banana, flux-kontext, 4o-image\n --resolution Resolution: 1K (default), 2K, 4K\n --aspect Aspect ratio: 1:1 (default), 16:9, 9:16, 4:3, etc.\n --upload-drive Upload to Google Drive after generation (requires config)\n\nExamples:\n\n# Basic generation\n./kie-ai.sh generate-image \"A red apple on a wooden table\"\n\n# High resolution\n./kie-ai.sh generate-image \"Mountain landscape\" --resolution 4K\n\n# Widescreen\n./kie-ai.sh generate-image \"Cinematic scene\" --resolution 2K --aspect 16:9\n\n# 16-bit pixel art\n./kie-ai.sh generate-image \"Cyberpunk lobster, 16-bit pixel art, no text\" --aspect 16:9\n\n# Generate and upload\n./kie-ai.sh generate-image \"Abstract art\" --upload-drive" }, { "title": "balance", "body": "Check credit usage and remaining balance.\n\n./kie-ai.sh balance\n\nShows:\n\nLink to web UI for actual balance\nLocal task history\nEstimated credit consumption\nUSD equivalent" }, { "title": "status", "body": "Show active/pending tasks.\n\n./kie-ai.sh status" }, { "title": "models", "body": "List available models and pricing.\n\n./kie-ai.sh models" }, { "title": "config", "body": "View/configure Google Drive upload settings.\n\n./kie-ai.sh config" }, { "title": "Pricing", "body": "Approximate costs (kie.ai vs official):\n\nModelkie.aiOfficialSavingsNano Banana Pro~18-24 credits ($0.09-$0.12)$0.1520-40%Veo 3.1VariableN/A—Flux Kontext~50 credits ($0.25)$0.30~17%Suno V4Variable$0.10/trackComparable\n\nCredit pricing: ~$0.005 per credit (1,000 credits = $5)\n\nCheck exact costs at: https://docs.kie.ai/pricing" }, { "title": "File Storage", "body": "Generated files are saved to the images/ directory (gitignored):\n\n~/src/kie-ai-skill/images/\n 2026-02-11-12-05-01-1.png\n 2026-02-11-12-09-56-1.png\n ...\n\nFormat: YYYY-MM-DD-HH-MM-SS-{index}.png\n\nRetention:\n\nLocal: Forever (or until you delete)\nkie.ai CDN: 14 days\nGoogle Drive: Forever (if uploaded)" }, { "title": "Task State", "body": "Tasks are tracked in:\n\n~/src/kie-ai-skill/.task-state.json\n\nUsed for:\n\nResume interrupted tasks\nUsage tracking\nPreventing duplicate submissions" }, { "title": "Image Generation", "body": "nano-banana-pro - Gemini 3 Pro Image (1K/2K/4K)\ngoogle/nano-banana - Gemini 2.5 Flash Image (cheaper)\nflux-kontext - Flux by Black Forest Labs\n4o-image - OpenAI GPT-4o Image" }, { "title": "Video Generation (coming soon)", "body": "veo-3.1 - Google Veo 3.1 (cinematic)\nveo-3.1-fast - Veo 3.1 Fast (cheaper)\nrunway-aleph - Runway Gen-4 Aleph" }, { "title": "Music Generation (coming soon)", "body": "suno-v4 - Suno V4 (up to 8min)\nsuno-v4.5 - Suno V4.5 Plus\n\nSee https://docs.kie.ai for full list." }, { "title": "\"KIE_API_KEY not set\"", "body": "Add to ~/.openclaw/openclaw.json:\n\n\"env\": {\n \"vars\": {\n \"KIE_API_KEY\": \"your-key-here\"\n }\n}" }, { "title": "\"Credits insufficient\"", "body": "Top up at: https://kie.ai/billing" }, { "title": "\"MATON_API_KEY not set\" (Drive upload)", "body": "Sign up at https://maton.ai\nAdd MATON_API_KEY to openclaw.json\nCreate Google Drive connection at https://ctrl.maton.ai" }, { "title": "\"Drive upload failed\"", "body": "Check MATON_API_KEY is set\nVerify Google Drive connection is active at https://ctrl.maton.ai\nEnsure folder_id in config.json is correct\nTry generating without --upload-drive first" }, { "title": "Integration with OpenClaw", "body": "Use via exec or directly in OpenClaw agent conversations:\n\n# From OpenClaw chat\nGenerate a cyberpunk city image with kie.ai\n\n# The agent will run:\ncd ~/src/kie-ai-skill && ./kie-ai.sh generate-image \"cyberpunk city\"" }, { "title": "Environment Variables", "body": "VariableRequiredPurposeKIE_API_KEYYesAuthenticates all requests to api.kie.aiMATON_API_KEYNoAuthenticates Google Drive uploads via gateway.maton.ai" }, { "title": "External Endpoints", "body": "EndpointMethodData SentUsed Byhttps://api.kie.ai/api/v1/jobs/createTaskPOSTprompt, model, resolution, aspect ratiogenerate-image.pyhttps://api.kie.ai/api/v1/jobs/recordInfoGETtask IDgenerate-image.py, watch_task.pyhttps://api.kie.ai/api/v1/chat/creditGET— (auth header only)balance.pyhttps://gateway.maton.ai/google-drive/upload/...POSTimage file bytes, filenameupload-drive.py (optional)" }, { "title": "Data Leaving This Machine", "body": "Prompt text is sent to api.kie.ai to generate images.\nGenerated image files are sent to gateway.maton.ai only when --upload-drive is explicitly passed.\nAPI keys are transmitted as Authorization: Bearer headers and are never logged or written to disk by this skill.\nNo telemetry, analytics, or usage data is collected by this skill itself." }, { "title": "Trust Statement", "body": "This skill sends data to two third-party services: kie.ai for AI generation and maton.ai as an OAuth gateway for Google Drive. Review their respective privacy policies before use. Drive upload is strictly opt-in via --upload-drive." }, { "title": "Autonomous Invocation", "body": "This skill can be invoked autonomously by an OpenClaw agent when asked to generate images. It does not execute autonomously on its own — it must be called explicitly. To prevent autonomous invocation, remove the skill symlink from your OpenClaw workspace." }, { "title": "Links", "body": "kie.ai Dashboard: https://kie.ai\nDocumentation: https://docs.kie.ai\nPricing: https://docs.kie.ai/pricing\nLogs/Balance: https://kie.ai/logs\nBilling: https://kie.ai/billing\nMaton (for Drive): https://maton.ai\nGitHub Repo: https://github.com/jon-xo/kie-ai-skill" }, { "title": "License", "body": "MIT" }, { "title": "Support", "body": "Issues: https://github.com/jon-xo/kie-ai-skill/issues" } ], "body": "kie.ai API Wrapper\n\nUnified access to multiple AI models through kie.ai's API. Generate images, videos, and music at 30-80% lower cost than official APIs.\n\nFeatures\n🎨 Image Generation: Nano Banana Pro (Gemini 3 Pro), Flux, 4o-image\n📤 Google Drive Upload: Optional automatic upload to Drive folder\n📊 Usage Tracking: Local task history and cost estimation\n💾 Local Storage: All files saved to images/ before optional upload\n🎬 Video Generation (coming soon): Veo 3.1, Runway Gen-4 Aleph\n🎵 Music Generation (coming soon): Suno V4/V4.5\nQuick Start\n# Generate an image\n./kie-ai.sh generate-image \"A serene Japanese garden at sunset\"\n\n# With custom options\n./kie-ai.sh generate-image \"Cyberpunk city\" --resolution 2K --aspect 16:9\n\n# Upload to Google Drive\n./kie-ai.sh generate-image \"Space nebula\" --upload-drive\n\n# Check usage\n./kie-ai.sh balance\n\nInstallation\nPrerequisites\n\nkie.ai API Key:\n\nSign up at https://kie.ai\nGet API key from dashboard\nAdd to ~/.openclaw/openclaw.json:\n\"env\": {\n \"vars\": {\n \"KIE_API_KEY\": \"your-key-here\"\n }\n}\n\n\n(Optional) Maton API Key for Google Drive uploads:\n\nSign up at https://maton.ai\nGet API key from https://maton.ai/settings\nSet up Google Drive connection at https://ctrl.maton.ai\nAdd to config:\n\"MATON_API_KEY\": \"your-maton-key\"\n\nSetup\n# Clone to ~/src\ncd ~/src\ngit clone https://github.com/jon-xo/kie-ai-skill.git\ncd kie-ai-skill\n\n# Make executable\nchmod +x kie-ai.sh lib/*.py\n\n# Create symlink for OpenClaw\nln -s ~/src/kie-ai-skill ~/.openclaw/workspace/skills/kie-ai-skill\n\n# Test it\n./kie-ai.sh generate-image \"test image\"\n\nConfiguration\nGoogle Drive Upload (Optional)\n# View/edit config\n./kie-ai.sh config\n\n# Edit config.json\n{\n \"drive\": {\n \"enabled\": true,\n \"folder_id\": \"YOUR_GOOGLE_DRIVE_FOLDER_ID\"\n }\n}\n\n\nGet your folder ID from the Google Drive URL:\n\nhttps://drive.google.com/drive/folders/1abc...xyz\n ^^^^ this part\n\nCommands\ngenerate-image\n\nGenerate images with various models.\n\n./kie-ai.sh generate-image [options]\n\nOptions:\n --model Model: nano-banana-pro (default), google/nano-banana, flux-kontext, 4o-image\n --resolution Resolution: 1K (default), 2K, 4K\n --aspect Aspect ratio: 1:1 (default), 16:9, 9:16, 4:3, etc.\n --upload-drive Upload to Google Drive after generation (requires config)\n\n\nExamples:\n\n# Basic generation\n./kie-ai.sh generate-image \"A red apple on a wooden table\"\n\n# High resolution\n./kie-ai.sh generate-image \"Mountain landscape\" --resolution 4K\n\n# Widescreen\n./kie-ai.sh generate-image \"Cinematic scene\" --resolution 2K --aspect 16:9\n\n# 16-bit pixel art\n./kie-ai.sh generate-image \"Cyberpunk lobster, 16-bit pixel art, no text\" --aspect 16:9\n\n# Generate and upload\n./kie-ai.sh generate-image \"Abstract art\" --upload-drive\n\nbalance\n\nCheck credit usage and remaining balance.\n\n./kie-ai.sh balance\n\n\nShows:\n\nLink to web UI for actual balance\nLocal task history\nEstimated credit consumption\nUSD equivalent\nstatus\n\nShow active/pending tasks.\n\n./kie-ai.sh status\n\nmodels\n\nList available models and pricing.\n\n./kie-ai.sh models\n\nconfig\n\nView/configure Google Drive upload settings.\n\n./kie-ai.sh config\n\nPricing\n\nApproximate costs (kie.ai vs official):\n\nModel\tkie.ai\tOfficial\tSavings\nNano Banana Pro\t~18-24 credits ($0.09-$0.12)\t$0.15\t20-40%\nVeo 3.1\tVariable\tN/A\t—\nFlux Kontext\t~50 credits ($0.25)\t$0.30\t~17%\nSuno V4\tVariable\t$0.10/track\tComparable\n\nCredit pricing: ~$0.005 per credit (1,000 credits = $5)\n\nCheck exact costs at: https://docs.kie.ai/pricing\n\nFile Storage\n\nGenerated files are saved to the images/ directory (gitignored):\n\n~/src/kie-ai-skill/images/\n 2026-02-11-12-05-01-1.png\n 2026-02-11-12-09-56-1.png\n ...\n\n\nFormat: YYYY-MM-DD-HH-MM-SS-{index}.png\n\nRetention:\n\nLocal: Forever (or until you delete)\nkie.ai CDN: 14 days\nGoogle Drive: Forever (if uploaded)\nTask State\n\nTasks are tracked in:\n\n~/src/kie-ai-skill/.task-state.json\n\n\nUsed for:\n\nResume interrupted tasks\nUsage tracking\nPreventing duplicate submissions\nAvailable Models\nImage Generation\nnano-banana-pro - Gemini 3 Pro Image (1K/2K/4K)\ngoogle/nano-banana - Gemini 2.5 Flash Image (cheaper)\nflux-kontext - Flux by Black Forest Labs\n4o-image - OpenAI GPT-4o Image\nVideo Generation (coming soon)\nveo-3.1 - Google Veo 3.1 (cinematic)\nveo-3.1-fast - Veo 3.1 Fast (cheaper)\nrunway-aleph - Runway Gen-4 Aleph\nMusic Generation (coming soon)\nsuno-v4 - Suno V4 (up to 8min)\nsuno-v4.5 - Suno V4.5 Plus\n\nSee https://docs.kie.ai for full list.\n\nTroubleshooting\n\"KIE_API_KEY not set\"\n\nAdd to ~/.openclaw/openclaw.json:\n\n\"env\": {\n \"vars\": {\n \"KIE_API_KEY\": \"your-key-here\"\n }\n}\n\n\"Credits insufficient\"\n\nTop up at: https://kie.ai/billing\n\n\"MATON_API_KEY not set\" (Drive upload)\nSign up at https://maton.ai\nAdd MATON_API_KEY to openclaw.json\nCreate Google Drive connection at https://ctrl.maton.ai\n\"Drive upload failed\"\nCheck MATON_API_KEY is set\nVerify Google Drive connection is active at https://ctrl.maton.ai\nEnsure folder_id in config.json is correct\nTry generating without --upload-drive first\nIntegration with OpenClaw\n\nUse via exec or directly in OpenClaw agent conversations:\n\n# From OpenClaw chat\nGenerate a cyberpunk city image with kie.ai\n\n# The agent will run:\ncd ~/src/kie-ai-skill && ./kie-ai.sh generate-image \"cyberpunk city\"\n\nSecurity\nEnvironment Variables\nVariable\tRequired\tPurpose\nKIE_API_KEY\tYes\tAuthenticates all requests to api.kie.ai\nMATON_API_KEY\tNo\tAuthenticates Google Drive uploads via gateway.maton.ai\nExternal Endpoints\nEndpoint\tMethod\tData Sent\tUsed By\nhttps://api.kie.ai/api/v1/jobs/createTask\tPOST\tprompt, model, resolution, aspect ratio\tgenerate-image.py\nhttps://api.kie.ai/api/v1/jobs/recordInfo\tGET\ttask ID\tgenerate-image.py, watch_task.py\nhttps://api.kie.ai/api/v1/chat/credit\tGET\t— (auth header only)\tbalance.py\nhttps://gateway.maton.ai/google-drive/upload/...\tPOST\timage file bytes, filename\tupload-drive.py (optional)\nData Leaving This Machine\nPrompt text is sent to api.kie.ai to generate images.\nGenerated image files are sent to gateway.maton.ai only when --upload-drive is explicitly passed.\nAPI keys are transmitted as Authorization: Bearer headers and are never logged or written to disk by this skill.\nNo telemetry, analytics, or usage data is collected by this skill itself.\nTrust Statement\n\nThis skill sends data to two third-party services: kie.ai for AI generation and maton.ai as an OAuth gateway for Google Drive. Review their respective privacy policies before use. Drive upload is strictly opt-in via --upload-drive.\n\nAutonomous Invocation\n\nThis skill can be invoked autonomously by an OpenClaw agent when asked to generate images. It does not execute autonomously on its own — it must be called explicitly. To prevent autonomous invocation, remove the skill symlink from your OpenClaw workspace.\n\nLinks\nkie.ai Dashboard: https://kie.ai\nDocumentation: https://docs.kie.ai\nPricing: https://docs.kie.ai/pricing\nLogs/Balance: https://kie.ai/logs\nBilling: https://kie.ai/billing\nMaton (for Drive): https://maton.ai\nGitHub Repo: https://github.com/jon-xo/kie-ai-skill\nLicense\n\nMIT\n\nSupport\n\nIssues: https://github.com/jon-xo/kie-ai-skill/issues" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/jon-xo/kie-ai-skill", "publisherUrl": "https://clawhub.ai/jon-xo/kie-ai-skill", "owner": "jon-xo", "version": "1.0.1", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/kie-ai-skill", "downloadUrl": "https://openagent3.xyz/downloads/kie-ai-skill", "agentUrl": "https://openagent3.xyz/skills/kie-ai-skill/agent", "manifestUrl": "https://openagent3.xyz/skills/kie-ai-skill/agent.json", "briefUrl": "https://openagent3.xyz/skills/kie-ai-skill/agent.md" } }