Skip to main content
POST
/
v1
/
overlay
Burn text overlay onto video
curl --request POST \
  --url https://api.vidjutsu.ai/v1/overlay \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "videoUrl": "<string>",
  "text": "<string>",
  "position": "top",
  "fontSize": 123,
  "strokeThickness": 123
}
'
{
  "id": "<string>",
  "resultUrl": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
videoUrl
string
required

URL of the source video

​
text
string
required

Overlay text. Use \n for line breaks.

​
position
enum<string>

Vertical text placement

Available options:
top,
center,
bottom
​
fontSize
integer<int32>

Font size in pixels. Defaults to 4% of video height.

​
strokeThickness
integer<int32>

Text outline thickness (0-10). Defaults to 2.

Response

200 - application/json

The request has succeeded.

​
id
string
required

Overlay asset ID

​
resultUrl
string
required

CDN URL of the overlaid video