WowReveal

동영상 링크로 내레이션이 포함된 9:16 쇼츠를 만드세요: AI 스토리, 보이스오버, 자막, 클립 및 AI 동영상.

호스팅형 MCP 서버

npx add-mcp 'https://wowreveal.com/mcp'

Claude Code, Codex, Cursor 등에 설치됩니다

문서

API · MCP · Agents

Let your AI agent run your Reels studio

Connect Claude, Cursor or any MCP agent to WowReveal in one line. Ask in plain words — it finds trending videos, makes story shorts in 27 languages, writes post kits and hands you the links.

Get your API keyRead the docs

Included on every paid plan · same credits as the app

WowReveal MCP connector – tool definition quality and endpoint health on Glama

Claude · WowReveal connected MCP

Works with

  • Claude Code
  • Claude Desktop
  • claude.ai
  • Cursor
  • Windsurf
  • Cline
  • VS Code
  • OpenAI Agents SDK

How it works

From zero to an agent that ships reels in under two minutes.

  1. 01

    Create an API key

    In Developers inside the app. Keys are shown once, stored hashed and revocable anytime.
  2. 02

    Connect your agent

    One command for Claude Code, a connector for claude.ai, a JSON block for Cursor and the rest.
  3. 03

    Ask in plain words

    The agent picks the tools, checks the price, starts jobs and polls until your videos are ready.

Connect your agent

One endpoint for every client. Paste your key where it says YOUR_API_KEY.

MCP server URL

Streamable HTTP · stateless · sign-in (OAuth) or API key: Bearer or X-API-Key

Connect by signing in — no key

Add the MCP server URL above as a connector and sign in to WowReveal when asked. A page tells you what the app may do; press Allow. You can disconnect it any time in Settings → Security → Connected apps. Needs a paid plan with API & MCP access.

  • Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, paste the URL, then Connect.
  • Claude Code: run claude mcp add --transport http wowreveal https://wowreveal.com/mcp, then /mcp → Authenticate.
  • ChatGPT: in Settings → Connectors add a custom MCP connector (on some plans it needs Developer mode), paste the URL and choose OAuth.
  • VS Code: run “MCP: Add Server…”, choose HTTP, paste the URL and allow access when the browser opens.
  • Cursor: add the URL as shown in the Cursor tab below (no key), then press Connect next to WowReveal in Settings → MCP and sign in.
  • A client that can only send a key: use the key setup below.

Run this once in your terminal. Then ask Claude anything — try “What's my WowReveal balance?”.

bash

<code>claude mcp add --transport http wowreveal https://wowreveal.com/mcp --header "Authorization: Bearer YOUR_API_KEY"</code>

Check the connection with /mcp inside Claude Code.

Share with your team (.mcp.json)

Commit this file and let each teammate set WOWREVEAL_API_KEY in their environment.

.mcp.json

<code>{
"mcpServers": {
"wowreveal": {
"type": "http",
"url": "https://wowreveal.com/mcp",
"headers": {
"Authorization": "Bearer ${WOWREVEAL_API_KEY}"
}
}
}
}</code>

Every tool your agent needs

Read tools are free. Write tools spend the same credits as the app — and failed jobs are refunded automatically.

35 tools with clear names, descriptions and safety hints. Prices are live.

