Skip to main content
Six steps, and nothing is charged until the last one. Every example has a tab for curl, TypeScript, Python and MCP.
1

Mint a test key

Sign in, open mediamonster.app/keys, press New key and pick Test. You get a key that starts mm_test_.A test key goes through every check a live key does — the file is fetched and measured, the options and the plan are checked — then charges nothing and hands back a stand-in file of the right kind at once. Every plan gets test keys, Cyclops included. See Test mode.
2

Make your first call

Remove the background from a photo. Send a public link to the file; the call waits for the result.
The answer is the job: status: "complete", livemode: false, credits_charged: 0, and outputs with a signed url that lasts ten minutes. Swap example.com for your file, or send it as a multipart file, an upload_id from a direct upload, or a Vault asset_id.Every skill has a page with its options and this call already written: see Skill reference.
3

Price a run before you spend

Add dry_run=true. The call makes every check and measures the file, then answers with the price, step by step, and your balance after it — without running. Use it with a live key before anything long.
See Dry runs.
4

Run a recipe by name

A recipe is a named sequence of steps; each step is handed what the step above made. Run a ready-made one by its slug — tiktok-ready reframes a video to 9:16, burns in captions and picks a cover frame.
GET /api/v1/recipes lists every ready-made recipe, and yours with a key. To change a setting, send steps inline instead. See Recipe reference and Run a recipe.
5

Get a webhook when it finishes

Long runs shouldn’t hold a connection open. Send wait: false and a webhook_url, and the call answers 202 at once; the result is POSTed to you when it settles, signed with Mediamonster-Signature.
Test runs are delivered too, marked "livemode": false, so you can build the receiving end for free. For a standing address, add a webhook endpoint instead of passing a URL each time. Or skip webhooks and poll poll_url — mm.runs.wait(id) does it for you.
6

Switch to a live key

Mint a Live key on the same page — mm_live_ — and swap it in. The calls don’t change. Runs now spend credits, call the real models and hand back real files; a failed skill’s credits go back.Before you ship:
  • Give the key only the scopes it needs, and an address allow-list if it runs from fixed servers.
  • Send an Idempotency-Key on every POST, so a retry after a timeout never runs twice. See Idempotency.
  • Watch the X-RateLimit-* headers. See Rate limits.
  • Keep Errors handy: every error carries a code, a request_id and a doc_url to its fix.

Next

SDKs and tools

TypeScript, Python, the mm CLI, and Postman and Bruno collections.

MCP

Hand the whole catalogue to Claude, ChatGPT, Cursor or VS Code.

Skill reference

Every skill: options, price, where it can sit in a recipe, and the call.

Status

Live health of every component, as a page and as JSON.