FFmpeg Media · FFmpeg Media

WatermarkComing Soon

🚧 Coming soon — docs preview only, online run not yet available.

📌 What is this：Overlay an image watermark on the video.

💡 When to use：Use to add a logo or copyright mark.

Endpoints

Usage	Method	Path
Submit task	POST	/v1/ffmpeg/watermark
Query Result	GET	/v1/ffmpeg/info?id={taskId}

⏱ Recommended polling interval：Poll every 3-5s (response includes progress 0-100) until status = succeeded / failed. Single-task timeout is 300s with auto-refund.

Request Parameters

Param	Type	Required	Description
inputUrl	string	Required	Input media URL, must be on the platform CDN allowlist (upload first to obtain it)
imageUrl	string	Required	Watermark image URL (allowlist domain)
position	string	—	Position: tl / tr / bl / br / center, default br
opacity	number	—	Opacity [0,1], default 1.0
margin	integer	—	Margin px [0,200], default 10
webhookUrl	string	—	Completion webhook URL (optional)

Request Example

curl -X POST https://api.cqtai.com/v1/ffmpeg/watermark \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{ "inputUrl": "https://cdn.novapi.ai/tmp/video.mp4", "imageUrl": "https://cdn.novapi.ai/tmp/logo.png", "position": "br", "opacity": 0.8, "margin": 20 }'
# -> { "code":200, "data":"<taskId>" }

Response Example

{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "<taskId>",
    "operation": "transcode",
    "status": "succeeded",
    "progress": 100,
    "resultUrl": "https://cdn.novapi.ai/ffmpeg/xxx.mp4",
    "costPoints": 3,
    "errorMsg": null
  }
}

Billing & Credits

Factor 1.3; 1 min 720P ~ 4 credits (x your user rate). Auto-refunded on failure.