ToolWhat it doesCost
Account & catalogs
get_accountBalance, plan, plan limits and current prices. Agents call it first.Free
list_templatesNiche templates (talent shows, makeovers, animal rescue…) with their default settings.Free
list_languagesThe 27 languages for scripts, voiceovers, captions and post kits.Free
list_caption_stylesAnimated caption styles you can pick per video.Free
list_voicesAI narrator voices — storytelling voices first.Free
list_brand_assetsYour Brand Kit logos and music plus the free library — ids for the logo and music settings.Free
estimate_creditsPrice any action before running it and check the balance covers it.Free
Shorts & projects
create_shortBackground jobStory, transformation or best-moment short from a link or upload — returns the job id instantly.Story 8 credits · Transformation 14 credits · Clips 3 credits
get_projectStatus, progress, script and the signed video link when it's ready.Free
list_projectsYour projects, newest first, with status filters and pagination.Free
wait_for_projectWaits up to 50 s for a job to finish — no tight polling loops.Free
retry_projectBackground jobRuns a failed project again at the current price — no new upload or link needed.Current price of its tool
delete_projectDeletes a finished or failed project and its files for good.Free
create_compilationBackground jobNumbered “Top 10” long video from your finished shorts.8 credits
AI Clipper
start_clipperBackground jobAnalyses a long video and proposes the best self-contained clips.6 credits / 30 min of source
get_clip_planClip candidates with scores, timecodes and reasons.Free
generate_clipsBackground jobRenders the clips you picked as captioned 9:16 videos.2 credits / clip
Instant tools
write_scriptViral narration script from a video or a text, sized to the length you need.1 credit
create_post_kitTitles, description, hashtags and first comment per platform and language.1 credit
write_hooksTen opening lines for the first 3 seconds, for a topic or a script, in the styles and language you pick.1 credit
rewrite_textA caption, post or script rewritten for Reels, Shorts, TikTok, Threads, X or Telegram.1 credit
translate_textA text translated into any of the 27 languages, keeping links, @mentions, hashtags and emojis.1 credit
video_ideasVideo ideas for a niche, or a 7- or 30-day content plan.2 credits
reply_to_commentThree reply options to a viewer's comment, in your tone.1 credit
repurpose_textA long text or transcript turned into a short script, thread, carousel or newsletter paragraph.2 credits
create_coverCover / thumbnail JPEG from a video frame or an image, with a bold headline.2 credits
generate_voiceoverText → natural MP3 voiceover in any of the 27 languages.1 credit / 100 chars
Planning
search_trendsRecent viral YouTube videos in a niche, ranked by views per day.1 credit · repeats free
earnings_estimateRough payout range for a view count by platform, audience, niche and originality — an estimate, not a promise.Free
AI Studio
import_imageGive it a picture by link or base64 — the start image for image presets and image-to-video.Free
list_studio_modelsImage & video models available to you, with their settings and prices.Free
list_studio_presetsOne-click effects: camera moves, transitions, VFX, product shots.Free
studio_generateBackground jobGenerate AI images or videos — returns generation ids instantly.Per model
get_generationStatus and signed output links of a generation.Free
list_generationsYour AI Studio generations, newest first, with signed output links.Free

Account & catalogs

  • get_accountFree Balance, plan, plan limits and current prices. Agents call it first.
  • list_templatesFree Niche templates (talent shows, makeovers, animal rescue…) with their default settings.
  • list_languagesFree The 27 languages for scripts, voiceovers, captions and post kits.
  • list_caption_stylesFree Animated caption styles you can pick per video.
  • list_voicesFree AI narrator voices — storytelling voices first.
  • list_brand_assetsFree Your Brand Kit logos and music plus the free library — ids for the logo and music settings.
  • estimate_creditsFree Price any action before running it and check the balance covers it.

Shorts & projects

  • create_shortStory 8 credits · Transformation 14 credits · Clips 3 credits Story, transformation or best-moment short from a link or upload — returns the job id instantly. Background job
  • get_projectFree Status, progress, script and the signed video link when it's ready.
  • list_projectsFree Your projects, newest first, with status filters and pagination.
  • wait_for_projectFree Waits up to 50 s for a job to finish — no tight polling loops.
  • retry_projectCurrent price of its tool Runs a failed project again at the current price — no new upload or link needed. Background job
  • delete_projectFree Deletes a finished or failed project and its files for good.
  • create_compilation8 credits Numbered “Top 10” long video from your finished shorts. Background job

AI Clipper

  • start_clipper6 credits / 30 min of source Analyses a long video and proposes the best self-contained clips. Background job
  • get_clip_planFree Clip candidates with scores, timecodes and reasons.
  • generate_clips2 credits / clip Renders the clips you picked as captioned 9:16 videos. Background job

