Swap
Same shot, different star
POST /api/v1/run/swap · MCP run_skill with skill: "swap"
Same shot, different star
What it looks like

Before

After
What it takes and hands back
- Takes: a picture — as a
url, anupload_id, a Vaultasset_id, an earlierjob_id, or a multipartfile. - Prompt: optional, up to 2,000 characters.
- Second picture: required, as
reference_urlorreference_asset_id. - Hands back: a picture.
Price
11 credits per image.Options
Send them inoptions. Anything left out takes its default.
Where it can sit in a recipe
Swap needs a second picture, which the steps can’t carry, so it runs on its own throughPOST /api/v1/run/swap and can’t be one of the steps in a recipe.
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/swap— this skill live, with its request as JSON Schema- 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 Swap
- Run Swap
- Run Swap
- Run Swap
- Run Swap
- Run Swap
- Run Swap
- Run Swap
- Run Swap
- Run Swap
- Run Swap
- Run Swap
Same shot, different star
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.

