What can the VIDEO AI ME API and MCP server do?
Last updated:
The VIDEO AI ME API and MCP server give AI agents and scripts access to 45 skills: generating UGC-style ads, product ads, explainers, and talking-head clips, adding captions, creating actors, cloning voices, publishing and scheduling posts to social accounts, and checking run status. Access requires an API key on an active Pro or Premium plan; 1 credit = 1 cent.
One skill registry backs both surfaces: the REST API (OpenAPI spec) and the hosted MCP server at https://videoai.me/api/v1/mcp, so the tables below are the source of truth for both.
Makers
Skills that create or transform video. Maker runs spend real credits (1 credit = 1 cent) and quote their estimated cost before anything is charged.
| Skill | What it does | Credits | Typical time |
|---|---|---|---|
| Make a UGC Admake_ugc_ad | Creates a talking-head UGC ad: one creator filming themselves at home, speaking a script written from your brief. | 220 to 2880 credits | 12 to 25 minutes |
| Make a Product Admake_product_ad | Creates a polished product ad from a short brief: storyboard, key visuals, then one continuous video with sound. | 55 to 960 credits | 12 to 25 minutes |
| Make an Explainer Videomake_explainer | Creates a paper-collage explainer video with baked-in narration from a topic and a short brief (a narrated scene-by-scene script, one collage board per scene, then animated clips cut together). | 110 to 1920 credits | 12 to 25 minutes |
| Make a Talking Head Clipmake_talking_head | Animates one of the user's saved actor looks into a talking-head video clip (5 or 10 seconds). | 35 to 70 credits | 4 to 10 minutes |
| Add Captionsadd_captions | Transcribes a completed video and burns word-level captions into the picture, returning the captioned video URL. | Free | 2 to 7 minutes |
| Create an Actorcreate_actor | Creates a reusable actor from a photo in the user's images storage, and launches its 4 automatic looks. | Free | 1 to 4 minutes |
| Clone a Voiceclone_voice | Clones a custom voice from an audio sample in the user's voice sample storage. | Free | 1 to 2 minutes |
Publishing
Skills that post finished videos to connected social accounts and read back how they performed. Free, but posting always confirms the platform list first.
| Skill | What it does | Credits | Typical time |
|---|---|---|---|
| Publish a Videopublish_video | Publishes or schedules a finished video to the user's connected social accounts. | Free | under 2 minutes |
| Schedule a Postschedule_post | Schedules a finished video onto the user's posting queue (useQueue: true takes the next free slot of their weekly schedule) or at an explicit time (scheduledAt). | Free | under 2 minutes |
| Get Post Performanceget_performance | Reads how the user's published posts performed: per-platform delivery status, metrics (views, likes, comments, shares, clicks) and totals per post. | Free | seconds |
Discovery
Free, read-only catalog skills agents call before spending anything: templates, actors, voices, brand memory, and connected accounts.
| Skill | What it does | Credits | Typical time |
|---|---|---|---|
| List Video Templateslist_templates | Lists every video template the platform can run: id, what it makes, supported durations and aspect ratios, and the honest credit cost range (1 credit = 1 cent). | Free | seconds |
| List Actorslist_actors | Lists the user's saved actors with their looks (id, style, status, aspect ratio). | Free | seconds |
| List Voiceslist_voices | Lists the available voices: the platform voice library plus the user's own cloned voices. | Free | seconds |
| Get Brand Memoryget_brand | Reads the user's saved brand memory: business facts, target customer, tone of voice, banned words, preferred actors and voices, platform handles and notes. | Free | seconds |
| Update Brand Memoryupdate_brand | Saves brand facts the user shares (business name, products, target customer, tone of voice, banned words, preferred actors/voices, platform handles, notes) so future runs stay on brand. | Free | seconds |
| List Connected Accountslist_platform_accounts | Lists the social accounts the user has connected for publishing: platform, accountId, username and connection status. | Free | seconds |
Utility
Status polling for asynchronous runs. Free and safe to call any time.
| Skill | What it does | Credits | Typical time |
|---|---|---|---|
| Check a Runcheck_run | Checks the status of a run started by another skill (pass the runId it returned) and returns the finished deliverable (video URL, cost, timing) when it completes. | Free | seconds |
More
Recently added skills. Costs and durations are listed per skill.
| Skill | What it does | Credits | Typical time |
|---|---|---|---|
| List Generation Modelslist_models | Lists every generation model the platform can run: id, kind (video or image), display name, supported resolutions with the honest cost basis (per-second credits for video, per-image credits for image, 1 credit = 1 cent), clip length windows, and capability flags (start-frame animation, text-to-video, baked-in narration, end-frame interpolation). | Free | seconds |
| Analyze Websiteanalyze_website | Reads the user's website and drafts their brand memory (business name, products, target customer, tone of voice, languages) plus three starter video pitches. | Free | under 2 minutes |
| Make a Video From an Imagemake_image_to_video | Makes a video the image-first way: great videos start from a great first frame, so generate the image cheap, get the user's approval on it, then animate. | 8 to 1440 credits | 5 to 12 minutes |
| Make a Voice-Overmake_voiceover | Turns text into a spoken audio track with one of the user's voices, and returns the audio URL. | Free | under 2 minutes |
| Merge Videosmerge_videos | Stitches 2 to 10 finished videos into one file, in the exact order given. | Free | 2 to 5 minutes |
| Approve a Storyboardapprove_storyboard | Approves the storyboard frames of a paused maker run (make_ugc_ad, make_product_ad, make_explainer) and starts the paid clip phase, exactly like approving in the app. | Free | under 2 minutes |
| List Connected Ad Accountslist_ad_accounts | Lists the ad accounts the user has connected for paid campaigns: each connected account (accountId, platform, name) plus the platform ad accounts under it (adAccountId, name, currency). | Free | seconds |
| Launch an Ad Campaignlaunch_ad | Turns a finished video into a paid ad campaign on one of the user's connected ad accounts. | Free | 1 to 4 minutes |
| Pause an Ad Campaignpause_ad | Pauses an entire ad campaign so it stops spending the user's own ad budget; the paused status cascades through the campaign's ad sets and ads. | Free | under 2 minutes |
| Get Ad Performanceget_ad_performance | Reads performance for one of the user's ad campaigns: spend, impressions, clicks and the daily timeline over an optional date range. | Free | seconds |
| Create a Flowcreate_flow | Saves a reusable flow: a named pipeline of up to 10 skill steps that runs as one unit. | Free | seconds |
| Update a Flowupdate_flow | Replaces a saved flow's name, description and steps with a new definition (same shape as create_flow), re-validated against the skill registry. | Free | seconds |
| List Flowslist_flows | Lists the user's saved flows: id, name, description, step count and credit estimate. | Free | seconds |
| Get a Flowget_flow | Reads one saved flow in full: its complete step definition plus the credit estimate. | Free | seconds |
| Run a Flowrun_flow | Starts a saved flow. | Free | seconds |
| Run a Flow Batchrun_flow_batch | Runs a saved flow as a batch of 2 to 20 variants: turn one proven flow into a testing batch by swapping hooks, actors, products, or languages systematically. | Free | under 2 minutes |
| Check a Flow Runget_flow_run | Checks a flow run started with run_flow: overall status, each step's state (keyed by step id, including awaiting_approval pauses), currentSteps, and the deliverables of completed steps keyed by step id. | Free | seconds |
| Save an Assetsave_asset | Saves a reusable asset (image, video, webpage, audio) to the user's asset library. | Free | seconds |
| List Assetslist_assets | Lists the user's saved assets (newest first, up to 50), optionally filtered by kind, tag, or a title text match, including any stored analysis. | Free | seconds |
| Analyze an Assetanalyze_asset | Analyzes an asset so it can be reused in production: images get a vision analysis (subject, style, colors, visible text, suggested uses), videos get a transcription PLUS a visual description (what is on screen: subject, setting, framing, style), audio gets a transcription, and webpages get the site scrape plus brand draft. | 0 to 3 credits | under 2 minutes |
| Create a Projectcreate_project | Creates a project: a reusable multi-clip video that clips are added to and then assembled into one final video. | Free | seconds |
| Get a Projectget_project | Returns a project with its clips in order, each resolved to a playable video URL, plus the final video once assembled. | Free | seconds |
| List Projectslist_projects | Lists the user's projects (multi-clip video artifacts), newest first, with a clip count and status each. | Free | seconds |
| Add a Clipadd_clip | Adds one clip to a project. | Free | seconds |
| Reorder Clipsreorder_clips | Sets the order of a project's clips. | Free | seconds |
| Trim a Cliptrim_clip | Records trim points (start and/or end seconds) on a project clip. | Free | seconds |
| Remove a Clipremove_clip | Removes a clip from its project and renumbers the rest. | Free | seconds |
| Finalize a Projectfinalize_project | Assembles a project into one final video by merging its clips in order. | Free | 2 to 5 minutes |
How does access work?
Access is by API key, created in the dashboard at /developers by a logged-in user with an active Pro ($99/month) or Premium ($199/month) subscription. The full key is shown exactly once at creation; only its prefix appears in the key list afterwards, and any key can be revoked instantly.
Costs are quoted in credits, where 1 credit = 1 cent of your plan's monthly allowance. Maker skills always return their estimated cost first and wait for an explicit confirmation before spending; free skills never charge. Each key can also carry its own budget cap in dollars, a hard ceiling that stops maker runs on that key once reached.
The REST API is described by the OpenAPI spec at https://videoai.me/api/v1/openapi.json: list the skills, POST a run, poll the run until the deliverable is ready. The MCP server exposes the same skills as tools for MCP clients over streamable HTTP with Bearer auth.
How do I connect an agent?
Step-by-step setup with the exact config format for each host:
API and MCP server questions
Direct answers about keys, costs, and what agents can do.
How do I get a VIDEO AI ME API key?
Log in and open videoai.me/developers. Creating a key requires an active Pro or Premium subscription; the full va_live_... value is shown exactly once at creation, so store it immediately. Afterwards only the key prefix is visible, and each key can carry an optional budget cap in dollars.
How much do the maker skills cost to run?
Each maker skill lists its honest credit range in the tables above, computed from the real model pricing (1 credit = 1 cent). Credits come from your plan's monthly allowance, and every maker run quotes its exact estimate for your input and waits for confirmation before anything is charged. Discovery, publishing, and status skills are free.
What is the difference between the REST API and the MCP server?
They expose the same skill registry, so nothing drifts between them. The REST API (spec at https://videoai.me/api/v1/openapi.json) suits scripts and backends: POST a skill run, poll the run endpoint. The MCP server at https://videoai.me/api/v1/mcp suits AI agents such as Claude Code, Cursor, Claude Desktop, and Codex, which discover the skills as tools automatically.
Can an AI agent publish a video without my approval?
No. Two confirmations are designed in: maker skills quote their credit cost and require an explicit confirmation before spending, and publishing skills require the agent to confirm the exact platform list with you (confirmPlatforms) before posting to real accounts. Budget caps on keys add a hard spending ceiling on top.
Is there a VIDEO AI ME CLI or SDK?
No CLI and no SDKs yet, and this page will say so until that changes. The two supported surfaces are the REST API, described by the OpenAPI spec, and the hosted MCP server. Both are thin enough that a plain HTTP client or any MCP-capable agent is all an integration needs.
Where do videos generated through the API live?
In the same account as videos made in the app. Runs return a deliverable with the video URL, cost, and timing, and remain in your run history. You can publish them through the publishing skills, schedule them onto your posting queue, or download the files; every video carries a full commercial license.