Promvie is an AI movie generator: you type one idea and it writes the script, designs a consistent cast, storyboards every scene, renders the video with sound, and cuts the finished film, in your browser.

How do I make a movie with Promvie?

Describe your movie in a sentence. Promvie writes the screenplay, detects the characters and draws their portraits, builds storyboards, renders each scene as video with dialogue and sound, and assembles the movie. You can edit any step or let autopilot run the whole pipeline.

How much does Promvie cost?

Promvie is free to start, no credit card needed. Free accounts can start 2 movies a month; any credit pack or Director's Choice removes the limit. Writing the script, the cast portraits and the storyboards are free, and a free account gets a free video preview of one scene, with sound; more video needs a credit pack or a subscription. Director's Choice is $29 a month for 2,000 credits, unlimited movies, series with one cast across every episode, premium models, exports without watermark and up to 25% off credit packs.

How long can a Promvie movie be?

Scenes render as full takes of up to 30 seconds each, longer scenes render in parts that continue from the previous part, and a movie can have as many scenes as your script needs. Most first movies are one to three minutes.

Do the characters look the same in every scene?

Yes. Promvie generates a portrait for each character and uses it as a visual reference for every scene, so faces, clothes and build stay consistent across the movie.

Can I make a series with Promvie?

Yes, on Director's Choice. A series keeps one cast across every episode, with the same faces and voices, and a showrunner plans and produces whole seasons. Free accounts and credit packs make standalone movies.

Which AI video models does Promvie use?

Promvie orchestrates several models rather than one: MiniMax H3 Max, ByteDance Seedance 2.5 and Wan 3.0 Prime for video, GPT Image and Seedream for portraits and storyboards, and large language models for the script. Presets pick the mix for speed, quality, cost or permissiveness.

Can I download and share the movie?

Yes. Export the finished movie as an MP4, share it with a public watch link, or post it to TikTok from the app. Exports carry a small Promvie watermark unless you are on Director's Choice, which exports clean.

Can I use Promvie movies commercially?

Yes, with Director's Choice. Subscribers can use what they make commercially, for example on monetized channels, in ads or for clients, and keep that right for what they made after the subscription ends. Other accounts, including credit pack buyers, are for personal use.

Can an AI agent use Promvie?

Yes. Promvie exposes an API and an MCP server, so tools like Claude, ChatGPT agents and custom scripts can create a movie, run the pipeline and fetch the result. See promvie.com/developers.

Promvie for Developers

Let your AI agent make the movie

Connect Claude Code, Cowork, OpenClaw, or any MCP-speaking agent to Promvie and drive the entire pipeline — idea, script, cast, storyboards, video, final render — programmatically. Everything your agent generates spends your normal credit balance and lands in your dashboard like any other movie.

Claude.ai and Claude Desktop

No key needed. In Claude, open Settings, then Connectors, choose Add custom connector, name it Promvie and paste https://promvie.com/api/mcp. Claude opens a Promvie sign-in and approval page; after you allow it, the connector is ready. It shows up as a key on your API keys page, and deleting that key disconnects it. Any MCP client that supports OAuth sign-in connects the same way.

Quickstart

1. Create an API key. Go to Dashboard → API Keys and create a key. It looks like promvie_sk_… and is shown exactly once — store it like a password. Requests authenticate with Authorization: Bearer promvie_sk_….

2. Connect your agent. For Claude Code, one command:

shell

claude mcp add promvie --transport http https://promvie.com/api/mcp \
  --header "Authorization: Bearer promvie_sk_YOUR_KEY"

3. Ask for a movie. Try “Create a short noir movie about a lighthouse keeper — take it through storyboards, then stop and show me the cost so far.” The MCP server tells your agent the pipeline order and how to poll progress.

The MCP server

https://promvie.com/api/mcp — Streamable HTTP transport, 40+ tools. Sign in with OAuth (Claude.ai, Claude Desktop and other OAuth-capable MCP clients) or send a bearer API key (Claude Code, Claude Cowork, OpenClaw, custom agents built on the MCP SDKs).

Movies

Create projects and set the concept that unlocks the pipeline.

list_movies · create_movie · update_idea · update_movie_title · update_movie_aspect_ratio

Read & resolve

Observe what exists, resolve "scene 5" or a character name to real ids, and read nextStep.

get_pipeline_state · list_scenes · list_shots · list_characters · list_locations · list_storyboards · find_entity

Generate (async jobs)

Each returns a jobId immediately; identical in-flight jobs are deduped and reused.

enqueue_generate_script · enqueue_detect_characters · enqueue_generate_images · enqueue_generate_storyboards · enqueue_generate_shots · enqueue_generate_scene_video · enqueue_generate_shot_image · enqueue_revise_scene · enqueue_generate_cover · enqueue_generate_poster

Edit

Direct, synchronous edits to the script, shots, and cast.

update_scene · update_shot · update_character · update_location · update_storyboard_prompt · set_audio_preferences · set_render_preferences · delete_scene · delete_shot · delete_character · delete_location

Jobs & render

Track background work and export the final MP4.

list_running_jobs · cancel_job · render_movie · cancel_render · get_render_status

The async model: enqueue_* tools return a jobId immediately and run in the background — generation takes minutes. Agents poll get_pipeline_state, whose nextStep field says what to enqueue next. Re-enqueueing an identical in-flight job is safe: the server dedupes and returns the existing job.

