/install ai-video-maker
AIVideoMaker API Executor
Purpose
Provide a production-ready execution workflow for AIVideoMaker API v1:
- Create generation task
- Poll task status safely
- Fetch task details
- Cancel submitted task
When To Use
- User asks to call
aivideomaker.aiAPI directly - User wants a scriptable generation workflow
- User needs robust retry/429 handling for task queries
Required Environment
AIVIDEO_API_KEY(required) Get an API Key from https://aivideomaker.ai .AIVIDEO_TIMEOUT_MS(optional, default30000) - Request timeout in millisecondsAIVIDEO_MAX_RETRIES(optional, default3) - Max retries for idempotent read requests
Supported Actions
createGenerationgetTaskgetStatuscancelTask
Model Whitelist
t2vi2vlvt2v_v3i2v_v3
Image Input Policy
- This skill accepts both public image URLs and
data:image/...;base64,...fori2v,lv, andi2v_v3. - Prefer
data:image/...;base64,...for reliability in OpenClaw environments.
Standard Workflow
- Validate model and payload by contract.
- Call
createGeneration. - Poll
getStatuswith backoff until terminal status. - If
COMPLETED, callgetTaskand return output. - If
FAILED, return failure with actionable next steps.
Error Policy
- Normalize all responses to:
ok,status,taskId,data,errorCode,errorMessage,retryAfter
- Map API/runtime errors into stable error codes:
INVALID_MODELINVALID_PAYLOADAUTH_FAILEDRATE_LIMITEDINSUFFICIENT_CREDITSTASK_NOT_FOUNDNETWORK_ERRORUNKNOWN_ERROR
Execution Commands
- Run full workflow:
node scripts/run-workflow.mjs --model \x3Cmodel> --payload '\x3Cjson_payload>'
- Query status:
node scripts/run-workflow.mjs --action getStatus --taskId \x3Ctask_id>
- Query task details:
node scripts/run-workflow.mjs --action getTask --taskId \x3Ctask_id>
- Cancel task:
node scripts/run-workflow.mjs --action cancelTask --taskId \x3Ctask_id>
Security
This skill only performs the following actions:
- Calls the AIVideoMaker API with user-provided parameters
- Validates input payloads against a defined contract
- Reads only payload passed via
--payload - Does not read arbitrary host files, credentials, or sensitive system information
- Does not execute arbitrary code or shell commands
All network requests are made to https://aivideomaker.ai (or an optional custom base URL configured via client options) and include only the API key for authentication. The API key is sent as an HTTP header named key (as required by the AIVideoMaker API). While HTTPS encrypts the transmission, intermediaries may log the key header. Users should be aware of privacy implications when sending image data and API keys to upstream services.
Security Best Practices:
- Never hardcode API keys in source code, configuration files, or skill archives
- Always pass the
AIVIDEO_API_KEYas an environment variable - Use secret management tools or platform-specific credential storage
- Regularly rotate API keys and monitor usage
Additional Resources
- Full API matrix: references/api-reference.md
- Usage and failure scenarios: references/examples.md
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install ai-video-maker - 安装完成后,直接呼叫该 Skill 的名称或使用
/ai-video-maker触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
AIVideomaker 是什么?
Executes AIVideoMaker API workflows for text-to-video and image-to-video generation, including task creation, status polling, task details retrieval, and can... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 283 次。
如何安装 AIVideomaker?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install ai-video-maker」即可一键安装,无需额外配置。
AIVideomaker 是免费的吗?
是的,AIVideomaker 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
AIVideomaker 支持哪些平台?
AIVideomaker 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 AIVideomaker?
由 husu(@husu)开发并维护,当前版本 v1.0.14。