mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00

Files

T

SnapOtter d24e244af4 docs: organize tool pages by modality under /tools/<modality>/

Move all 157 tool pages into image/video/audio/pdf/data subfolders so URLs read /tools/<modality>/<id> (e.g. /tools/image/crop). Nest the image sub-categories under an Image group in the sidebar so the nav reads by modality. Add public/_redirects (301, clean + .html forms) mapping every old flat /tools/<id> URL to its new path so inbound links keep working. Rewrite all internal /tools links. Verified with a clean docs build (no dead links).

2026-06-18 14:12:28 +08:00

1.1 KiB

Raw Blame History

description

description
Pull the subtitle track out of a video as an SRT file.

Extract Subtitles

Extract the embedded subtitle track from a video container and download it as an SRT file.

API Endpoint

POST /api/v1/tools/video/extract-subtitles

Accepts multipart form data with a video file. This tool has no configurable settings.

Parameters

This tool has no parameters. It extracts the first subtitle track found in the video container.

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video/extract-subtitles \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4"

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.srt",
  "originalSize": 12500000,
  "processedSize": 4500
}

Notes

The video must contain an embedded subtitle track. If no subtitle track is found, the request returns a 400 error.
If the video has multiple subtitle tracks, the first one is extracted.
The output format is SRT regardless of the original subtitle format in the container.

1.1 KiB Raw Blame History