Skip to main content
POST
/
v1
/
jobs
{
  "input": "https://example.com/photo.jpg",
  "operations": [
    { "type": "image_watermark_text", "params": { "text": "© 2026", "position": "bottom-right", "opacity": 0.5 } }
  ]
}

{
  "id": "<string>",
  "status": "pending"
}
{
  "input": "https://example.com/photo.jpg",
  "operations": [
    { "type": "image_watermark_text", "params": { "text": "© 2026", "position": "bottom-right", "opacity": 0.5 } }
  ]
}
ParamTypeDescription
textstringWatermark text content
positionstringPlacement position (e.g., bottom-right, center, top-left)
opacitynumberWatermark opacity (0.0-1.0)

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
input
required

Single input URL

Example:

"https://example.com/video.mp4"

​
operations
object[]
required
Example:
[
  {
    "type": "transcode",
    "params": { "format": "mp4", "codec": "h264" }
  }
]
​
webhook_url
string

URL to receive job completion notification

​
file_size
integer

File size hint in bytes (for plan limit validation)

Response

Job accepted

​
id
string
​
status
string
Example:

"pending"