Instant tools

  • write_script1 credit Viral narration script from a video or a text, sized to the length you need.
  • create_post_kit1 credit Titles, description, hashtags and first comment per platform and language.
  • write_hooks1 credit Ten opening lines for the first 3 seconds, for a topic or a script, in the styles and language you pick.
  • rewrite_text1 credit A caption, post or script rewritten for Reels, Shorts, TikTok, Threads, X or Telegram.
  • translate_text1 credit A text translated into any of the 27 languages, keeping links, @mentions, hashtags and emojis.
  • video_ideas2 credits Video ideas for a niche, or a 7- or 30-day content plan.
  • reply_to_comment1 credit Three reply options to a viewer's comment, in your tone.
  • repurpose_text2 credits A long text or transcript turned into a short script, thread, carousel or newsletter paragraph.
  • create_cover2 credits Cover / thumbnail JPEG from a video frame or an image, with a bold headline.
  • generate_voiceover1 credit / 100 chars Text → natural MP3 voiceover in any of the 27 languages.

Planning

  • search_trends1 credit · repeats free Recent viral YouTube videos in a niche, ranked by views per day.
  • earnings_estimateFree Rough payout range for a view count by platform, audience, niche and originality — an estimate, not a promise.

AI Studio

  • import_imageFree Give it a picture by link or base64 — the start image for image presets and image-to-video.
  • list_studio_modelsFree Image & video models available to you, with their settings and prices.
  • list_studio_presetsFree One-click effects: camera moves, transitions, VFX, product shots.
  • studio_generatePer model Generate AI images or videos — returns generation ids instantly. Background job
  • get_generationFree Status and signed output links of a generation.
  • list_generationsFree Your AI Studio generations, newest first, with signed output links.

earnings_estimate gives rough public ranges, not a promise. It follows Meta's March 2026 originality rule: someone else's footage counts as original only when you appear in it and add something new. So unless you say the footage is your own (or you are on screen), it assumes reworked footage, which pays far less. Meta alone decides who is paid.

What you can ask

Paste into Claude once WowReveal is connected. The agent picks the tools, checks your balance and polls the jobs.

“Find 5 trending talent show auditions from this week and make story shorts in Spanish with the talent-show template. Wait until they're done and give me the video links.”

“Analyse this podcast with the AI Clipper and render the 4 highest-scoring clips with captions: https://www.youtube.com/watch?v=…”

“What's my WowReveal balance, and how many story shorts and transformation shorts can I still afford this month?”

“Write a Facebook post kit in Russian for my latest finished short and suggest the best time to post it.”

“Make a countdown compilation “Top 5 golden buzzers” from my five most recent finished shorts.”

“My Facebook Reels page posts footage I film myself and gets 2 million views a month, mostly from the US. Estimate the payout range and tell me what Meta's originality rule changes.”

REST API reference

