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/nl/tools/audio/audio-channels.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Converteer tussen mono en stereo of wissel het linker- en rechterkanaal om."
i18n_source_hash: 4f5cd6b38c83
i18n_provenance: human
i18n_output_hash: 156cb4586783
---
# Audio Channels {#audio-channels}
Converteer audio tussen mono- en stereolay-outs, of wissel het linker- en rechterkanaal van een stereobestand om.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/audio-channels`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| mode | string | Ja | - | Kanaalbewerking: `stereo-to-mono`, `mono-to-stereo`, `swap` |
## Voorbeeldverzoek {#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"}'
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 2300000
}
```
## Opmerkingen {#notes}
- `stereo-to-mono` mixt beide kanalen tot één enkel monospoor.
- `mono-to-stereo` dupliceert het monokanaal naar zowel links als rechts.
- `swap` wisselt het linker- en rechterkanaal van een stereobestand om.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt geschreven als M4A, en niet-ondersteunde decode-only-invoer valt terug op MP3.
apps/docs/nl/tools/audio/audio-metadata.md
+73
View File
@@ -0,0 +1,73 @@
---
description: "Bekijk, bewerk of verwijder audio-metadatatags (ID3)."
i18n_source_hash: 0717018e11cb
i18n_provenance: human
i18n_output_hash: 49c525644c13
---
# Audio Metadata {#audio-metadata}
Bekijk, bewerk of verwijder audio-metadatatags zoals titel, artiest en album (ID3 en vergelijkbare tagformaten).
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/audio-metadata`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| strip | boolean | Nee | `false` | Verwijder alle bestaande metadatatags |
| title | string | Nee | - | Stel de titeltag in (max 500 tekens) |
| artist | string | Nee | - | Stel de artiesttag in (max 500 tekens) |
| album | string | Nee | - | Stel de albumtag in (max 500 tekens) |
## Voorbeeldverzoek {#example-request}
Metadatatags bewerken:
```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"}'
```
Alle metadata verwijderen:
```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}'
```
## Voorbeeldrespons {#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"
}
}
}
```
## Opmerkingen {#notes}
- De respons bevat een `metadata`-object met containerformaat, duur, bitrate en huidige tags.
- Wanneer `strip` `true` is, worden alle tagvelden genegeerd en wordt elke bestaande tag verwijderd.
- Alleen de tags die je opgeeft worden bijgewerkt; niet-opgegeven tags blijven ongewijzigd.
- Het uitvoerformaat komt overeen met het invoerformaat.
apps/docs/nl/tools/audio/audio-speed.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Versnel of vertraag audioweergave met een vermenigvuldiger."
i18n_source_hash: e39ba662e594
i18n_provenance: human
i18n_output_hash: e12f8459ba08
---
# Audio Speed {#audio-speed}
Versnel of vertraag audioweergave door een snelheidsvermenigvuldiger toe te passen.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/audio-speed`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| factor | number | Nee | `1.5` | Snelheidsvermenigvuldiger (0,25 tot 4). Waarden onder 1 vertragen; boven 1 versnellen. |
## Voorbeeldverzoek {#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}'
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 2250000
}
```
## Opmerkingen {#notes}
- Een factor van `0.25` speelt af op een kwart van de snelheid (4x langer). Een factor van `4` speelt af op viervoudige snelheid (4x korter).
- De toonhoogte blijft behouden terwijl de snelheid verandert (time-stretch). Gebruik pitch-shift om de toonhoogte onafhankelijk aan te passen.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt geschreven als M4A, en niet-ondersteunde decode-only-invoer valt terug op MP3.
apps/docs/nl/tools/audio/convert-audio.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Converteer audio tussen de formaten MP3, WAV, OGG, FLAC en M4A."
i18n_source_hash: fd02c059e6a9
i18n_provenance: human
i18n_output_hash: 3a933cf08d88
---
# Convert Audio {#convert-audio}
Converteer audiobestanden tussen gangbare formaten waaronder MP3, WAV, OGG, FLAC en M4A, met configureerbare uitvoerbitrate.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/convert-audio`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| format | string | Nee | `"mp3"` | Uitvoerformaat: `mp3`, `wav`, `ogg`, `flac`, `m4a` |
| bitrateKbps | integer | Nee | `192` | Uitvoerbitrate in kbps (32 tot 320) |
## Voorbeeldverzoek {#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}'
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.flac",
"originalSize": 4500000,
"processedSize": 8200000
}
```
## Opmerkingen {#notes}
- Ondersteunde invoerformaten zijn onder meer MP3, WAV, OGG, FLAC, AAC, M4A, WMA, AIFF en OPUS.
- Bitrate is alleen van toepassing op lossy-formaten (MP3, OGG, M4A). Lossless-formaten zoals WAV en FLAC negeren deze instelling.
- De uitvoerbestandsnaam behoudt de oorspronkelijke naam met de nieuwe extensie.
apps/docs/nl/tools/audio/fade-audio.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Voeg fade-in- en fade-out-effecten toe aan audio."
i18n_source_hash: 86856451ecb8
i18n_provenance: human
i18n_output_hash: 8773bef48ae7
---
# Fade Audio {#fade-audio}
Voeg fade-in- en fade-out-effecten toe aan het begin en einde van een audiobestand.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/fade-audio`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| fadeInS | number | Nee | `1` | Fade-in-duur in seconden (0 tot 30) |
| fadeOutS | number | Nee | `1` | Fade-out-duur in seconden (0 tot 30) |
## Voorbeeldverzoek {#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}'
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Opmerkingen {#notes}
- Stel een van beide waarden in op `0` om die faderichting over te slaan. Ten minste één moet groter zijn dan 0.
- De fadeduur wordt afgekapt tot de audiolengte als deze die overschrijdt.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt geschreven als M4A, en niet-ondersteunde decode-only-invoer valt terug op MP3.
apps/docs/nl/tools/audio/merge-audio.md
+51
View File
@@ -0,0 +1,51 @@
---
description: "Combineer meerdere audiobestanden tot één sequentieel spoor."
i18n_source_hash: defa993d3f87
i18n_provenance: human
i18n_output_hash: 883702b2df37
---
# Merge Audio {#merge-audio}
Combineer twee of meer audiobestanden tot één enkel sequentieel spoor, aaneengeschakeld in de volgorde waarin ze worden geüpload.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/merge-audio`
Accepteert multipart-formuliergegevens met meerdere audiobestanden en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| format | string | Nee | `"mp3"` | Uitvoerformaat: `mp3`, `wav`, `flac`, `m4a` |
## Voorbeeldverzoek {#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"}'
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.mp3",
"originalSize": 9500000,
"processedSize": 9200000
}
```
## Opmerkingen {#notes}
- Accepteert 2 tot 10 audiobestanden per verzoek.
- Bestanden worden aaneengeschakeld in de uploadvolgorde.
- Alle invoerbestanden worden opnieuw gecodeerd naar het gekozen uitvoerformaat en samplefrequentie voor naadloze samenvoeging.
- Gemengde invoerformaten worden ondersteund (bijv. één WAV en één MP3).
apps/docs/nl/tools/audio/noise-reduction.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Verminder achtergrondruis van audio met FFT-gebaseerde ruisonderdrukking."
i18n_source_hash: 57cbdbd449aa
i18n_provenance: human
i18n_output_hash: c21f33d3c98f
---
# Noise Reduction {#noise-reduction}
Verminder achtergrondruis in een audiobestand met FFT-gebaseerde ruisonderdrukking met instelbare sterkte.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/noise-reduction`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| strength | string | Nee | `"medium"` | Sterkte van ruisonderdrukking: `light`, `medium`, `strong` |
## Voorbeeldverzoek {#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"}'
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Opmerkingen {#notes}
- `light` behoudt meer detail maar verwijdert minder ruis. `strong` verwijdert meer ruis maar kan subtiele artefacten introduceren.
- Beste resultaten bij opnamen met consistente achtergrondruis (ventilatorgebrom, airconditioning, statische ruis).
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt geschreven als M4A, en niet-ondersteunde decode-only-invoer valt terug op MP3.
apps/docs/nl/tools/audio/normalize-audio.md
+46
View File
@@ -0,0 +1,46 @@
---
description: "Egaliseer luidheid tot broadcast-standaardniveaus (EBU R128)."
i18n_source_hash: 794d8cfa5ad8
i18n_provenance: human
i18n_output_hash: 1e577bbf068e
---
# Normalize Audio {#normalize-audio}
Egaliseer audioluidheid tot broadcast-standaardniveaus met EBU R128-normalisatie (-16 LUFS).
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/normalize-audio`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
Deze tool heeft geen configureerbare parameters. Het past automatisch EBU R128-luidheidsnormalisatie toe.
## Voorbeeldverzoek {#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"
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Opmerkingen {#notes}
- Gebruikt de EBU R128-luidheidsstandaard, met -16 LUFS als doel.
- Ideaal voor podcasts, audioboeken en broadcast-content waar consistente luidheid belangrijk is.
- De samplefrequentie van de bron blijft behouden in de uitvoer.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt geschreven als M4A, en niet-ondersteunde decode-only-invoer valt terug op MP3.
apps/docs/nl/tools/audio/pitch-shift.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Verhoog of verlaag de audiotoonhoogte met halve tonen zonder de snelheid te wijzigen."
i18n_source_hash: 2804d0eeecc8
i18n_provenance: human
i18n_output_hash: 277ec3d3c809
---
# Pitch Shift {#pitch-shift}
Verhoog of verlaag de toonhoogte van een audiobestand met een aantal halve tonen zonder de afspeelsnelheid te wijzigen.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/pitch-shift`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| semitones | integer | Nee | `3` | Halve tonen om te verschuiven (-12 tot 12). Moet niet nul zijn. |
## Voorbeeldverzoek {#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}'
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Opmerkingen {#notes}
- Positieve waarden verhogen de toonhoogte; negatieve waarden verlagen die.
- Een verschuiving van 12 halve tonen is gelijk aan één octaaf omhoog; -12 is gelijk aan één octaaf omlaag.
- De afspeelduur blijft hetzelfde, ongeacht de mate van verschuiving.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt geschreven als M4A, en niet-ondersteunde decode-only-invoer valt terug op MP3.
apps/docs/nl/tools/audio/reverse-audio.md
+44
View File
@@ -0,0 +1,44 @@
---
description: "Keer een audiobestand om zodat het achterstevoren afspeelt."
i18n_source_hash: 5c2017661803
i18n_provenance: human
i18n_output_hash: 72b27748eb26
---
# Reverse Audio {#reverse-audio}
Keer een audiobestand om zodat het achterstevoren afspeelt.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/reverse-audio`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
Deze tool heeft geen configureerbare parameters. Het volledige audiobestand wordt omgekeerd.
## Voorbeeldverzoek {#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"
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Opmerkingen {#notes}
- Het volledige audiospoor wordt omgekeerd van eind naar begin.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt geschreven als M4A, en niet-ondersteunde decode-only-invoer valt terug op MP3.
apps/docs/nl/tools/audio/ringtone-maker.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Maak een beltoonclip van elk audiobestand."
i18n_source_hash: 8fcdcc545fbc
i18n_provenance: human
i18n_output_hash: 713777991508
---
# Ringtone Maker {#ringtone-maker}
Maak een beltoonclip (.m4r) van elk audiobestand door een starttijd en duur te selecteren.
## API-endpoint {#api-endpoint}
`POST /api/v1/tools/audio/ringtone-maker`
Accepteert multipart-formuliergegevens met een audiobestand en een JSON `settings`-veld.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| startS | number | Nee | `0` | Starttijd in seconden (minimum 0) |
| durationS | number | Nee | `30` | Clipduur in seconden (1 tot 30) |
## Voorbeeldverzoek {#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}'
```
## Voorbeeldrespons {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.m4r",
"originalSize": 4500000,
"processedSize": 620000
}
```
## Opmerkingen {#notes}
- De uitvoer is altijd M4R-formaat, compatibel met iPhone-beltonen.
- De maximale beltoonduur is 30 seconden (Apple-limiet).
- Elk audioformaat kan als invoer worden gebruikt.
apps/docs/nl/tools/audio/silence-removal.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Verwijder stille secties uit een audiobestand."
i18n_source_hash: a7624fc99b50
i18n_provenance: human
i18n_output_hash: 3dcf7034debd
---
# Silence Removal {#silence-removal}
Detecteer en verwijder stille secties uit een audiobestand op basis van een instelbare drempelwaarde en minimale duur.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/silence-removal`
Accepteert multipart-formulierdata met een audiobestand en een JSON-veld `settings`.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| thresholdDb | number | Nee | `-50` | Stiltedrempel in dB (-80 tot -20). Audio onder dit niveau wordt als stil beschouwd. |
| minSilenceS | number | Nee | `0.5` | Minimale stilteduur in seconden om te verwijderen (0.1 tot 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}
- Een hogere (minder negatieve) drempel is agressiever en verwijdert ook stillere passages naast echte stilte.
- Verhoog `minSilenceS` om alleen langere pauzes weg te knippen en korte natuurlijke pauzes te behouden.
- Handig voor het opschonen van podcastopnames, colleges en spraakmemo's.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt weggeschreven als M4A, en niet-ondersteunde decodeer-alleen-invoer valt terug op MP3.
apps/docs/nl/tools/audio/split-audio.md
+64
View File
@@ -0,0 +1,64 @@
---
description: "Splits audio op tijdsintervallen, gelijke delen of stiltedetectie."
i18n_source_hash: c062a395dbac
i18n_provenance: human
i18n_output_hash: e2fe745a5287
---
# Split Audio {#split-audio}
Splits een audiobestand in segmenten op vaste tijdsintervallen, gelijke delen of automatische stiltedetectie. Retourneert een ZIP-archief met de segmenten.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/split-audio`
Accepteert multipart-formulierdata met een audiobestand en een JSON-veld `settings`.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| mode | string | Nee | `"time"` | Splitsstrategie: `time`, `parts`, `silence` |
| segmentS | number | Nee | `60` | Segmentlengte in seconden, 1 tot 3600 (gebruikt wanneer mode `time` is) |
| parts | integer | Nee | `2` | Aantal gelijke delen, 2 tot 20 (gebruikt wanneer mode `parts` is) |
| thresholdDb | number | Nee | `-40` | Stiltedrempel in dB, -80 tot -20 (gebruikt wanneer mode `silence` is) |
| minSilenceS | number | Nee | `0.3` | Minimale stiltepauze in seconden, 0.1 tot 10 (gebruikt wanneer mode `silence` is) |
## Example Request {#example-request}
Splitsen in segmenten van 30 seconden:
```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}'
```
Splitsen op stiltedetectie:
```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}
- De `downloadUrl` verwijst naar een ZIP-archief met alle segmenten.
- Alleen de parameters die relevant zijn voor de gekozen `mode` worden gebruikt; de overige worden genegeerd.
- Segmentbestandsnamen worden opeenvolgend genummerd (bijv. `part-000.mp3`, `part-001.mp3`).
- Het uitvoerformaat komt overeen met het invoerformaat.
apps/docs/nl/tools/audio/transcribe-audio.md
+53
View File
@@ -0,0 +1,53 @@
---
description: "Zet spraak om naar tekst met AI-gestuurde transcriptie."
i18n_source_hash: ae98c4c0aed2
i18n_provenance: human
i18n_output_hash: 658675dcd938
---
# Transcribe Audio {#transcribe-audio}
Zet spraak om naar tekst met AI-gestuurde transcriptie (faster-whisper). Ondersteunt platte tekst, SRT en VTT als uitvoerformaten met automatische of handmatige taalkeuze.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/transcribe-audio`
Accepteert multipart-formulierdata met een audiobestand en een JSON-veld `settings`.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| language | string | Nee | `"auto"` | Taal: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko`, `id`, `th`, `vi` |
| outputFormat | string | Nee | `"txt"` | Uitvoerformaat: `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}
Dit is een asynchrone tool. De API retourneert direct `202 Accepted`:
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"async": true
}
```
Volg de voortgang via SSE op `GET /api/v1/jobs/{jobId}/progress`. Wanneer de taak is voltooid, levert de SSE-stream het eindresultaat met een `downloadUrl`.
## Notes {#notes}
- Vereist dat het **transcription**-featurebundel is geïnstalleerd. Retourneert `501` met code `FEATURE_NOT_INSTALLED`, de ontbrekende `feature`, `featureName` en `estimatedSize` als het bundel niet beschikbaar is.
- Gebruikt faster-whisper voor transcriptie. Taal `auto` detecteert de gesproken taal automatisch.
- De formaten `srt` en `vtt` bevatten tijdstempels voor elk segment, geschikt voor ondertitels.
- Het formaat `txt` retourneert platte tekst zonder tijdstempels.
- Dit is een langlopende AI-tool; de verwerkingstijd hangt af van de audiolengte en de serverhardware.
apps/docs/nl/tools/audio/trim-audio.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Knip een sectie uit een audiobestand door begin- en eindtijden op te geven."
i18n_source_hash: 8b80c5c8a711
i18n_provenance: human
i18n_output_hash: 3f72effdd9e3
---
# Trim Audio {#trim-audio}
Knip een sectie uit een audiobestand door begin- en eindtijden in seconden op te geven.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/trim-audio`
Accepteert multipart-formulierdata met een audiobestand en een JSON-veld `settings`.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| startS | number | Nee | `0` | Begintijd in seconden (minimaal 0) |
| endS | number | Ja | - | Eindtijd in seconden (moet na begin liggen) |
## 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}
- Tijden worden opgegeven in seconden en kunnen decimalen bevatten (bijv. `10.5`).
- De waarde `endS` moet groter zijn dan `startS`.
- Als `endS` de audioduur overschrijdt, wordt het bestand tot het einde bijgesneden.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt weggeschreven als M4A, en niet-ondersteunde decodeer-alleen-invoer valt terug op MP3.
apps/docs/nl/tools/audio/volume-adjust.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Verhoog of verlaag het audiovolume met een vaste versterking in decibel."
i18n_source_hash: b9bc1de2c9ef
i18n_provenance: human
i18n_output_hash: 43dca36f14df
---
# Volume Adjust {#volume-adjust}
Verhoog of verlaag het volume van een audiobestand door een vaste versterking in decibel toe te passen.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/volume-adjust`
Accepteert multipart-formulierdata met een audiobestand en een JSON-veld `settings`.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| gainDb | number | Nee | `3` | Volumeaanpassing in decibel (-30 tot 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}
- Positieve waarden verhogen het volume; negatieve waarden verlagen het.
- Grote positieve versterkingen kunnen clipping veroorzaken. Gebruik normalize-audio voor luidheidsveilige nivellering.
- De uitvoer behoudt meestal de invoercontainer. AAC-invoer wordt weggeschreven als M4A, en niet-ondersteunde decodeer-alleen-invoer valt terug op MP3.
apps/docs/nl/tools/audio/waveform-image.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Genereer een golfvormvisualisatie als een PNG-afbeelding uit een audiobestand."
i18n_source_hash: 5480106dfe48
i18n_provenance: human
i18n_output_hash: 4f317f4f3b35
---
# Waveform Image {#waveform-image}
Genereer een golfvormvisualisatie als een PNG-afbeelding uit een audiobestand, met instelbare afmetingen en kleur.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/waveform-image`
Accepteert multipart-formulierdata met een audiobestand en een JSON-veld `settings`.
## Parameters {#parameters}
| Parameter | Type | Vereist | Standaard | Beschrijving |
|-----------|------|----------|---------|-------------|
| width | integer | Nee | `1024` | Afbeeldingsbreedte in pixels (256 tot 3840) |
| height | integer | Nee | `256` | Afbeeldingshoogte in pixels (64 tot 1080) |
| color | string | Nee | `"#4f46e5"` | Hexkleur van de golfvorm (bijv. `"#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}
- De uitvoer is altijd een PNG-afbeelding, ongeacht het audioformaat van de invoer.
- De golfvorm wordt weergegeven op een transparante achtergrond.
- Handig voor thumbnails, previews voor sociale media of insluiten in webpagina's.