The REST API

Prefer plain HTTP? The same API key works on the REST routes. This is the complete nothing-to-finished-movie sequence:

curl

# 1. Create a movie
curl -s https://promvie.com/api/movies -X POST \
  -H "Authorization: Bearer $PROMVIE_KEY" -H "Content-Type: application/json" \
  -d '{"title": "The Lighthouse Keeper"}'
# → { "movie": { "id": "<movieId>", ... } }

# 2. Seed the idea (logline + outline + style unlock the pipeline)
curl -s https://promvie.com/api/movies -X PATCH \
  -H "Authorization: Bearer $PROMVIE_KEY" -H "Content-Type: application/json" \
  -d '{"id": "<movieId>", "metadata": {"idea": {
        "logline": "A lonely keeper discovers the light summons more than ships.",
        "outline": "Three-act short: routine, discovery, sacrifice.",
        "style": "Moody 1920s noir, heavy fog, desaturated blues."}}}'

# 3. Ask the pipeline what to do next
curl -s "https://promvie.com/api/studio/pipeline-state?movieId=<movieId>" \
  -H "Authorization: Bearer $PROMVIE_KEY"
# → { "state": { "nextStep": "generate_script", ... } }

# 4. Enqueue it (repeat 3 → 4 until nextStep is null)
curl -s https://promvie.com/api/agent/jobs/enqueue -X POST \
  -H "Authorization: Bearer $PROMVIE_KEY" -H "Content-Type: application/json" \
  -d '{"kind": "generate_script", "movieId": "<movieId>", "input": {}}'
# → { "jobId": "...", "reused": false }  (async — poll step 3)

# 5. Render the final movie
curl -s https://promvie.com/api/render-video -X POST \
  -H "Authorization: Bearer $PROMVIE_KEY" -H "Content-Type: application/json" \
  -d '{"movieId": "<movieId>"}'

# 6. Poll for the finished MP4
curl -s "https://promvie.com/api/render-video?movieId=<movieId>" \
  -H "Authorization: Bearer $PROMVIE_KEY"
# → { "status": "completed", "videoUrl": "https://..." }

Producing a series

Series are folders of seasons whose episodes are ordinary movies — with two structural guarantees the pipeline enforces for you: one cast shared by every episode (reference portraits carry across, so faces stay consistent), and a season-level premise + visual style every episode inherits. The script generator automatically composes each episode against the season premise and a “previously on” recap of earlier episodes. Series need the Director's Choice plan: without it, the tools that create or produce a series return series_plan_required.

create_series — title + season-1 premise/style (defaults to 9:16 vertical, the episodic format).
create_episode — returns a movieId; run the normal movie pipeline on it. Episodes skip the cast step for characters the series already has; a new character the script introduces joins the shared cast, with a portrait and a voice, before the storyboards.
upsert_season / get_series — shape the arc; read seasons, shared cast, and episode statuses.

To produce a whole season with one instruction, call plan_season, confirm the episode plan and the credit estimate with your user, then start_season_generation: the showrunner creates and produces the episodes one after another, and get_series shows the progress.

Drop-in agent guide

Paste this into your project's AGENTS.md (or CLAUDE.md) so your agent knows the etiquette without being told each session:

markdown

## Promvie (AI movie generation)

Promvie generates complete AI movies through a staged pipeline. It is connected
via MCP (server name: promvie). Rules:

- Movies are the root object: create_movie / list_movies first; every other tool
takes that movieId.
- Set the idea before anything else: update_idea with logline + outline + style.
- Then follow the pipeline: get_pipeline_state returns "nextStep" — enqueue it,
poll, repeat. Order: script → characters → character images and voices → storyboards →
shots → videos (enqueue_generate_scene_video, one call per scene; every scene
renders as a single continuous video).
- Every enqueue_* tool is ASYNC and returns a jobId immediately. Poll
list_running_jobs or get_pipeline_state every 15–30s. NEVER re-enqueue while
an identical job is pending/running (the server dedupes and reuses anyway).
- render_movie stitches the final MP4; poll get_render_status for the URL.
- Generation SPENDS the account's prepaid credits (images ~1-10, video
~12-30 per second). Ask the user before enqueueing video-generation or render
steps, and tell them roughly what it will cost.
- A free account (never bought credits) renders ONE short scene video as a
preview. After that, video calls fail with "Free preview used": stop and
tell the user to buy a credit pack or subscribe at
https://promvie.com/dashboard/billing. Do not retry.
- On "insufficient credits": stop and tell the user to top up at
https://promvie.com/dashboard/billing. Do not retry.

Good to know

Credits. Agent generations spend your prepaid balance exactly like the app — there are no separate API prices and no surprise charges. When the balance runs out, generation stops with a clear error until you buy more credits. A free account renders one short scene video as a preview; after that, video calls return “Free preview used” until the account buys a credit pack or a plan. Script, cast and storyboard calls stay free.
Key security. Keys are stored hashed and shown once. Revoke any key instantly from the dashboard — agents using it stop working immediately. A key can never create or manage other keys.
Rate limits. Generous per-account limits protect the platform from runaway loops (roughly one call per second, sustained). Well-behaved agents never notice them.
Questions? hello@promvie.com

CLAP!

Preparing your workspace