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

Files

T

SnapOtter 8532f3227b docs: audit all 157 tool pages against live schemas

Reconcile every tool page's parameters, defaults, and response shape against the tool's Zod settings schema and executionHint in code. Notable fixes: color-palette (add count + format params, hex output, median-cut algorithm), favicon (add 5 params, was documented as having none), qr-generate (add logoDataUri), convert (add ppm/eps/tga formats), video-loudnorm (-16 LUFS not -14), smart-crop (async 202 not sync 200), images-to-video (1080x1080 square), and several output-filename and behavior-note corrections.

Also normalize API endpoint paths to /api/v1/tools/<id> (no modality segment) and standardize curl examples on the Docker API port 1349. Verified with a clean docs build.

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/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/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