> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mediamonster.app/llms.txt
> Use this file to discover all available pages before exploring further.

# One skill, with its request schema

> The catalogue entry, plus the JSON Schema of the body POST /api/v1/run/{slug} takes, the schema of its options alone, an example body and the MCP call that does the same. Open — no key needed.



## OpenAPI

````yaml /api/openapi.reference.json get /api/v1/skills/{slug}
openapi: 3.1.0
info:
  title: Mediamonster API
  version: v1
  summary: Run Mediamonster's skills and recipes on your files, from code.
  description: >-
    Every skill on mediamonster.app, over HTTP: the same providers, credit
    prices and plan ceilings as the Workbench.


    Send a file as a public `url`, an earlier `job_id`, a Vault `asset_id`, or a
    multipart `file`. Calls wait up to 150 seconds for the result; `wait: false`
    answers 202 at once with a `poll_url`.


    Each skill has its own operation below, with its options as a JSON Schema
    and its price under `x-mediamonster`. Recipes — a named sequence of steps —
    run through POST /api/v1/runs.


    The same catalogue is served over MCP at /api/mcp.
  contact:
    name: Mediamonster
    url: https://docs.mediamonster.app/api/overview
servers:
  - url: https://mediamonster.app
security:
  - bearer: []
tags:
  - name: Discovery
    description: What's here, open to anyone.
  - name: Account
    description: The account and workspace behind the key.
  - name: Skills
    description: The catalogue, and the generic run.
  - name: Analysis skills
    description: Skills that hand back data about the file — tags, boxes, facts, shots.
  - name: Audio skills
    description: Skills that hand back a recording.
  - name: Document skills
    description: Skills that hand back a document.
  - name: Image skills
    description: Skills that hand back a picture.
  - name: Text skills
    description: >-
      Skills that hand back words — a transcript, subtitles, copy — and leave
      the file as it was.
  - name: Video skills
    description: Skills that hand back a video.
  - name: Recipes
    description: Named sequences of steps, run on one file.
  - name: Batches
    description: >-
      The same steps once per row of a sheet, or every combination of a few
      lists.
  - name: Convert
    description: Change a file's format or size. Free.
  - name: Jobs
    description: Poll a skill run or a conversion.
  - name: Vault
    description: Your stored files.
  - name: Galleries
    description: Client galleries.
  - name: Automations
    description: >-
      Recipes that run on the clock, once or on repeat, with nobody pressing
      Run.
  - name: Uploads
    description: Files of any size your plan takes, sent straight to storage.
  - name: Webhooks
    description: >-
      Endpoints every settled job and run is posted to, and the log of each
      attempt.
externalDocs:
  url: https://docs.mediamonster.app/api/overview
paths:
  /api/v1/skills/{slug}:
    get:
      tags:
        - Skills
      summary: One skill, with its request schema
      description: >-
        The catalogue entry, plus the JSON Schema of the body POST
        /api/v1/run/{slug} takes, the schema of its options alone, an example
        body and the MCP call that does the same. Open — no key needed.
      operationId: getSkill
      parameters:
        - name: slug
          in: path
          required: true
          description: The skill's slug.
          schema:
            type: string
            enum:
              - background-remover
              - face-cutout
              - blur-background
              - smart-expand
              - upscale
              - alt-text
              - restyle
              - generate
              - background-swap
              - new-perspectives
              - object-remove
              - restore
              - colourise
              - headshot
              - virtual-stage
              - sky-replace
              - day-to-dusk
              - try-on
              - virtual-model
              - poster
              - colouring-page
              - meme
              - fill-template
              - mockup
              - swap
              - text-to-video
              - animate
              - text-to-voice
              - music
              - sound-effects
              - reference-to-video
              - finish-draft
              - voice-design
              - image-to-3d
              - captions
              - transcript
              - watermark
              - extract-audio
              - video-to-gif
              - thumbnail
              - clean-audio
              - trim-video
              - split-video
              - upscale-video
              - b-roll
              - dub-video
              - add-soundtrack
              - add-voiceover
              - vocal-remover
              - video-background-remover
              - slow-motion
              - lip-sync
              - remove-silences
              - cut-to-brief
              - animated-text
              - join
              - compress-video
              - deinterlace
              - stabilise-video
              - smart-reframe
              - translate-captions
              - talking-photo
              - image-qa
              - auto-tag
              - classify
              - face-check
              - ai-text-detector
              - ai-image-detector
              - ai-video-detector
              - ai-audio-detector
              - blur-faces
              - video-face-blur
              - image-to-text
              - collage
              - slideshow
              - image-splitter
              - pixelate
              - view-metadata
              - mute-video
              - clips
              - youtube-thumbnail
              - video-multiplier
              - graphic-multiplier
              - avatar-video
              - ugc-ad
              - ad-hooks
              - static-ads
              - ad-scripts
              - write-rows
              - digital-twin
              - podcast-cover
              - explainer
              - brand-film
              - site-promo
              - music-video
              - micro-drama
              - convert-document
              - merge-pdf
              - split-pdf
              - extract-pages
              - compress-pdf
              - pdf-to-pdfa
              - protect-pdf
              - unlock-pdf
              - html-to-pdf
              - pdf-to-images
              - images-to-pdf
              - ocr-pdf
              - repair-pdf
              - rotate-pdf
              - watermark-pdf
              - crop-pdf
              - page-numbers
              - organize-pdf
              - extract-text
              - summarise-document
              - translate-document
              - pdf-to-markdown
              - pdf-to-sheet
              - extract-pdf-images
              - filter-rows
              - remove-duplicate-rows
              - keep-first-rows
              - split-into-rows
              - add-column
              - stack-sheets
              - match-sheets
              - word-count
              - readability
              - paraphrase
              - grammar-check
              - fit-length
              - humanize
              - redact
              - youtube-chapters
              - youtube-description
              - social-post
              - show-notes
              - pull-quotes
              - clean-transcript
              - audiogram
              - visualizer
              - lyric-video
              - normalise-loudness
              - change-speed
              - reverse-video
              - loop-video
              - vectorise
              - colour-palette
              - qr-code
              - screenshot
              - character-sheet
              - casting
              - location-recce
              - props
              - wardrobe
              - hair-makeup
              - storyboard
              - mood-board
              - set-dressing
              - creature-design
              - vehicle-design
              - relight
              - pose-sheet
              - expression-sheet
              - character-scene
              - age-shift
              - packshot
              - lifestyle-scene
              - packaging-design
              - logo-concepts
              - icon-set
              - sticker-sheet
              - sketch-to-render
              - comic-page
              - storybook-page
              - seamless-pattern
              - tattoo-design
              - floor-plan-render
        - $ref: '#/components/parameters/XRequestId'
      responses:
        '200':
          description: The skill.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SkillDetail'
          headers:
            X-Request-Id:
              $ref: '#/components/headers/X-Request-Id'
        '404':
          $ref: '#/components/responses/NotFound'
      security: []
