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
Normalize video audio volume to broadcast standard.

Normalize Audio

Normalize video audio volume to the EBU R128 broadcast loudness standard.

API Endpoint

POST /api/v1/tools/video-loudnorm

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

Parameters

This tool has no parameters. It applies EBU R128 loudness normalization to the audio track.

Example Request

curl -X POST http://localhost:1349/api/v1/tools/video-loudnorm \
  -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.mp4",
  "originalSize": 12500000,
  "processedSize": 12500000
}

Notes

Uses FFmpeg's loudnorm filter targeting -16 LUFS integrated loudness with -1.5 dBTP true peak and 11 LU loudness range (EBU R128 broadcast standard).
The source audio sample rate is preserved in the output.
If the video has no audio track, the request returns a 400 error.

1.1 KiB Raw Blame History