DEVELOPERS

Your images. Your pipeline. Our API.

Two image endpoints to embed and detect. Use standard HTTP, keep control of your records, and integrate in the language you already use.

EMBED AN IMAGE

One request.
A traceable output.

Send multipart form data containing an image and a non-empty JSON object. Etchv hashes the canonicalized object and embeds that digest.

Save the X-Watermark-ID response header alongside your delivery record. The response body is the watermarked PNG.

Full API reference
curl "$ETCHV_API_URL/watermarks/images" \
  -H "X-API-Key: $ETCHV_API_KEY" \
  -F 'file=@campaign.jpg' \
  -F 'data={"asset":"campaign_01","recipient":"partner_42"}' \
  -D response-headers.txt \
  --output protected.png
POST /watermarks/imagesimage/png

Set up your integration

  1. Arrange access

    Contact the team for your deployment base URL. Set ETCHV_API_URL in your server environment.

  2. Create a scoped key

    An authorized organization member creates a key with watermarks:embed and/or watermarks:detect permissions. Store it securely as ETCHV_API_KEY.

  3. Embed and keep the ID

    Send your image and reference data. Store the returned ID in your own records before delivering the protected output.

  4. Inspect a recovered image

    POST the recovered image to /watermarks/images/detect. Match a returned watermark_id against your records, and handle missing or inconclusive results explicitly.

API keys belong on your server. The examples use your configured base URL and do not assume that a public production endpoint is available.

MAKE EVERY COPY ACCOUNTABLE

Your content has a story.
Keep it connected.

Let’s find the right watermarking workflow for your platform.

Talk to the team