The essential architectural blueprint for integrating Revid's video generation engine into any AI agent workflow.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install revid-api-foundations
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install revid-api-foundations using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Revid API Foundations?
Revid API Foundations serves as the critical backbone for all video-related Openclaw Skills, providing a unified interface for programmatic video creation. It abstracts the complexities of the Revid V3 API, establishing a standardized contract for authentication, endpoint interaction, and asynchronous result handling. By loading these foundations once, developers ensure their AI agents possess the prerequisite knowledge to navigate the single render endpoint architecture and manage the full video production lifecycle from request to final asset delivery.
This skill is designed to handle the heavy lifting of video engineering, including source mapping and response envelope parsing. It allows developers to focus on creative inputs—like scripts, articles, or prompts—while the foundation ensures technical reliability. Whether you are building a tool for TikTok automation or LinkedIn video content, these Openclaw Skills foundations provide the stability and consistency required for high-scale media generation.
Revid API Foundations Use Cases
- Establishing a secure connection to the Revid V3 API using key-based authentication.
- Selecting the correct video generation workflow based on input types like raw text, URLs, or images.
- Managing long-running video render tasks through efficient polling or webhook integration.
- Standardizing video output parameters across different social media platforms (9:16, 16:9, 1:1).
- Optimizing credit usage and handling API error states like scraping failures or insufficient funds.
How Revid API Foundations Works
- Authentication: The skill initializes the session by verifying the presence of the REVID_API_KEY in the request headers.
- Workflow Selection: It maps the user's input (e.g., a blog URL or a script) to one of the 9 specific Revid workflows such as script-to-video or article-to-video.
- Request Dispatch: A POST request is sent to the central render endpoint with the chosen workflow and source configuration.
- Task Tracking: The skill captures the process ID (PID) from the initial response to track the render's progress.
- State Management: It enters a polling loop or waits for a webhook trigger, checking the status until the video transitions from processing to ready.
- Asset Retrieval: Upon completion, the skill extracts the final video URL and metadata from the response envelope for use in the calling application.
Revid API Foundations Setup
To use these Revid-powered Openclaw Skills, you must first configure your environment with your Revid API Key.
# Export your API key to your environment
export REVID_API_KEY="your_api_key_here"
# Basic authentication check
curl -H "key: $REVID_API_KEY" https://www.revid.ai/api/public/v3/render
Ensure that your agent is configured to handle JSON responses and can perform basic HTTP loops for status polling.
Revid API Foundations Data Schema & Taxonomy
Revid API Foundations utilizes a specific mapping between workflows and data sources to ensure successful renders.
| Workflow | Required Data Field | Input Content Type |
|---|---|---|
| script-to-video | source.text |
Plain text scripts |
| article-to-video | source.url |
Webpage or blog URLs |
| avatar-to-video | source.text + avatar.url |
Script and headshot image |
| prompt-to-video | source.prompt |
AI-assisted video ideas |
| music-to-video | source.url |
Audio file link |
All successful responses return a JSON envelope containing success: 1 and a unique pid for tracking.
Revid API Foundations Advanced Features
- Webhook Integration: Support for
webhookUrlto replace polling, enabling event-driven video generation architectures. - Credit Calculation: Pre-flight checks using the
calculate-creditsendpoint to estimate costs before initiating a render. - Multi-Model Support: Access to high-end video models like Veo3 and Sora2 by adjusting the
media.videoModelparameter. - Automated Fallbacks: Logic to handle scraping 403 errors by switching from URL-based input to manual text injection.
- Dynamic Resizing: Global settings for
aspectRatiothat automatically format content for Reels, YouTube, or LinkedIn.
SKILL.md
Loading
Related Openclaw Skills
Koenigsegg Automotive Intelligence
A specialized research skill focused on the technical innovations and business strategies of the Swedish hypercar manufacturer Koenigsegg.
Longines Brand Intelligence
A specialized research skill for analyzing Longines' historical timeline, market data, and competitive positioning in the luxury watch industry.
Shopify Product to Promo Video
Transform any e-commerce product URL into a high-energy 9:16 vertical promo video for social media automatically.
Mammut Brand Intelligence Skill
A technical intelligence skill providing deep insights into Mammut's Swiss heritage, mountaineering safety innovations, and premium outdoor gear evolution.
Kenzo Brand Intelligence
A specialized intelligence module for analyzing the Kenzo brand's evolution from Jungle Jap to its current status under LVMH and Nigo.
JW Anderson Brand Intelligence
A strategic intelligence skill for analyzing the business growth and gender-fluid design leadership of the JW Anderson fashion house.
Featured*
