External/SnapOtter
1
0
Fork 0
mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00
Code Issues Packages Projects Releases Wiki Activity

feat(docs-i18n): translate all documentation into 20 languages

Browse Source 
All 181 docs markdown files translated into 20 languages (apps/docs/<locale>/**). Companion to the i18n code PR; admin-merged because the file count exceeds GitHub's per-PR CI trigger limit. Validated by pnpm i18n:check (all surfaces, 0 stale/missing) and a clean all-locale docs build.
This commit is contained in:
SnapOtter
2026-07-11 13:52:47 +08:00
committed by GitHub
parent 00b651c9f8
commit 4963ab3bbd
3620 changed files with 306134 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/docs/uk/tools/audio/audio-channels.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Конвертуйте між моно та стерео або міняйте місцями лівий і правий канали."
i18n_source_hash: 4f5cd6b38c83
i18n_provenance: human
i18n_output_hash: db162f4d4dec
---
# Аудіоканали {#audio-channels}
Конвертуйте аудіо між моно- та стереорозкладками або міняйте місцями лівий і правий канали стереофайлу.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/audio-channels`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| mode | string | Так | - | Операція з каналами: `stereo-to-mono`, `mono-to-stereo`, `swap` |
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-channels \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"mode": "stereo-to-mono"}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 2300000
}
```
## Примітки {#notes}
- `stereo-to-mono` змішує обидва канали в одну моно-доріжку.
- `mono-to-stereo` дублює моно-канал на лівий і правий.
- `swap` міняє місцями лівий і правий канали стереофайлу.
- Вихід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи лише для декодування переходять на MP3.
apps/docs/uk/tools/audio/audio-metadata.md
+73
View File
@@ -0,0 +1,73 @@
---
description: "Переглядайте, редагуйте або видаляйте метадані аудіотегів (ID3)."
i18n_source_hash: 0717018e11cb
i18n_provenance: human
i18n_output_hash: 8fa2bee6c948
---
# Метадані аудіо {#audio-metadata}
Переглядайте, редагуйте або видаляйте метадані аудіотегів, як-от назва, виконавець та альбом (ID3 та подібні формати тегів).
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/audio-metadata`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| strip | boolean | Ні | `false` | Видалити всі наявні метадані тегів |
| title | string | Ні | - | Задати тег назви (макс. 500 символів) |
| artist | string | Ні | - | Задати тег виконавця (макс. 500 символів) |
| album | string | Ні | - | Задати тег альбому (макс. 500 символів) |
## Приклад запиту {#example-request}
Редагування метаданих тегів:
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-metadata \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"title": "My Song", "artist": "Artist Name", "album": "Album Name"}'
```
Видалення всіх метаданих:
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-metadata \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"strip": true}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4480000,
"metadata": {
"container": "mp3",
"durationS": 245.3,
"bitrateKbps": 192,
"tags": {
"title": "My Song",
"artist": "Artist Name",
"album": "Album Name"
}
}
}
```
## Примітки {#notes}
- Відповідь містить об'єкт `metadata` із форматом контейнера, тривалістю, бітрейтом та поточними тегами.
- Коли `strip` має значення `true`, усі поля тегів ігноруються, і кожен наявний тег видаляється.
- Оновлюються лише ті теги, які ви надаєте; незадані теги залишаються незмінними.
- Формат виходу відповідає формату входу.
apps/docs/uk/tools/audio/audio-speed.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Прискорюйте або сповільнюйте відтворення аудіо за допомогою множника."
i18n_source_hash: e39ba662e594
i18n_provenance: human
i18n_output_hash: 17bd6e5b7766
---
# Швидкість аудіо {#audio-speed}
Прискорюйте або сповільнюйте відтворення аудіо, застосовуючи множник швидкості.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/audio-speed`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| factor | number | Ні | `1.5` | Множник швидкості (0.25 до 4). Значення нижче 1 сповільнюють; вище 1 прискорюють. |
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/audio-speed \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"factor": 2}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 2250000
}
```
## Примітки {#notes}
- Множник `0.25` відтворює на чверть швидкості (у 4 рази довше). Множник `4` відтворює на почетверенній швидкості (у 4 рази коротше).
- Висота тону зберігається під час зміни швидкості (розтягнення в часі). Використовуйте зсув висоти тону, щоб коригувати висоту незалежно.
- Вихід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи лише для декодування переходять на MP3.
apps/docs/uk/tools/audio/convert-audio.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Конвертуйте аудіо між форматами MP3, WAV, OGG, FLAC та M4A."
i18n_source_hash: fd02c059e6a9
i18n_provenance: human
i18n_output_hash: 396aa87e0396
---
# Конвертувати аудіо {#convert-audio}
Конвертуйте аудіофайли між поширеними форматами, зокрема MP3, WAV, OGG, FLAC та M4A, з налаштовуваним вихідним бітрейтом.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/convert-audio`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| format | string | Ні | `"mp3"` | Вихідний формат: `mp3`, `wav`, `ogg`, `flac`, `m4a` |
| bitrateKbps | integer | Ні | `192` | Вихідний бітрейт у kbps (32 до 320) |
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/convert-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"format": "flac", "bitrateKbps": 256}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.flac",
"originalSize": 4500000,
"processedSize": 8200000
}
```
## Примітки {#notes}
- Підтримувані вхідні формати включають MP3, WAV, OGG, FLAC, AAC, M4A, WMA, AIFF та OPUS.
- Бітрейт застосовується лише до форматів зі втратами (MP3, OGG, M4A). Формати без втрат, як-от WAV та FLAC, ігнорують це налаштування.
- Ім'я вихідного файлу зберігає оригінальну назву з новим розширенням.
apps/docs/uk/tools/audio/fade-audio.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Додавайте ефекти наростання та згасання до аудіо."
i18n_source_hash: 86856451ecb8
i18n_provenance: human
i18n_output_hash: e2bdb9adda1a
---
# Наростання та згасання аудіо {#fade-audio}
Додавайте ефекти наростання та згасання до початку й кінця аудіофайлу.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/fade-audio`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| fadeInS | number | Ні | `1` | Тривалість наростання в секундах (0 до 30) |
| fadeOutS | number | Ні | `1` | Тривалість згасання в секундах (0 до 30) |
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/fade-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"fadeInS": 2, "fadeOutS": 3}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Примітки {#notes}
- Задайте будь-яке значення `0`, щоб пропустити цей напрямок згасання. Принаймні одне має бути більшим за 0.
- Тривалість згасання обмежується довжиною аудіо, якщо перевищує її.
- Вихід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи лише для декодування переходять на MP3.
apps/docs/uk/tools/audio/merge-audio.md
+51
View File
@@ -0,0 +1,51 @@
---
description: "Об'єднуйте кілька аудіофайлів в одну послідовну доріжку."
i18n_source_hash: defa993d3f87
i18n_provenance: human
i18n_output_hash: 377258430e0c
---
# Об'єднати аудіо {#merge-audio}
Об'єднуйте два чи більше аудіофайлів в одну послідовну доріжку, зчеплену в порядку їх завантаження.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/merge-audio`
Приймає багаточастинні дані форми з кількома аудіофайлами та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| format | string | Ні | `"mp3"` | Вихідний формат: `mp3`, `wav`, `flac`, `m4a` |
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/merge-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@intro.mp3" \
-F "file=@main.mp3" \
-F "file=@outro.mp3" \
-F 'settings={"format": "mp3"}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.mp3",
"originalSize": 9500000,
"processedSize": 9200000
}
```
## Примітки {#notes}
- Приймає від 2 до 10 аудіофайлів на запит.
- Файли зчеплюються в порядку завантаження.
- Усі вхідні файли перекодовуються у вибраний вихідний формат та частоту дискретизації для безшовного з'єднання.
- Мішані вхідні формати підтримуються (наприклад, один WAV та один MP3).
apps/docs/uk/tools/audio/noise-reduction.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Зменшуйте фоновий шум в аудіо за допомогою шумозаглушення на основі FFT."
i18n_source_hash: 57cbdbd449aa
i18n_provenance: human
i18n_output_hash: 66e0acd979f3
---
# Зменшення шуму {#noise-reduction}
Зменшуйте фоновий шум в аудіофайлі за допомогою шумозаглушення на основі FFT із вибираною силою.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/noise-reduction`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| strength | string | Ні | `"medium"` | Сила шумозаглушення: `light`, `medium`, `strong` |
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/noise-reduction \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"strength": "strong"}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Примітки {#notes}
- `light` зберігає більше деталей, але видаляє менше шуму. `strong` видаляє більше шуму, але може вносити ледь помітні артефакти.
- Найкращі результати на записах зі сталим фоновим шумом (гул вентилятора, кондиціонер, статика).
- Вихід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи лише для декодування переходять на MP3.
apps/docs/uk/tools/audio/normalize-audio.md
+46
View File
@@ -0,0 +1,46 @@
---
description: "Вирівнюйте гучність до стандартних рівнів мовлення (EBU R128)."
i18n_source_hash: 794d8cfa5ad8
i18n_provenance: human
i18n_output_hash: e6b316a59fe1
---
# Нормалізувати аудіо {#normalize-audio}
Вирівнюйте гучність аудіо до стандартних рівнів мовлення за допомогою нормалізації EBU R128 (-16 LUFS).
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/normalize-audio`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
Цей інструмент не має налаштовуваних параметрів. Він застосовує нормалізацію гучності EBU R128 автоматично.
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/normalize-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3"
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Примітки {#notes}
- Використовує стандарт гучності EBU R128 із ціллю -16 LUFS.
- Ідеально для подкастів, аудіокниг та мовленнєвого контенту, де важлива стала гучність.
- Вихідна частота дискретизації зберігається у виході.
- Вихід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи лише для декодування переходять на MP3.
apps/docs/uk/tools/audio/pitch-shift.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Підвищуйте або знижуйте висоту тону аудіо на півтони без зміни швидкості."
i18n_source_hash: 2804d0eeecc8
i18n_provenance: human
i18n_output_hash: 05f3e28b08f1
---
# Зсув висоти тону {#pitch-shift}
Підвищуйте або знижуйте висоту тону аудіофайлу на кілька півтонів без зміни його швидкості відтворення.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/pitch-shift`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| semitones | integer | Ні | `3` | Півтони для зсуву (-12 до 12). Має бути ненульовим. |
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/pitch-shift \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"semitones": -5}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Примітки {#notes}
- Додатні значення підвищують висоту тону; від'ємні знижують її.
- Зсув на 12 півтонів дорівнює одній октаві вгору; -12 дорівнює одній октаві вниз.
- Тривалість відтворення залишається незмінною незалежно від величини зсуву.
- Вихід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи лише для декодування переходять на MP3.
apps/docs/uk/tools/audio/reverse-audio.md
+44
View File
@@ -0,0 +1,44 @@
---
description: "Перевертайте аудіофайл, щоб він відтворювався у зворотному напрямку."
i18n_source_hash: 5c2017661803
i18n_provenance: human
i18n_output_hash: 39259b1bbdda
---
# Перевернути аудіо {#reverse-audio}
Перевертайте аудіофайл, щоб він відтворювався у зворотному напрямку.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/reverse-audio`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
Цей інструмент не має налаштовуваних параметрів. Перевертається весь аудіофайл.
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/reverse-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3"
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Примітки {#notes}
- Уся аудіодоріжка перевертається з кінця на початок.
- Вихід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи лише для декодування переходять на MP3.
apps/docs/uk/tools/audio/ringtone-maker.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Створюйте кліп рингтону з будь-якого аудіофайлу."
i18n_source_hash: 8fcdcc545fbc
i18n_provenance: human
i18n_output_hash: 5a5d2ab8e8e8
---
# Створювач рингтонів {#ringtone-maker}
Створюйте кліп рингтону (.m4r) з будь-якого аудіофайлу, вибираючи час початку та тривалість.
## Кінцева точка API {#api-endpoint}
`POST /api/v1/tools/audio/ringtone-maker`
Приймає багаточастинні дані форми з аудіофайлом та JSON-полем `settings`.
## Параметри {#parameters}
| Параметр | Тип | Обов'язковий | Типове значення | Опис |
|-----------|------|----------|---------|-------------|
| startS | number | Ні | `0` | Час початку в секундах (мінімум 0) |
| durationS | number | Ні | `30` | Тривалість кліпу в секундах (1 до 30) |
## Приклад запиту {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/ringtone-maker \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"startS": 15, "durationS": 20}'
```
## Приклад відповіді {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.m4r",
"originalSize": 4500000,
"processedSize": 620000
}
```
## Примітки {#notes}
- Вихід завжди у форматі M4R, сумісному з рингтонами iPhone.
- Максимальна тривалість рингтону становить 30 секунд (обмеження Apple).
- Будь-який аудіоформат можна використовувати як вхід.
apps/docs/uk/tools/audio/silence-removal.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Видалення тихих ділянок з аудіофайлу."
i18n_source_hash: a7624fc99b50
i18n_provenance: human
i18n_output_hash: 87b958871feb
---
# Silence Removal {#silence-removal}
Виявлення та видалення тихих ділянок з аудіофайлу на основі налаштовуваного порогу та мінімальної тривалості.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/silence-removal`
Приймає дані форми multipart з аудіофайлом та JSON-полем `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| thresholdDb | number | No | `-50` | Поріг тиші в дБ (від -80 до -20). Звук нижче цього рівня вважається тишею. |
| minSilenceS | number | No | `0.5` | Мінімальна тривалість тиші в секундах для видалення (від 0.1 до 5) |
## Example Request {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/silence-removal \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"thresholdDb": -45, "minSilenceS": 1}'
```
## Example Response {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 3200000
}
```
## Notes {#notes}
- Вищий (менш від'ємний) поріг є агресивнішим і видаляє тихіші фрагменти разом зі справжньою тишею.
- Збільште `minSilenceS`, щоб видаляти лише довші паузи, зберігаючи короткі природні проміжки.
- Корисно для очищення записів подкастів, лекцій та голосових нотаток.
- Вивід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи, доступні лише для декодування, повертаються до MP3.
apps/docs/uk/tools/audio/split-audio.md
+64
View File
@@ -0,0 +1,64 @@
---
description: "Розділення аудіо за часовими інтервалами, рівними частинами або виявленням тиші."
i18n_source_hash: c062a395dbac
i18n_provenance: human
i18n_output_hash: 0e49077dadd5
---
# Split Audio {#split-audio}
Розділення аудіофайлу на сегменти за фіксованими часовими інтервалами, рівними частинами або автоматичним виявленням тиші. Повертає архів ZIP із сегментами.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/split-audio`
Приймає дані форми multipart з аудіофайлом та JSON-полем `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| mode | string | No | `"time"` | Стратегія розділення: `time`, `parts`, `silence` |
| segmentS | number | No | `60` | Довжина сегмента в секундах, від 1 до 3600 (використовується, коли mode дорівнює `time`) |
| parts | integer | No | `2` | Кількість рівних частин, від 2 до 20 (використовується, коли mode дорівнює `parts`) |
| thresholdDb | number | No | `-40` | Поріг тиші в дБ, від -80 до -20 (використовується, коли mode дорівнює `silence`) |
| minSilenceS | number | No | `0.3` | Мінімальний проміжок тиші в секундах, від 0.1 до 10 (використовується, коли mode дорівнює `silence`) |
## Example Request {#example-request}
Розділити на 30-секундні сегменти:
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/split-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"mode": "time", "segmentS": 30}'
```
Розділити за виявленням тиші:
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/split-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"mode": "silence", "thresholdDb": -35, "minSilenceS": 0.5}'
```
## Example Response {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio_parts.zip",
"originalSize": 4500000,
"processedSize": 4600000
}
```
## Notes {#notes}
- `downloadUrl` вказує на архів ZIP, що містить усі сегменти.
- Використовуються лише параметри, релевантні для обраного `mode`; інші ігноруються.
- Імена файлів сегментів нумеруються послідовно (наприклад, `part-000.mp3`, `part-001.mp3`).
- Формат виводу відповідає вхідному формату.
apps/docs/uk/tools/audio/transcribe-audio.md
+53
View File
@@ -0,0 +1,53 @@
---
description: "Перетворення мовлення на текст за допомогою транскрипції на основі ШІ."
i18n_source_hash: ae98c4c0aed2
i18n_provenance: human
i18n_output_hash: 6a7a86bae8da
---
# Transcribe Audio {#transcribe-audio}
Перетворення мовлення на текст за допомогою транскрипції на основі ШІ (faster-whisper). Підтримує формати виводу у вигляді простого тексту, SRT та VTT з автоматичним або ручним вибором мови.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/transcribe-audio`
Приймає дані форми multipart з аудіофайлом та JSON-полем `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| language | string | No | `"auto"` | Мова: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko`, `id`, `th`, `vi` |
| outputFormat | string | No | `"txt"` | Формат виводу: `txt`, `srt`, `vtt` |
## Example Request {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/transcribe-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"language": "en", "outputFormat": "srt"}'
```
## Example Response {#example-response}
Це асинхронний інструмент. API повертає `202 Accepted` негайно:
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"async": true
}
```
Відстежуйте прогрес через SSE за адресою `GET /api/v1/jobs/{jobId}/progress`. Коли завдання завершується, потік SSE доставляє кінцевий результат із `downloadUrl`.
## Notes {#notes}
- Потребує встановлення набору функцій **transcription**. Повертає `501` із кодом `FEATURE_NOT_INSTALLED`, відсутнім `feature`, `featureName` та `estimatedSize`, якщо набір недоступний.
- Використовує faster-whisper для транскрипції. Мова `auto` визначає мову мовлення автоматично.
- Формати `srt` та `vtt` включають часові позначки для кожного сегмента, придатні для субтитрів.
- Формат `txt` повертає простий текст без часових позначок.
- Це тривалий інструмент ШІ; час обробки залежить від довжини аудіо та апаратного забезпечення сервера.
apps/docs/uk/tools/audio/trim-audio.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Вирізання ділянки з аудіофайлу шляхом зазначення часу початку та кінця."
i18n_source_hash: 8b80c5c8a711
i18n_provenance: human
i18n_output_hash: 27cbf23da1a2
---
# Trim Audio {#trim-audio}
Вирізання ділянки з аудіофайлу шляхом зазначення часу початку та кінця в секундах.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/trim-audio`
Приймає дані форми multipart з аудіофайлом та JSON-полем `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| startS | number | No | `0` | Час початку в секундах (мінімум 0) |
| endS | number | Yes | - | Час кінця в секундах (має бути після початку) |
## Example Request {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/trim-audio \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"startS": 10, "endS": 45}'
```
## Example Response {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 1575000
}
```
## Notes {#notes}
- Час зазначається в секундах і може містити десяткові дроби (наприклад, `10.5`).
- Значення `endS` має бути більшим за `startS`.
- Якщо `endS` перевищує тривалість аудіо, файл обрізається до кінця.
- Вивід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи, доступні лише для декодування, повертаються до MP3.
apps/docs/uk/tools/audio/volume-adjust.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Збільшення або зменшення гучності аудіо на фіксоване підсилення в децибелах."
i18n_source_hash: b9bc1de2c9ef
i18n_provenance: human
i18n_output_hash: 049567a2ea1e
---
# Volume Adjust {#volume-adjust}
Збільшення або зменшення гучності аудіофайлу шляхом застосування фіксованого підсилення в децибелах.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/volume-adjust`
Приймає дані форми multipart з аудіофайлом та JSON-полем `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| gainDb | number | No | `3` | Регулювання гучності в децибелах (від -30 до 30) |
## Example Request {#example-request}
```bash
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 {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Notes {#notes}
- Додатні значення збільшують гучність; від'ємні значення зменшують її.
- Великі додатні підсилення можуть спричинити кліпінг. Використовуйте normalize-audio для безпечного за гучністю вирівнювання.
- Вивід зазвичай зберігає вхідний контейнер. Вхід AAC записується як M4A, а непідтримувані входи, доступні лише для декодування, повертаються до MP3.
apps/docs/uk/tools/audio/waveform-image.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Генерація візуалізації хвильової форми у вигляді зображення PNG з аудіофайлу."
i18n_source_hash: 5480106dfe48
i18n_provenance: human
i18n_output_hash: 7d6388035506
---
# Waveform Image {#waveform-image}
Генерація візуалізації хвильової форми у вигляді зображення PNG з аудіофайлу з налаштовуваними розмірами та кольором.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/waveform-image`
Приймає дані форми multipart з аудіофайлом та JSON-полем `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| width | integer | No | `1024` | Ширина зображення в пікселях (від 256 до 3840) |
| height | integer | No | `256` | Висота зображення в пікселях (від 64 до 1080) |
| color | string | No | `"#4f46e5"` | Шістнадцятковий колір хвильової форми (наприклад, `"#4f46e5"`) |
## Example Request {#example-request}
```bash
curl -X POST http://localhost:1349/api/v1/tools/audio/waveform-image \
-H "Authorization: Bearer si_your-api-key" \
-F "file=@audio.mp3" \
-F 'settings={"width": 1920, "height": 400, "color": "#e07832"}'
```
## Example Response {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.png",
"originalSize": 4500000,
"processedSize": 45000
}
```
## Notes {#notes}
- Вивід завжди є зображенням PNG, незалежно від вхідного аудіоформату.
- Хвильова форма рендериться на прозорому фоні.
- Корисно для мініатюр, попередніх переглядів у соціальних мережах або вбудовування у вебсторінки.