apyhub
Back

Generate Video Subtitle API

What it does

Video Subtitle Burner burns SRT subtitles into a video and returns the processed video as a binary file.

Send a video file and an SRT subtitle track in the request body. The video file can be up to 100 MB. The subtitle text must be provided in SRT format as multi-line text. The endpoint handles the video overlay step and gives you the finished video back as binary output.

Use Video Subtitle Burner when you need hardcoded subtitles for social clips, course videos, product demos, or accessibility-focused exports. It fits workflows where you already have a subtitle file and want the captions permanently embedded into the video rather than delivered as a separate track.

Because the response is binary, you can stream or save the result directly into your storage, media pipeline, or download flow without an extra conversion step.

POST
Burn subtitles into a video
https://api.eu.apyhub.com/freedailypro/generate-video-subtitle-api/video-subtitle

QUICKSTART

GUIDE

Quickstart

Upload a video file and its SRT subtitles to add subtitles to the video.

curl -X POST "https://api.eu.apyhub.com/freedailypro/generate-video-subtitle-api/video-subtitle" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/video.mp4" \
  -F "srt=1
00:00:01,000 --> 00:00:03,000
Hello world!"

What you'll get back

Returns the resulting video as a binary file.

TRY ITLIVE · 10 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.
body*
Subtitles in SRT format (multi-line text).
The video. Up to 100 MB.

About this endpoint

What it does

Add subtitles into an uploaded video and returns the video with the subtitles drawn permanently onto the frames.

Request Body

ParameterTypeMandatoryDescription
fileFileYesThe video file. Up to 100 MB.
srtStringYesSubtitles in SRT format: a number, a time range (00:00:01,000 --> 00:00:03,000) and the text, with a blank line between entries.

Response

Returns the subtitled video as a binary file in the response body.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.