aivideo-api-executor

# 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.ai` API 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](https://aivideomaker.ai) . - `AIVIDEO_TIMEOUT_MS` (optional, default `30000`) - Request timeout in milliseconds - `AIVIDEO_MAX_RETRIES` (optional, default `3`) - Max retries for idempotent read requests ## Supported Actions 1. `createGeneration` 2. `getTask` 3. `getStatus` 4. `cancelTask` ## Model Whitelist - `t2v` - `i2v` - `lv` - `t2v_v3` - `i2v_v3` ## Image Input Policy - This skill accepts both public image URLs and `data:image/...;base64,...` for `i2v`, `lv`, and `i2v_v3`. - Prefer `data:image/...;base64,...` for reliability in OpenClaw environments. ## Standard Workflow 1. Validate model and payload by contract. 2. Call `createGeneration`. 3. Poll `getStatus` with backoff until terminal status. 4. If `COMPLETED`, call `getTask` and return output. 5. 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_KEY` as 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](references/api-reference.md) - Usage and failure scenarios: [references/examples.md](references/examples.md)