- name
- aivideo-api-executor
- description
- Executes AIVideoMaker API workflows for text-to-video and image-to-video generation, including task creation, status polling, task details retrieval, and cancellation. Use when users ask to generate videos via API, monitor generation progress, cancel tasks, or automate AIVideoMaker API operations.
- version
- 1.0.12
- metadata
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_MODEL - INVALID_PAYLOAD - AUTH_FAILED - RATE_LIMITED - INSUFFICIENT_CREDITS - TASK_NOT_FOUND - NETWORK_ERROR - UNKNOWN_ERROR
Execution Commands
- Run full workflow:
- node scripts/run-workflow.mjs --model <model> --payload '<json_payload>'
- Query status:
- node scripts/run-workflow.mjs --action getStatus --taskId <task_id>
- Query task details:
- node scripts/run-workflow.mjs --action getTask --taskId <task_id>
- Cancel task:
- node scripts/run-workflow.mjs --action cancelTask --taskId <task_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.
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