Video Watermark Remover API
Integrate AI-powered watermark removal and video upscaling directly into your product. Simple REST endpoints, Bearer token auth, async job processing.
Authentication
Generate an API key from your account settings. Include it as a Bearer token in every request:
Authorization: Bearer swm_sk_your_key_hereBase URL
https://pro.sorrywatermark.comEndpoints
/api/v1/remove-watermarkSubmit a video URL for watermark removal. Credits are deducted based on video duration (0.1 credit per second).
Request body
{
"fileUrl": "https://example.com/video.mp4"
}Response
{
"jobId": "clxxxxxxxxxxxx",
"status": "PROCESSING"
}/api/v1/upscaleSubmit a video URL for AI enhancement and upscaling. Maximum video length: 60 seconds.
Request body
{
"fileUrl": "https://example.com/video.mp4"
}Response
{
"jobId": "clxxxxxxxxxxxx",
"status": "PROCESSING"
}/api/v1/jobs/:idPoll the status of a submitted job. Repeat until status is COMPLETED or FAILED.
Response
{
"jobId": "clxxxxxxxxxxxx",
"status": "COMPLETED",
"outputUrl": "https://cdn.sorrywatermark.com/processed/output.mp4",
"progress": 100,
"error": null,
"createdAt": "2024-01-01T00:00:00.000Z",
"updatedAt": "2024-01-01T00:01:30.000Z",
"completedAt": "2024-01-01T00:01:30.000Z"
}UPLOADINGPENDINGPROCESSINGCOMPLETED|FAILEDError Codes
| Code | Meaning |
|---|---|
401 | Invalid or missing API key |
402 | Insufficient credits |
400 | Invalid request (bad URL, video too long, resolution out of range) |
403 | Access denied — job belongs to another user |
404 | Job not found |
500 | Internal server error |
Full Example
Submit a job and poll until it completes:
# 1. Submit a watermark removal job
curl -X POST https://pro.sorrywatermark.com/api/v1/remove-watermark \
-H "Authorization: Bearer swm_sk_..." \
-H "Content-Type: application/json" \
-d '{"fileUrl":"https://example.com/video.mp4"}'
# → {"jobId":"clxxx","status":"PROCESSING"}
# 2. Poll status (repeat until COMPLETED or FAILED)
curl https://pro.sorrywatermark.com/api/v1/jobs/clxxx \
-H "Authorization: Bearer swm_sk_..."
# → {
# "jobId": "clxxx",
# "status": "COMPLETED",
# "outputUrl": "https://cdn.sorrywatermark.com/processed/output.mp4",
# "progress": 100,
# ...
# }Same flow for upscaling — just change the endpoint:
curl -X POST https://pro.sorrywatermark.com/api/v1/upscale \
-H "Authorization: Bearer swm_sk_..." \
-H "Content-Type: application/json" \
-d '{"fileUrl":"https://example.com/video.mp4"}'Quick Start
Create an account
Sign up at sorrywatermark.com and choose a plan that fits your usage.
Generate an API key
Go to Settings → API Keys and click "Generate Key". Save it — it's shown only once.
Submit a job
POST your video URL to /api/v1/remove-watermark or /api/v1/upscale.
Poll for completion
GET /api/v1/jobs/:id every few seconds until status is COMPLETED, then download outputUrl.
API FAQ
Common questions about integrating the SorryWatermark API
How do I get an API key?
Sign in to your SorryWatermark account, go to Settings → API Keys, and generate a new key. Keys are prefixed with swm_sk_ and are shown only once — store them securely.
How are credits consumed?
Credits are deducted based on video duration. Watermark removal charges 0.1 credit per second of video. Upscaling is charged similarly. Check your account dashboard for current balance and usage history.
What video formats are supported?
We accept any publicly accessible video URL (MP4, MOV, WebM, and other common formats). The video must be accessible without authentication — use a direct CDN or signed URL.
How long does processing take?
Most videos complete within a few minutes. Processing time scales with video duration and resolution. Poll the /api/v1/jobs/:id endpoint every 5–10 seconds until the status is COMPLETED or FAILED.
What is the maximum video length for upscaling?
The upscale endpoint accepts videos up to 60 seconds. Watermark removal has no hard cap on video length beyond your available credits.
How long are output files available for download?
Processed output files are available via the outputUrl for a limited time. Download and store them on your own infrastructure after the job completes.
Start Building with the API
Get your API key and integrate watermark removal into your product in minutes.
Get API Key