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

Files

T

SnapOtterandGitHub f858c4cea0 feat: clearer, disambiguated tool names across all surfaces (#520 )

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.

2026-07-15 21:55:51 +08:00

1.3 KiB

Raw Blame History

description

description
Increase or decrease audio volume by a fixed gain in decibels.

Adjust Volume

Increase or decrease the volume of an audio file by applying a fixed gain in decibels.

API Endpoint

POST /api/v1/tools/audio/volume-adjust

Accepts multipart form data with an audio file and a JSON settings field.

Parameters

Parameter	Type	Required	Default	Description
gainDb	number	No	`3`	Volume adjustment in decibels (-30 to 30)

Example Request

curl -X POST http://localhost:1349/api/v1/tools/audio/volume-adjust \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@audio.mp3" \
  -F 'settings={"gainDb": 6}'

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
  "originalSize": 4500000,
  "processedSize": 4500000
}

Notes

Positive values increase volume; negative values decrease it.
Large positive gains can cause clipping. Use normalize-audio for loudness-safe leveling.
Output usually keeps the input container. AAC input is written as M4A, and unsupported decode-only inputs fall back to MP3.

1.3 KiB Raw Blame History