JSON over HTTPS. Base URL https://wowreveal.com/api/v1. Same validation, limits and credits as the app.

  • GET/api/v1/me Account: balance, plan, limits and current prices. Free
  • GET/api/v1/templates?locale=en Niche templates, localised (locale=en|ru). Free
  • GET/api/v1/languages Content languages. Free
  • GET/api/v1/caption-styles Caption styles. Free
  • GET/api/v1/voices Narrator voices. Free
  • GET/api/v1/assets?kind=logo Brand Kit logos and music (yours + the library) with preview links. Ids for settings.logoAssetId (null = no logo), settings.logoPosition and settings.music. Free
  • POST/api/v1/uploads Upload a video, audio or image (multipart, field “file”) → upload id. Unused uploads are deleted after 48 hours. Free
  • POST/api/v1/uploads/from-url Give an image by an https link ({ url }): downloaded here (public addresses only, 10 MB at most) and stored as an upload. Free
  • GET/api/v1/uploads/:id One upload: kind, size, duration. 404 once it has been cleaned up. Free
  • POST/api/v1/projects Start story / transformation / clips shorts from links or uploads.Idempotency-Key Story 8 credits · Transformation 14 credits · Clips 3 credits
  • GET/api/v1/projects List projects (status, tool, posted, q, cursor, limit). Free
  • GET/api/v1/projects/:id One project with signed video, download and thumbnail links. Free
  • PATCH/api/v1/projects/:id Rename a project ({ name }). Free
  • DELETE/api/v1/projects/:id Delete a project and its files (409 JOB_IN_PROGRESS while it is being made). Free
  • POST/api/v1/projects/:id/retry Run a failed project again (retryable: true) at the current price of its tool.Idempotency-Key Current price of its tool
  • POST/api/v1/compilations Numbered compilation from finished projects.Idempotency-Key 8 credits
  • POST/api/v1/clipper/plans AI Clipper analysis of a long video.Idempotency-Key 6 credits / 30 min of source
  • GET/api/v1/clipper/plans Your 20 latest clip plans, newest first. Free
  • GET/api/v1/clipper/plans/:id Clip plan status, candidates, the style settings new clips get and when the plan expires (7 days after it is ready). Free
  • POST/api/v1/clipper/plans/:id/generate Render chosen candidates. Optional: settings (another caption style, layout, music…) and cuts (a new start / end per candidate, up to 10 s beyond the AI's) — same price per clip.Idempotency-Key 2 credits / clip
  • POST/api/v1/post-kit Titles, description, hashtags, first comment.Idempotency-Key 1 credit
  • POST/api/v1/hooks Ten opening lines for a topic or a script (platform, language, styles).Idempotency-Key 1 credit
  • POST/api/v1/rewrite A text rewritten for one platform (tone, length, emojis, hashtags).Idempotency-Key 1 credit
  • POST/api/v1/translate A text translated into one of the 27 content languages, optionally adapted for a country.Idempotency-Key 1 credit
  • POST/api/v1/ideas Video ideas for a niche, or a 7- or 30-day content plan.Idempotency-Key 2 credits
  • POST/api/v1/comment-replies Three reply options to a viewer's comment.Idempotency-Key 1 credit
  • POST/api/v1/repurpose A long text turned into a short script, thread, carousel or newsletter paragraph.Idempotency-Key 2 credits
  • POST/api/v1/script Narration script from a video or text.Idempotency-Key 1 credit
  • POST/api/v1/tts Text → MP3 voiceover (signed link).Idempotency-Key 1 credit / 100 chars
  • POST/api/v1/cover Cover JPEG from a finished project or an uploaded image / video, with a headline (vertical, horizontal or both).Idempotency-Key 2 credits
  • POST/api/v1/trends/search Trending videos for a niche or query. 1 credit · repeats free
  • GET/api/v1/studio/models AI Studio models and presets. Free
  • POST/api/v1/studio/generations Start AI image / video generations.Idempotency-Key Per model
  • GET/api/v1/studio/generations List generations (kind, status, favorite, cursor, limit). Free
  • GET/api/v1/studio/generations/:id Generation status and signed outputs. Free
  • DELETE/api/v1/studio/generations/:id Delete a generation and its files (409 while it runs). Free
  • POST/api/v1/studio/generations/:id/to-upload Copy a studio output into an upload ({ index }) — a source for a short or a compilation. Free
  • POST/api/v1/estimate Price an action before running it. Free
  • POST/api/v1/earnings/estimate Creator payout estimate (originality as Meta's 2026 rule reads it). Free
  • GET/api/v1/webhooks Your webhooks. Free
  • POST/api/v1/webhooks Add a webhook ({ url, events? }). The signing secret comes back once. Free
  • PATCH/api/v1/webhooks/:id Change a webhook's address or events, or turn it off / on. Free
  • DELETE/api/v1/webhooks/:id Delete a webhook. Free
  • POST/api/v1/webhooks/:id/test Send a test event to the webhook now (one try). Free
  • GET/api/v1/webhooks/:id/deliveries The webhook's delivery log, newest first (30 days). Free
  • GET/api/v1/openapi.json This API as an OpenAPI 3.1 document. Public: no key needed. Free

Request & response

POST /api/v1/projects — request

<code>{
"tool": "story",
"sources": [
{
"url": "https://www.youtube.com/watch?v=VIDEO_ID"
}
],
"settings": {
"templateId": "talent-show",
"language": "es",
"targetSeconds": 35,
"captionStyle": "pop_bounce",
"voiceId": "nPczCjzI2devNBz1zQrb",
"music": "auto",
"headline": true,
"ending": "follow"
}
}</code>

201 Created

<code>{
"projects": [
{
"id": "6f1c2d9e-8a41-4c1b-9f0e-2b7d5a3c9e11",
"name": "Golden buzzer audition",
"tool": "story",
"templateId": "talent-show",
"language": "es",
"status": "queued",
"step": "queued",
"progress": 0,
"videoUrl": null,
"downloadUrl": null,
"thumbnailUrl": null,
"queue": {
"position": 2,
"ahead": 1
},
"creditsCharged": 8,
"createdAt": "2026-10-04T09:30:00.000Z"
}
],
"creditsCharged": 8,
"balance": 442
}</code>

GET /api/v1/projects/:id — when complete

<code>{
"project": {
"id": "6f1c2d9e-8a41-4c1b-9f0e-2b7d5a3c9e11",
"status": "complete",
"step": "complete",
"progress": 100,
"title": "Nadie esperaba esta voz…",
"durationSec": 34.2,
"videoUrl": "https://wowreveal.com/api/media/eyJrIjoicHYi…",
"downloadUrl": "https://wowreveal.com/api/media/eyJrIjoicHYi…d",
"thumbnailUrl": "https://wowreveal.com/api/media/eyJrIjoicHQi…",
"captionsUrl": "https://wowreveal.com/api/media/eyJrIjoicGMi…d",
"errorCode": null,
"completedAt": "2026-10-04T09:36:12.000Z",
"expiresAt": "2026-11-18T09:36:12.000Z"
}
}</code>

402 Payment Required

<code>{
"error": {
"code": "INSUFFICIENT_CREDITS",
"message": "Not enough credits: 8 required, 3 available",
"details": {
"required": 8,
"balance": 3
}
}
}</code>

Authentication

Send your key in the Authorization header on every request: Authorization: Bearer wr_live_…. The MCP endpoint (/mcp) also takes it as X-API-Key: wr_live_…, for catalogs and clients that can only set that header; if both are sent, Bearer is used. Keys belong to your account, are stored as SHA-256 hashes and can be revoked anytime in Developers. Missing or revoked keys get 401 with a WWW-Authenticate header; plans without API access get 403.

http

<code>Authorization: Bearer wr_live_…</code>

MCP (/mcp) also accepts

<code>X-API-Key: wr_live_…</code>

Sign in with OAuth (no key)

MCP clients can connect without a key: the 401 of /mcp points to /.well-known/oauth-protected-resource/mcp (RFC 9728) and from there to the authorization server (/.well-known/oauth-authorization-server, RFC 8414). Apps register themselves (POST /oauth/register, RFC 7591, public clients), send the person to /oauth/authorize with PKCE (S256 is required) and the resource /mcp, and exchange the code at /oauth/token. The person signs in and presses Allow. Access tokens (wro_at_…) last 1 hour and work at /mcp and /api/v1 as Authorization: Bearer; refresh tokens last 60 days and are used once, each refresh returns a new one, and an old one used again closes the connection. Tokens are stored as hashes. Revoke with POST /oauth/revoke (RFC 7009); the person can disconnect any app in Settings → Security → Connected apps. A password change, signing out everywhere or deleting the account disconnects every app. Plan limits, rate limits and the kill switch apply as for keys.

Media links

Video, thumbnail and audio URLs in API and MCP responses are absolute signed links valid for 24 hours — download them or pass them on. Fetch the project again for fresh links.

Safe retries

Add an Idempotency-Key header (REST) or idempotency_key argument (MCP) to create calls. Repeating the same request with the same key within 24 hours returns the first result instead of charging again — also after our server restarts or updates. The same key with a different body returns 409. If the first request was cut off before it answered, the key answers 409 too: check your projects and, if nothing started, use a new key.

OpenAPI 3.1

The whole API as one document, for Postman, SDK generators and ChatGPT Actions. Request bodies are generated from the same schemas the server checks them with, so they cannot drift.

Open openapi.json

Webhooks

Skip the polling: register an https address and WowReveal sends it a signed JSON message the moment a job ends. Add one in Developers in the app (below your keys) or with POST /api/v1/webhooks — up to 5 per account. MCP agents can still use wait_for_project instead.

Events

project.completed

A short, clip or compilation is ready.

project.failed

A project failed — its credits are already refunded.

clipper.analysis_ready

A clip plan is ready: the candidates are in the message.

clipper.analysis_failed

A clip analysis failed — refunded.

studio.completed

An AI Studio generation is done.

studio.failed

An AI Studio generation failed — refunded.

You are told about every job of the account, also the ones started in the app. Leave events out to get them all.

Delivery rules

Answer with any 2xx within 10 seconds. Anything else is tried again after 1 minute, 5 minutes, 30 minutes, 2 hours, 6 hours and 12 hours (seven tries in about 20 hours), then marked failed. The address must be https and public: private networks, redirects and invalid certificates are refused. A webhook that has had no successful delivery for 3 days is switched off. Every delivery is in the log in Developers, and “Send test event” sends a webhook.test message.

bash

<code>curl -s -X POST https://wowreveal.com/api/v1/webhooks \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://example.com/wowreveal-hook","events":["project.completed","project.failed"]}'</code>

What you receive

A POST with a JSON body. data holds the object exactly as the REST API returns it, with signed media links valid for 24 hours. id is the same on every retry — use it to ignore repeats.

POST · WowReveal-Event: project.completed

<code>{
"id": "evt_5f0c1d7a9e2b4c36a81d0f42",
"type": "project.completed",
"createdAt": "2026-10-19T09:36:12.418Z",
"data": {
"project": {
"id": "6f1c2d9e-8a41-4c1b-9f0e-2b7d5a3c9e11",
"status": "complete",
"title": "Nadie esperaba esta voz…",
"durationSec": 34.2,
"videoUrl": "https://wowreveal.com/api/media/eyJrIjoicHYi…",
"downloadUrl": "https://wowreveal.com/api/media/eyJrIjoicHYi…d",
"thumbnailUrl": "https://wowreveal.com/api/media/eyJrIjoicHQi…",
"errorCode": null
}
}
}</code>

Check the signature

Every message carries WowReveal-Signature: t=,v1=. v1 is the HMAC-SHA256 of “.” with your webhook's secret, which is shown once when you add it. Compute it over the raw body, compare in constant time and refuse a t older than five minutes. Also sent: WowReveal-Event, WowReveal-Event-Id and WowReveal-Delivery.

js

<code>import crypto from "node:crypto";

// rawBody: the request body exactly as received (a string or Buffer), not re-serialised JSON
export function isFromWowReveal(secret, rawBody, signatureHeader) {
const parts = Object.fromEntries(signatureHeader.split(",").map((p) => p.trim().split("=")));
if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false; // too old: a replay
const expected = crypto.createHmac("sha256", secret).update(`${parts.t}.${rawBody}`).digest();
const given = Buffer.from(parts.v1 ?? "", "hex");
return given.length === expected.length && crypto.timingSafeEqual(given, expected);
}</code>

MCP and REST names

MCP tools take flat snake_case arguments; the REST API takes the nested camelCase bodies of the OpenAPI document. They do the same thing — this table maps the main ones. The other tools use the body fields of their endpoint in snake_case (voice_id is voiceId). With a preset, MCP fills the preset's prompt template from prompt and preset_values; REST takes the finished prompt.

create_short → POST /api/v1/projects

MCP argumentREST field
tooltool
urlsources[].url
urlssources[].url
upload_idsources[].uploadId
namesources[].name
template_idsettings.templateId
languagesettings.language
target_secondssettings.targetSeconds
genresettings.genre
caption_stylesettings.captionStyle
voice_idsettings.voiceId
musicsettings.music
logo_asset_idsettings.logoAssetId
logo_positionsettings.logoPosition
headlinesettings.headline
headline_textsettings.headlineText
hooksettings.hookEnabled
endingsettings.ending
ending_textsettings.endingText
ending_ctasettings.endingCta
reveal_modesettings.revealMode
edit_modesettings.editMode
idempotency_keyIdempotency-Key header

write_hooks → POST /api/v1/hooks

MCP argumentREST field
topictopic
scriptscript
platformplatform
languagelanguage
stylesstyles

translate_text → POST /api/v1/translate

MCP argumentREST field
texttext
languagelanguage
adapt_for_countryadaptForCountry
countrycountry

reply_to_comment → POST /api/v1/comment-replies

MCP argumentREST field
commentcomment
video_contextvideoContext
tonetone
creator_stylecreatorStyle

start_clipper → POST /api/v1/clipper/plans

MCP argumentREST field
urlsource.url
upload_idsource.uploadId
max_clipsmaxClips
target_secondstargetSeconds
languagelanguage
caption_stylesettings.captionStyle
layoutsettings.layout
headlinesettings.headline
musicsettings.music
logo_asset_idsettings.logoAssetId

generate_clips → POST /api/v1/clipper/plans/:id/generate

MCP argumentREST field
plan_id:id in the path
candidate_idscandidateIds
caption_stylesettings.captionStyle

create_compilation → POST /api/v1/compilations

MCP argumentREST field
project_idsitems[].projectId
titletitle
formatformat
numberingnumbering
intro_cardintroCard
outro_textoutroText
languagelanguage
musicmusic

studio_generate → POST /api/v1/studio/generations

MCP argumentREST field
model_keymodelKey
preset_idpresetId
promptprompt
negative_promptnegativePrompt
paramsparams
start_upload_idinputs[]: { role: "start", uploadId }
start_generation_idinputs[]: { role: "start", generationId }
end_upload_idinputs[]: { role: "end", uploadId }
reference_upload_idsinputs[]: { role: "reference", uploadId }
countcount

Rate limits

Limits are per account and shared with the app. Over the limit you get 429 RATE_LIMITED with a Retry-After header. Plans also cap parallel jobs (ACTIVE_JOBS_LIMIT).

All API & MCP requests

120 / min

Video jobs (shorts, clipper, compilations)

20 / min

Instant tools (script, post kit, voice, trends)

30 / min

AI Studio generations

30 / min

Uploads

60 / hour

Every API and MCP answer reports the tightest limit the request counted against: RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset (seconds until it frees one more call). Slow down before Remaining reaches 0; at 0, wait RateLimit-Reset seconds. A 429 has the same number in Retry-After.

http

<code>RateLimit-Limit: 20
RateLimit-Remaining: 19
RateLimit-Reset: 3</code>

Pricing

API and MCP access is included on every paid plan from Starter. Calls spend the same credits as the app, read-only calls are free and failed jobs are refunded automatically.

See plans

Errors

Failures always look the same — an HTTP status plus a stable machine-readable code. MCP tools return the same information as an actionable isError result.

StatusCodeMeaning
400VALIDATION_ERRORSome fields need attention. Please check the form and try again.
BAD_REQUESTThat request didn't look right. Please check and try again.
INVALID_URLThat doesn't look like a valid video link.
UNSUPPORTED_SITEWe can't import videos from this site yet. Try YouTube, Facebook, TikTok, a direct https link to an MP4, MOV or WebM file, or upload the file.
SOURCE_UNAVAILABLEWe couldn't access this video. It may be private, age-restricted or removed.
SOURCE_LOGIN_REQUIREDThis video is only visible to people signed in to Facebook or Instagram (or it isn't public), so we can't download it. Ask the author to make it public, or download it yourself and upload the file instead.
SOURCE_NOT_A_VIDEOThis link opens a channel, playlist, profile, page or a photo post (a slideshow), not one video. Open the video itself and copy its link (Share, then Copy link), or upload the file instead.
SOURCE_TOO_LONGThis video is longer than your plan allows. Use a shorter one or upgrade.
UPLOAD_INVALIDThis file looks damaged or isn't a real video, audio or image.
401INVALID_API_KEYThis API key is invalid or has been revoked.
402INSUFFICIENT_CREDITSNot enough credits. Top up or upgrade your plan to continue.
403API_ACCESS_REQUIRES_PLANAPI and MCP access is available on every paid plan.
ACCOUNT_BANNEDThis account has been suspended. Contact support if you think this is a mistake.
PLAN_REQUIREDThis feature needs a paid plan.
PLAN_LIMITThis goes beyond your plan's limits. Upgrade to unlock more.
SOURCE_TOO_LONGThis video is longer than your plan allows. Use a shorter one or upgrade.
INVALID_TOKENThis link is invalid. Request a new one.
404NOT_FOUNDWe couldn't find that. It may have been deleted or expired.
UPLOAD_NOT_FOUNDThe uploaded file is no longer available. Please upload it again.
409CONFLICTThis was changed somewhere else. Refresh and try again.
JOB_IN_PROGRESSThis is still processing. Try again when it's done.
JOB_NOT_RETRYABLEThis job can't be retried. Create a new one instead.
PLAN_NOT_READYThe analysis isn't finished yet.
PLAN_EXPIREDThis clip plan has expired. Analyze the video again.
413PAYLOAD_TOO_LARGEThat file is too large for your plan.
PLAN_LIMITThis goes beyond your plan's limits. Upgrade to unlock more.
415UNSUPPORTED_MEDIAThat file type isn't supported.
422CONTENT_BLOCKEDThis content was blocked by the AI safety filter. Try a different prompt or source.
NO_AUDIOThis video has no usable audio track.
429RATE_LIMITEDYou're going a little fast. Wait a moment and try again.
ACTIVE_JOBS_LIMITYou have the maximum number of jobs running. Wait for one to finish or upgrade.
500INTERNAL_ERRORSomething broke on our side. We've been notified — please try again shortly.
RENDER_FAILEDRendering failed. Your credits were refunded — please try again.
502AI_FAILEDThe AI couldn't process this video. Your credits were refunded — try again or use another source.
TTS_FAILEDThe voiceover couldn't be generated. Your credits were refunded.
PROVIDER_ERRORAn AI provider had a hiccup. Your credits were refunded — please try again.
DOWNLOAD_FAILEDWe couldn't download the source video. Check the link or upload the file.
503SERVICE_UNAVAILABLEThis service is temporarily unavailable. Please try again in a few minutes.
FEATURE_DISABLEDThis feature is temporarily turned off.
MAINTENANCEWowReveal is down for a quick upgrade. Please check back in a few minutes.
504TIMEOUTThis took too long and was stopped. Your credits were refunded.

Why a job failed

A failed project, clip plan or generation carries an errorCode (and a short errorMessage); its credits are refunded automatically. When a project says retryable: true, POST /api/v1/projects/:id/retry (MCP: retry_project) runs it again at the current price — the last column says whether that can help.

CodeWhat happenedRetry?
DOWNLOAD_FAILEDWe couldn't download the source video. Check the link or upload the file.Later — the site may have been busy; try again later or upload the file.
SOURCE_UNAVAILABLEWe couldn't access this video. It may be private, age-restricted or removed.No — the video is private, deleted or region-locked — pick another source.
SOURCE_LOGIN_REQUIREDThis video is only visible to people signed in to Facebook or Instagram (or it isn't public), so we can't download it. Ask the author to make it public, or download it yourself and upload the file instead.No — a Facebook or Instagram video only signed-in people can see cannot be downloaded — ask the author to make it public, or upload the file.
SOURCE_NOT_A_VIDEOThis link opens a channel, playlist, profile, page or a photo post (a slideshow), not one video. Open the video itself and copy its link (Share, then Copy link), or upload the file instead.No — the link opens a channel, playlist, profile, page or a photo post, not one video — send the video's own link, or upload the file.
SOURCE_TOO_LONGThis video is longer than your plan allows. Use a shorter one or upgrade.No — use a shorter video or a plan that allows longer sources.
INSUFFICIENT_CREDITSNot enough credits. Top up or upgrade your plan to continue.Later — after topping up.
NO_AUDIOThis video has no usable audio track.No — pick a video with sound, or a tool that does not need it.
CONTENT_BLOCKEDThis content was blocked by the AI safety filter. Try a different prompt or source.No — change the source or the prompt.
AI_FAILEDThe AI couldn't process this video. Your credits were refunded — try again or use another source.Yes — it usually works on the next try.
TTS_FAILEDThe voiceover couldn't be generated. Your credits were refunded.Yes — it usually works on the next try.
RENDER_FAILEDRendering failed. Your credits were refunded — please try again.Yes — it usually works on the next try.
PROVIDER_ERRORAn AI provider had a hiccup. Your credits were refunded — please try again.Later — an AI provider had a hiccup; wait a few minutes.
TIMEOUTThis took too long and was stopped. Your credits were refunded.Later — try again later, or with a shorter source.
INTERRUPTEDProcessing was interrupted. Your credits were refunded — please try again.Yes — the job was cut off on our side (a restart or a stuck step); run it again.
CANCELLEDYou cancelled this video before it started. Your credits were refunded.Yes — it was cancelled in the web app before it started, and its credits came back; run it again when you need it.
INTERNAL_ERRORSomething broke on our side. We've been notified — please try again shortly.Yes — try again; if it repeats, contact support.

Give your agent a studio

Create a key, paste one line, and ask for your first batch of reels.

Get your API keySee pricing