mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
SnapOtterandGitHub
f858c4cea0
Renames 18 ambiguous or hard-to-search tool names so image tools self-qualify like the other modalities ("Compress" becomes "Compress Image"), and cleans up a few awkward names. Propagated across search (constants.ts), display (en.ts + 20 locales), the OpenAPI base spec + 20 locale specs, and the docs tool-page headings in 21 languages. Removes the duplicate "Normalize Audio" summary shared by the video and audio endpoints. Tool ids and routes are unchanged, so no API paths or bookmarks break.
43 lines
1.2 KiB
Markdown
43 lines
1.2 KiB
Markdown
---
|
|
description: Normalize video audio volume to broadcast standard.
|
|
---
|
|
|
|
# Normalize Video Audio {#normalize-audio}
|
|
|
|
Normalize video audio volume to the EBU R128 broadcast loudness standard.
|
|
|
|
## API Endpoint {#api-endpoint}
|
|
|
|
`POST /api/v1/tools/video/video-loudnorm`
|
|
|
|
Accepts multipart form data with a video file. This tool has no configurable settings.
|
|
|
|
## Parameters {#parameters}
|
|
|
|
This tool has no parameters. It applies EBU R128 loudness normalization to the audio track.
|
|
|
|
## Example Request {#example-request}
|
|
|
|
```bash
|
|
curl -X POST http://localhost:1349/api/v1/tools/video/video-loudnorm \
|
|
-H "Authorization: Bearer si_your-api-key" \
|
|
-F "file=@clip.mp4"
|
|
```
|
|
|
|
## Example Response {#example-response}
|
|
|
|
```json
|
|
{
|
|
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
|
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
|
|
"originalSize": 12500000,
|
|
"processedSize": 12500000
|
|
}
|
|
```
|
|
|
|
## Notes {#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.
|