createOverlay - VidJutsu

Usage

const { data, error } = await vj.createOverlay({
  videoUrl: "https://cdn.example.com/video.mp4",
  text: "Follow for more tips",
  position: "bottom",
  fontSize: 48,
  strokeThickness: 2,
});

Parameters

Field	Type	Required	Default	Description
`videoUrl`	`string`	Yes	—	URL of the source video
`text`	`string`	Yes	—	Overlay text. Lines auto-balance to even widths; spaces and single newlines flow together. Use a blank line (`\n\n`) for a hard break, e.g. bullet lists
`position`	`"top"` \| `"center"` \| `"bottom"`	No	`"bottom"`	Vertical text placement
`fontSize`	`number`	No	4% of video height	Font size in pixels
`strokeThickness`	`number`	No	`2`	Text outline thickness (0–10)

Response

{
  "id": "ovl_...",
  "resultUrl": "https://cdn.vidjutsu.ai/overlays/ovl_.../output.mp4"
}

TikTok-safe zone margins are calculated automatically based on video dimensions.

Rate limit

Counts toward the daily overlay limit (50/day). Resets at 00:00 UTC; exceeding it returns HTTP 429.