Files
SnapOtter/apps/docs/th/tools/audio/volume-adjust.md
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

2.2 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
เพิ่มหรือลดระดับเสียงด้วยเกนคงที่เป็นเดซิเบล 4bc993fd4e08 human 17ef005cb8a2

ปรับระดับเสียง

เพิ่มหรือลดระดับเสียงของไฟล์เสียงโดยใช้เกนคงที่เป็นเดซิเบล

API Endpoint

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

รับข้อมูล multipart form ที่มีไฟล์เสียงและฟิลด์ JSON settings

Parameters

Parameter Type Required Default Description
gainDb number No 3 การปรับระดับเสียงเป็นเดซิเบล (-30 ถึง 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

  • ค่าบวกจะเพิ่มระดับเสียง ค่าลบจะลดระดับเสียง
  • เกนบวกที่สูงอาจทำให้เกิดการตัดยอด (clipping) ใช้ normalize-audio สำหรับการปรับระดับความดังอย่างปลอดภัย
  • โดยปกติผลลัพธ์จะคงคอนเทนเนอร์ของอินพุตไว้ อินพุต AAC จะถูกเขียนเป็น M4A และอินพุตที่ถอดรหัสได้เท่านั้นซึ่งไม่รองรับจะย้อนกลับไปเป็น MP3