components:
  parameters:
    XRequestId:
      name: X-Request-Id
      in: header
      required: false
      description: >-
        Your own id for this request — 8 to 128 letters, digits, `.`, `_`, `:`
        or `-`. Used in place of one we mint, and echoed back.
      schema:
        type: string
        pattern: ^[A-Za-z0-9][A-Za-z0-9._:-]{7,127}$
  schemas:
    SkillDetail:
      allOf:
        - $ref: '#/components/schemas/Skill'
        - type: object
          properties:
            endpoint:
              type: object
            schema:
              type: object
              description: JSON Schema of the request body.
            options_schema:
              type: object
              description: JSON Schema of `options` alone.
            example:
              type: object
              description: A body that would run it.
            mcp:
              type: object
              description: The same run as an MCP `run_skill` call.
    Skill:
      type: object
      description: >-
        One live skill as GET /api/v1/skills lists it: what it takes, what it
        hands on, what it costs and which options it has.
      properties:
        slug:
          type: string
        name:
          type: string
        description:
          type: string
        input:
          type: string
        accepts:
          type: array
          items:
            type: string
            enum:
              - image
              - video
              - audio
              - document
        input_optional:
          type: boolean
        output:
          type: string
        output_by:
          type:
            - object
            - 'null'
        keeps_medium:
          type: boolean
        keeps_length:
          type: boolean
        credits:
          type: number
        credits_per:
          type: string
        rate:
          type: object
        credits_by:
          type:
            - object
            - 'null'
        paid_only:
          type: boolean
        accepts_prompt:
          type: boolean
        needs_prompt:
          type: boolean
        max_prompt_characters:
          type: integer
        needs_reference:
          type: boolean
        supports_variations:
          type: boolean
        options:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              label:
                type: string
              default:
                type: string
              choices:
                type: array
                items:
                  type: string
              range:
                type: object
                properties:
                  min:
                    type: integer
                  max:
                    type: integer
              multi:
                type: boolean
              text:
                type: boolean
              max_characters:
                type: integer
              pattern:
                type: string
              rule:
                type: string
        extra_options:
          type: array
          items:
            type: object
            properties:
              id:
                type: string
              rule:
                type: string
        caveat:
          type: string
    Error:
      type: object
      description: >-
        Every refusal. `code` is stable and meant for programs; `message` is a
        sentence meant for people, and says what to do.
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              examples:
                - missing_file
                - bad_option
                - rate_limited
            message:
              type: string
            doc_url:
              type: string
              format: uri
              description: >-
                The heading on the errors page that explains this code and its
                fix.
              examples:
                - https://docs.mediamonster.app/api/errors#bad_option
            request_id:
              type: string
              description: The same id as the `X-Request-Id` header. Quote it to support.
              examples:
                - req_8fK2mQ0x7ZtLw3nVb1cR9dYe
            param:
              type: string
              description: The one field at fault, when there is one.
              examples:
                - edges
                - url
          required:
            - code
            - message
            - doc_url
            - request_id
      required:
        - error
  headers:
    X-Request-Id:
      description: >-
        This request's id — yours, if you sent a well-formed `X-Request-Id`. The
        same as `error.request_id`. Quote it to support.
      schema:
        type: string
        examples:
          - req_8fK2mQ0x7ZtLw3nVb1cR9dYe
    X-RateLimit-Limit:
      description: Requests a minute this key may make. Absent on a plan with no limit.
      schema:
        type: integer
    X-RateLimit-Remaining:
      description: How many of them are left this minute.
      schema:
        type: integer
    X-RateLimit-Reset:
      description: When this minute's window ends, in unix seconds.
      schema:
        type: integer
  responses:
    NotFound:
      description: >-
        Nothing with that id or slug that this key can see. Codes:
        unknown_skill, job_not_found, run_not_found, recipe_not_found,
        recipe_version_not_found, file_not_found, rule_not_found.
      headers:
        X-Request-Id:
          $ref: '#/components/headers/X-Request-Id'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
          example:
            error:
              code: unknown_skill
              message: What went wrong, and what to do instead.
              doc_url: https://docs.mediamonster.app/api/errors#unknown_skill
              request_id: req_8fK2mQ0x7ZtLw3nVb1cR9dYe
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: mm_live_… or mm_test_…
      description: >-
        `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.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.