Text to video
A short clip from a sentence
POST /api/v1/run/text-to-video · MCP run_skill with skill: "text-to-video"
A short clip from a sentence
What it looks like

What it takes and hands back
- Takes: a picture (optional) — as a
url, anupload_id, a Vaultasset_id, an earlierjob_id, or a multipartfile. - Prompt: required, up to 2,000 characters.
- Hands back: a video.
Price
5–291 credits per clip, set by themodel option. At its default: 13 credits per clip.
A second option, resolution, moves the price for some choices — GET /api/v1/skills/text-to-video has every figure.
Options
Send them inoptions. Anything left out takes its default.
Effects
Send one as theeffect option with a starting picture. Each clip is the preview its page in the app plays; the full list, with the ones not filmed yet, is in the effect option above.
Crash zoom (crash-zoom): A violent punch-in on the subject.
Dolly zoom (dolly-zoom): The vertigo shot: subject still, world warps.
360 orbit (orbit): The camera circles all the way round.
Bullet time (bullet-time): The moment frozen, the camera sweeping round.
FPV drone dive (fpv-drone): A first-person drone flight through the scene.
Earth zoom out (earth-zoom-out): From the subject out to the whole planet.
Disintegration (disintegrate): The subject crumbles into drifting dust.
Set on fire (on-fire): Flames climb the subject, who stays unhurt.
Turn to chrome (chrome): Skin and clothes turn to liquid metal.
Melting (melt): The subject droops and melts away.
Explosion (explode): A cinematic blast behind the subject.
Freeze over (freeze): Frost spreads until the subject is solid ice.
Levitation (levitate): The subject lifts gently off the ground.
Lightning (lightning): Glowing eyes and crackling lightning.
Where it can sit in a recipe
Every step is handed what the step above it made. These are worked out from the same rule the Workbench, the API and MCP check a recipe with, over every other live skill at its default settings. As the first step: it takes a picture from the call, or starts from the prompt alone. Above it — by what the step above hands on:Price it first
Adddry_run=true and the call makes every check, measures the file and answers with the price — without running or charging. A test key (mm_test_…) is free either way.
200 with credits, a step-by-step breakdown, and your balance after the run. See Dry runs.
Run it
The same code the Copy as code button hands out on the skill’s page in the app. Swap the link for your file, or sendupload_id, asset_id or job_id instead.
See also
GET /api/v1/skills/text-to-video— this skill live, with its request as JSON Schema- Text to video in the app
- Run a skill — sources, waiting, webhooks and dry runs
- Recipes — run this with other steps in one call
Authorizations
Authorization: Bearer mm_live_…. Mint a key at mediamonster.app/keys; every plan includes the API. A test key, mm_test_…, runs every check a live key does and spends nothing: each run finishes at once with a stand-in file, and says livemode: false. A key does only what its scopes allow.
Headers
Retry this POST safely: the first request with a key runs and its answer is kept for a day; a retry with the same key and the same request gets that answer again, marked Idempotent-Replayed: true, instead of running twice. 1–255 printable characters — a UUID is a good one.
1 - 255Query Parameters
Body
- Run Text to video
- Run Text to video
A short clip from a sentence
Response
The job finished while the call waited — or, with dry_run, what it would cost.
- Option 1
- Option 2
One run of one skill, or one conversion. While status is queued or processing, poll poll_url.

