API Documentation

Programmatic watermark removal for images, videos, and PDFs.

Quick Start

Generate one team API key in your dashboard, use it for both API and MCP access, submit a media URL, then poll the job status until the result is ready.

Authentication

Send your team API key in the Authorization header. The same key works for direct API requests and MCP tools.

Authorization: Key YOUR_API_KEY

Ready-to-Run Snippets

Use these copyable snippets to make the first request fast.

curl image submit

curl -X POST https://www.namaste.tools/api/models/ai-image-watermark-remover \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com/image.jpg"}'

Node image submit

const response = await fetch('https://www.namaste.tools/api/models/ai-image-watermark-remover', {
  method: 'POST',
  headers: {
    Authorization: 'Key YOUR_API_KEY',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    image_url: 'https://example.com/image.jpg',
  }),
});

const job = await response.json();
console.log(job);

MCP / API Quick Start

Use the same team key for direct API requests and the Remove Watermark MCP tools.

MCP environment

NAMASTE_KEY=ntk_your_team_key
NAMASTE_TOOLS_API_URL=https://www.namaste.tools/api

Available MCP tools

remove_watermark_image, remove_watermark_video, remove_watermark_pdf, remove_watermark_job_status, remove_watermark_job_result

MCP Setup

Point your MCP client at the shared team key and the Namaste Tools API URL.

Install the MCP server

Use the latest Remove Watermark MCP server package in your client runtime.

Set the team key

Add the team API key and the Namaste Tools API URL to the MCP environment.

Call the tools

Use the same workspace key for image, video, PDF, status, and result tools.

Example MCP config

{
  "env": {
    "NAMASTE_KEY": "ntk_your_team_key",
    "NAMASTE_TOOLS_API_URL": "https://www.namaste.tools/api"
  }
}

Workflow

Submit a job

Send a public file URL to the matching image, video, or PDF processing endpoint.

Poll status

Use the request status endpoint until the job moves from queued or processing to completed.

Fetch result

Read the request result endpoint to get the processed output payload when the job completes.

Endpoints

Base URL: https://api.removewatermark.now

Method	Path	Description
POST	`/models/ai-image-watermark-remover`	Submit an image watermark-removal job
POST	`/models/ai-video-watermark-remover`	Submit a video watermark-removal job
POST	`/models/ai-pdf-watermark-remover`	Submit a PDF watermark-removal job
GET	`/models/{toolName}/requests/{requestId}/status`	Check the current queue status for a request
GET	`/models/{toolName}/requests/{requestId}`	Fetch the current or completed result payload

Code Examples

Start with one submit call per media type, then poll status and fetch the result payload.

Image submit

curl -X POST https://www.namaste.tools/api/models/ai-image-watermark-remover \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"image_url":"https://example.com/image.jpg"}'

Video submit

curl -X POST https://www.namaste.tools/api/models/ai-video-watermark-remover \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"video_url":"https://example.com/video.mp4"}'

PDF submit

curl -X POST https://www.namaste.tools/api/models/ai-pdf-watermark-remover \
  -H "Authorization: Key YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"pdf_url":"https://example.com/document.pdf"}'

Job status

curl -X GET https://www.namaste.tools/api/models/ai-image-watermark-remover/requests/REQUEST_ID/status \
  -H "Authorization: Key YOUR_API_KEY"

Job result

curl -X GET https://www.namaste.tools/api/models/ai-image-watermark-remover/requests/REQUEST_ID \
  -H "Authorization: Key YOUR_API_KEY"

Temporary Files

Uploaded and processed files are temporary and auto-deleted. Download results promptly and do not treat result URLs as permanent storage.

Get Your Key

Generate or rotate the single team API key from your dashboard before making requests.

Open Dashboard