API Examples You Can Run in 5 Minutes

Real, runnable demos for the Meicut developer platform — upload a video, cut it, and download the result with a few lines of Python or Node.js, or let your AI assistant call 25 media tools over MCP.

Get an API Key Read the Docs

Simple REST API

Eight endpoints cover upload, every processing tool, and job polling. Authenticate with one header; results come back as presigned download URLs.

Hosted MCP Server

Point Claude Desktop or Cursor at our MCP endpoint and ask for edits in plain language — no code required.

25 Tools, One Key

Cut, merge, resize, convert, compress, subtitles, filters and more — every tool in the web app is callable from your code.

Quickstart

Pick your stack — every example below runs out of the box against the live API.

Python — rest_quickstart.py

# Zero dependencies. Set MEICUT_API_KEY first, then:
#   python rest_quickstart.py path/to/video.mp4

# 1. Upload            POST /api/v1/upload      -> stored_name
# 2. Submit a cut job  POST /api/v1/video-tool  -> job_id
# 3. Poll the job      GET  /api/v1/job/{job_id}/status
# 4. Download          presigned download_url in the job status

stored_name = upload_file("sample.mp4")
job_id = submit_job("cut-video", stored_name,
                    params={"start_time": 0, "duration": 2})
result = wait_for_job(job_id)     # polls every 3s
download(result["download_url"], "result.mp4")

Node.js 18+ — rest_quickstart.mjs

// Zero dependencies (built-in fetch + FormData). Same flow:
const storedName = await uploadFile('sample.mp4')   // POST /api/v1/upload
const jobId = await submitCut(storedName)           // POST /api/v1/video-tool
const result = await waitForJob(jobId)              // GET  /api/v1/job/{id}/status
await download(result.download_url, 'result.mp4')   // presigned URL

Claude Desktop / Cursor — mcp.json

{
  "mcpServers": {
    "meicut": {
      "url": "https://meicut.com/mcp",
      "headers": {
        "Authorization": "Bearer mv_your_api_key"
      }
    }
  }
}

Using an older MCP client that only supports SSE? Use https://meicut.com/mcp/sse?api_key=YOUR_KEY as the URL instead.

Full Examples on GitHub

The complete, open-source example pack — clone it, set your API key, and run:

rest_quickstart.py / .mjs — the minimal upload → process → download flow
rest_full_suite.py — validates all 8 endpoints with a pass/fail report
mcp_client.py — raw MCP JSON-RPC over Streamable HTTP

View on GitHub

Ready to build?

Get an API Key