Skip to main content
POST
/
v1
/
image
/
watermark-image
{
  "input": "https://example.com/photo.jpg",
  "watermark_url": "https://example.com/logo.png",
  "position": "center",
  "opacity": 0.3
}

curl -X POST https://api.ringbee.dev/v1/image/watermark-image \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "watermark_url=https://example.com/logo.png" \
  -F "position=center" \
  -F "opacity=0.3"

{
  "id": "job_abc123",
  "status": "pending"
}
{
  "error": "<string>"
}
{
  "error": "<string>"
}
{
  "input": "https://example.com/photo.jpg",
  "watermark_url": "https://example.com/logo.png",
  "position": "center",
  "opacity": 0.3
}

curl -X POST https://api.ringbee.dev/v1/image/watermark-image \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@photo.jpg" \
  -F "watermark_url=https://example.com/logo.png" \
  -F "position=center" \
  -F "opacity=0.3"
ParamTypeDescription
watermark_urlstringURL of the watermark image
positionstringPlacement position (e.g., center, bottom-right, top-left)
opacitynumberWatermark opacity (0.0-1.0)

Authorizations

​
X-API-Key
string
header
required

Body

​
input
string
required

Input file URL

​
watermark_url
string

URL of the watermark image

​
position
string

Placement position (e.g., center, bottom-right, top-left)

​
opacity
number

Watermark opacity (0.0-1.0)

​
webhook_url
string

URL to receive job completion notification

Response

Job accepted

​
id
string
Example:

"job_abc123"

​
status
enum<string>
Available options:
pending,
processing,
completed,
failed,
cancelled
Example:

"pending"