Developer Documentation

REST API &
MCP Integration

Integrate reverse-alpha watermark removal into your apps, scripts, or AI agents using our REST API or Model Context Protocol (MCP).

Interactive API Explorer OpenAPI Spec (JSON)

API Key Auth

Pass your key in the X-API-Key header.

Fast Processing

Instant image processing & async frame-by-frame video queue.

MCP Server Native

Connect Claude, Cursor or Kilo directly to VeoTools.

REST API Reference

Base URL: https://viotools.my.id/api/v1

POST/remove/video

Async processing (MP4, MOV, MKV, AVI)

Upload a Gemini Veo video to start watermark removal. Returns a jobId immediately to poll for progress.

Request Headers

X-API-Key: user-your-api-key

Form Data

video: File (max 500MB)

Response (200 OK)

{
  "success": true,
  "jobId": "9b1deb4d-3b7d-4b6d-9b3e-123456789abc",
  "statusUrl": "/api/v1/status/9b1deb4d-...",
  "estimatedTime": "2-5 minutes"
}

curl -X POST https://viotools.my.id/api/v1/remove/video \
  -H "X-API-Key: user-your-api-key" \
  -F "video=@my-veo-video.mp4"

POST/remove/image

Synchronous instant removal (PNG, JPG, WEBP)

Upload a Gemini AI generated image. The watermark is removed instantly and the download URL is returned in the response.

Response (200 OK)

{
  "success": true,
  "message": "Image watermark removed",
  "downloadUrl": "/api/v1/download/user-key-1785148-sample_processed.png",
  "filename": "user-key-1785148-sample_processed.png"
}

curl -X POST https://viotools.my.id/api/v1/remove/image \
  -H "X-API-Key: user-your-api-key" \
  -F "image=@gemini-picture.png"

GET/status/:jobId

Poll job completion & progress percentage

Check status of a video job. Once "completed", the downloadUrl is provided.

{
  "jobId": "9b1deb4d-3b7d-4b6d-9b3e-123456789abc",
  "status": "completed",
  "progress": 100,
  "downloadUrl": "/api/v1/download/output_processed.mp4"
}

curl -X GET https://viotools.my.id/api/v1/status/job-id-here \
  -H "X-API-Key: user-your-api-key"

POST/remove/video-url

Queue watermark removal from a public video URL

Submit a publicly reachable video URL instead of uploading a file. Returns a jobId immediately.

{
  "jobId": "9b1deb4d-3b7d-4b6d-9b3e-123456789abc",
  "status": "queued"
}

curl -X POST https://viotools.my.id/api/v1/remove/video-url   -H "X-API-Key: user-your-api-key"   -H "Content-Type: application/json"   -d '{"url":"https://example.com/video.mp4"}'

POST/upscale/video · /upscale/video-url

Increase video resolution with AI super-resolution

Upload a file (video field) or submit a public URL via /upscale/video-url. Optional scale = 2 | 4 (default 2). Returns a jobId — poll /status for the result.

{
  "jobId": "9b1deb4d-3b7d-4b6d-9b3e-123456789abc",
  "status": "queued"
}

curl -X POST https://viotools.my.id/api/v1/upscale/video \
  -H "X-API-Key: user-your-api-key" \
  -F "video=@my-veo-video.mp4" \
  -F "scale=2"

GET/jobs

List your recent jobs

Returns your recent watermark-removal jobs with their current status.

{
  "jobs": [
    { "jobId": "9b1deb4d...", "status": "completed", "createdAt": "2026-08-15T10:00:00Z" }
  ]
}

curl -X GET https://viotools.my.id/api/v1/jobs   -H "X-API-Key: user-your-api-key"

GET/usage

Check remaining daily quota

Returns your API key tier, requests used today, and remaining quota.

{
  "tier": "pro",
  "used": 12,
  "remaining": 488
}

curl -X GET https://viotools.my.id/api/v1/usage   -H "X-API-Key: user-your-api-key"

POST/webhooks

{
  "id": "wh_123",
  "url": "https://yourapp.com/hook",
  "events": ["job.completed"]
}

curl -X POST https://viotools.my.id/api/v1/webhooks   -H "X-API-Key: user-your-api-key"   -H "Content-Type: application/json"   -d '{"url":"https://yourapp.com/hook","events":["job.completed"]}'

Official MCP Server

Model Context Protocol (MCP) Integration

Give Claude Desktop, Cursor, or Kilo AI agents direct ability to clean your videos & images.

1. Get your API Key

2. Add to your AI Agent Config

Paste the JSON snippet into your agent's configuration file (e.g. claude_desktop_config.json or Kilo MCP settings).

3. Available MCP Tools

remove_video_watermark
Queue watermark removal for a local MP4/MOV video upload.
remove_video_watermark_url
Queue watermark removal for a video hosted at a public URL.
remove_image_watermark
Remove watermark from a local PNG/JPG image (synchronous).
check_job_status
Check the progress/result of a queued job by ID.
list_jobs
List your recent watermark-removal jobs.
get_usage
Check your remaining daily API quota.

MCP Configuration JSON

{
  "mcpServers": {
    "veo-watermark": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": {
        "VEO_API_KEY": "user-your-api-key"
      }
    }
  }
}

REST API & MCP Integration