Watermark API Docs

Overview

This page documents the public watermark-removal API used by the published OpenClaw skill and other direct API clients.

Use it when you need to:

• understand the current endpoint contract
• connect OpenClaw to the public API
• verify the request and polling flow behind the published skill

Recommended Flow

For OpenClaw, the recommended path is:

1. Install the skill from ClawHub
2. Create an API key in /settings/apikeys
3. Use the published skill, which calls the endpoints below

If you are integrating directly without the skill, the shortest path is:

1. GET /api/v1/credits
2. POST /api/v1/watermark/remove
3. GET /api/v1/watermark/tasks/:id

Open API

These endpoints support API-key-based access for watermark workflows.

• GET /api/v1/credits: get remaining credits for the current API key or session user.
• POST /api/v1/uploads/images: upload one or more images. Use scope=watermark for watermark inputs.
• POST /api/v1/watermark/tasks: create a watermark task from an already uploaded input asset.
• GET /api/v1/watermark/tasks/:id: query task status.
• POST /api/v1/watermark/tasks/:id/retry: retry a failed task.
• POST /api/v1/watermark/remove: single-entry endpoint for agent clients. Accepts either a multipart file upload or a JSON imageUrl, and optionally wait=true for short polling.

Authentication:

• Authorization: Bearer <api_key>
• or x-api-key: <api_key>

OpenClaw Setup

Use this path if you want the quickest route from the website to a working OpenClaw integration:

1. Install the skill from ClawHub:
   • https://clawhub.ai/isees/airemove-watermark
2. Create an API key in /settings/apikeys
3. Set API_KEY in OpenClaw
4. Run the published skill against the endpoints documented below

If you need a direct local install instead of ClawHub, use the packaged zip:

• https://assets.airemovewatermark.net/skills/remove-watermark-skill-0.1.7.zip
• install it into either ./skills or ~/.openclaw/skills

Notes:

• The published skill uses API_KEY as the only required environment variable.
• API_BASE_URL is optional and only needed if you are not using https://airemovewatermark.net.
• remove --wait true does short polling only. If the task is still running after the first wait window, keep polling with GET /api/v1/watermark/tasks/:id.
• POST /api/v1/watermark/remove accepts either a multipart file upload or a JSON imageUrl. This matches the published OpenClaw skill commands: remove --file ... and remove --image-url ....
• The website /skill page now recommends ClawHub first and keeps direct zip installation as a fallback.

Published skill package:

• https://assets.airemovewatermark.net/skills/remove-watermark-skill-0.1.7.zip