mirror of
https://github.com/snapotter-hq/SnapOtter.git
synced 2026-08-03 07:46:42 +02:00
feat(docs-i18n): translate all documentation into 20 languages
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:
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konvertera mellan mono och stereo eller byt plats på vänster och höger kanal."
|
||||
i18n_source_hash: 4f5cd6b38c83
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 71433b2fbabd
|
||||
---
|
||||
|
||||
# Audio Channels {#audio-channels}
|
||||
|
||||
Konvertera ljud mellan mono- och stereolayouter, eller byt plats på vänster och höger kanal i en stereofil.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-channels`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | Ja | - | Kanaloperation: `stereo-to-mono`, `mono-to-stereo`, `swap` |
|
||||
|
||||
## Exempelförfrågan {#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"}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 2300000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- `stereo-to-mono` mixar båda kanalerna till ett enda monospår.
|
||||
- `mono-to-stereo` duplicerar monokanalen till både vänster och höger.
|
||||
- `swap` byter plats på vänster och höger kanal i en stereofil.
|
||||
- Utdata behåller vanligtvis inmatningens container. AAC-inmatning skrivs som M4A, och inmatningar som endast kan avkodas och inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,73 @@
|
||||
---
|
||||
description: "Visa, redigera eller ta bort ljudmetadatataggar (ID3)."
|
||||
i18n_source_hash: 0717018e11cb
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9e5aabfad8b3
|
||||
---
|
||||
|
||||
# Audio Metadata {#audio-metadata}
|
||||
|
||||
Visa, redigera eller ta bort ljudmetadatataggar som titel, artist och album (ID3 och liknande taggformat).
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-metadata`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| strip | boolean | Nej | `false` | Ta bort alla befintliga metadatataggar |
|
||||
| title | string | Nej | - | Ange titeltaggen (max 500 tecken) |
|
||||
| artist | string | Nej | - | Ange artisttaggen (max 500 tecken) |
|
||||
| album | string | Nej | - | Ange albumtaggen (max 500 tecken) |
|
||||
|
||||
## Exempelförfrågan {#example-request}
|
||||
|
||||
Redigera metadatataggar:
|
||||
|
||||
```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"}'
|
||||
```
|
||||
|
||||
Ta bort all metadata:
|
||||
|
||||
```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}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#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"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- Svaret inkluderar ett `metadata`-objekt med containerformat, längd, bithastighet och aktuella taggar.
|
||||
- När `strip` är `true` ignoreras alla taggfält och varje befintlig tagg tas bort.
|
||||
- Endast de taggar du anger uppdateras; ospecificerade taggar förblir oförändrade.
|
||||
- Utdataformatet matchar inmatningsformatet.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Snabba upp eller sakta ner ljuduppspelning med en multiplikator."
|
||||
i18n_source_hash: e39ba662e594
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 85363372dd2b
|
||||
---
|
||||
|
||||
# Audio Speed {#audio-speed}
|
||||
|
||||
Snabba upp eller sakta ner ljuduppspelning genom att tillämpa en hastighetsmultiplikator.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-speed`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| factor | number | Nej | `1.5` | Hastighetsmultiplikator (0.25 till 4). Värden under 1 saktar ner; över 1 snabbar upp. |
|
||||
|
||||
## Exempelförfrågan {#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}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 2250000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- En faktor på `0.25` spelar upp i kvartsfart (4x längre). En faktor på `4` spelar upp i fyrdubbel fart (4x kortare).
|
||||
- Tonhöjden bevaras medan hastigheten ändras (tidssträckning). Använd tonhöjdsskifte för att justera tonhöjden oberoende.
|
||||
- Utdata behåller vanligtvis inmatningens container. AAC-inmatning skrivs som M4A, och inmatningar som endast kan avkodas och inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Konvertera ljud mellan formaten MP3, WAV, OGG, FLAC och M4A."
|
||||
i18n_source_hash: fd02c059e6a9
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: a3c8a930904d
|
||||
---
|
||||
|
||||
# Convert Audio {#convert-audio}
|
||||
|
||||
Konvertera ljudfiler mellan vanliga format inklusive MP3, WAV, OGG, FLAC och M4A, med konfigurerbar utdatabithastighet.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/convert-audio`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Nej | `"mp3"` | Utdataformat: `mp3`, `wav`, `ogg`, `flac`, `m4a` |
|
||||
| bitrateKbps | integer | Nej | `192` | Utdatabithastighet i kbps (32 till 320) |
|
||||
|
||||
## Exempelförfrågan {#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}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.flac",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 8200000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- Inmatningsformat som stöds inkluderar MP3, WAV, OGG, FLAC, AAC, M4A, WMA, AIFF och OPUS.
|
||||
- Bithastighet gäller endast förlustkomprimerade format (MP3, OGG, M4A). Förlustfria format som WAV och FLAC ignorerar den här inställningen.
|
||||
- Utdatafilnamnet behåller det ursprungliga namnet med den nya filändelsen.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Lägg till in- och uttoningseffekter i ljud."
|
||||
i18n_source_hash: 86856451ecb8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: e511ff631809
|
||||
---
|
||||
|
||||
# Fade Audio {#fade-audio}
|
||||
|
||||
Lägg till in- och uttoningseffekter i början och slutet av en ljudfil.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/fade-audio`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| fadeInS | number | Nej | `1` | Intoningslängd i sekunder (0 till 30) |
|
||||
| fadeOutS | number | Nej | `1` | Uttoningslängd i sekunder (0 till 30) |
|
||||
|
||||
## Exempelförfrågan {#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}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- Sätt något av värdena till `0` för att hoppa över den toningsriktningen. Minst ett måste vara större än 0.
|
||||
- Toningslängden begränsas till ljudets längd om den överstiger den.
|
||||
- Utdata behåller vanligtvis inmatningens container. AAC-inmatning skrivs som M4A, och inmatningar som endast kan avkodas och inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,51 @@
|
||||
---
|
||||
description: "Kombinera flera ljudfiler till ett sekventiellt spår."
|
||||
i18n_source_hash: defa993d3f87
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 35cceaa4131d
|
||||
---
|
||||
|
||||
# Merge Audio {#merge-audio}
|
||||
|
||||
Kombinera två eller flera ljudfiler till ett enda sekventiellt spår, sammanfogade i den ordning de laddas upp.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/merge-audio`
|
||||
|
||||
Accepterar multipart-formulärdata med flera ljudfiler och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Nej | `"mp3"` | Utdataformat: `mp3`, `wav`, `flac`, `m4a` |
|
||||
|
||||
## Exempelförfrågan {#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"}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.mp3",
|
||||
"originalSize": 9500000,
|
||||
"processedSize": 9200000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- Accepterar 2 till 10 ljudfiler per förfrågan.
|
||||
- Filerna sammanfogas i uppladdningsordning.
|
||||
- Alla inmatningsfiler omkodas till det valda utdataformatet och samplingsfrekvensen för sömlös sammanfogning.
|
||||
- Blandade inmatningsformat stöds (t.ex. en WAV och en MP3).
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Minska bakgrundsljud i ljud med FFT-baserad brusreducering."
|
||||
i18n_source_hash: 57cbdbd449aa
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: a00ce4a3137c
|
||||
---
|
||||
|
||||
# Noise Reduction {#noise-reduction}
|
||||
|
||||
Minska bakgrundsljud i en ljudfil med FFT-baserad brusreducering med valbar styrka.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/noise-reduction`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| strength | string | Nej | `"medium"` | Brusreduceringsstyrka: `light`, `medium`, `strong` |
|
||||
|
||||
## Exempelförfrågan {#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"}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- `light` bevarar mer detaljer men tar bort mindre brus. `strong` tar bort mer brus men kan introducera subtila artefakter.
|
||||
- Bäst resultat på inspelningar med konsekvent bakgrundsljud (fläktbrum, luftkonditionering, statiskt brus).
|
||||
- Utdata behåller vanligtvis inmatningens container. AAC-inmatning skrivs som M4A, och inmatningar som endast kan avkodas och inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Jämna ut ljudstyrkan till nivåer enligt sändningsstandard (EBU R128)."
|
||||
i18n_source_hash: 794d8cfa5ad8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: feecc7e633fa
|
||||
---
|
||||
|
||||
# Normalize Audio {#normalize-audio}
|
||||
|
||||
Jämna ut ljudstyrkan till nivåer enligt sändningsstandard med EBU R128-normalisering (-16 LUFS).
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/normalize-audio`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
Detta verktyg har inga konfigurerbara parametrar. Det tillämpar EBU R128-ljudstyrkenormalisering automatiskt.
|
||||
|
||||
## Exempelförfrågan {#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"
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- Använder ljudstyrkestandarden EBU R128, med målet -16 LUFS.
|
||||
- Idealisk för poddar, ljudböcker och sändningsinnehåll där konsekvent ljudstyrka är viktig.
|
||||
- Källans samplingsfrekvens bevaras i utdata.
|
||||
- Utdata behåller vanligtvis inmatningens container. AAC-inmatning skrivs som M4A, och inmatningar som endast kan avkodas och inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Höj eller sänk ljudets tonhöjd med halvtoner utan att ändra hastigheten."
|
||||
i18n_source_hash: 2804d0eeecc8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: f82647098fa7
|
||||
---
|
||||
|
||||
# Pitch Shift {#pitch-shift}
|
||||
|
||||
Höj eller sänk tonhöjden i en ljudfil med ett antal halvtoner utan att ändra dess uppspelningshastighet.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/pitch-shift`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| semitones | integer | Nej | `3` | Halvtoner att skifta (-12 till 12). Måste vara skilt från noll. |
|
||||
|
||||
## Exempelförfrågan {#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}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- Positiva värden höjer tonhöjden; negativa värden sänker den.
|
||||
- Ett skifte på 12 halvtoner motsvarar en oktav upp; -12 motsvarar en oktav ner.
|
||||
- Uppspelningslängden förblir densamma oavsett skiftets storlek.
|
||||
- Utdata behåller vanligtvis inmatningens container. AAC-inmatning skrivs som M4A, och inmatningar som endast kan avkodas och inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
description: "Vänd en ljudfil så att den spelas baklänges."
|
||||
i18n_source_hash: 5c2017661803
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 584487cec750
|
||||
---
|
||||
|
||||
# Reverse Audio {#reverse-audio}
|
||||
|
||||
Vänd en ljudfil så att den spelas baklänges.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/reverse-audio`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
Detta verktyg har inga konfigurerbara parametrar. Hela ljudfilen vänds.
|
||||
|
||||
## Exempelförfrågan {#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"
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- Hela ljudspåret vänds från slut till början.
|
||||
- Utdata behåller vanligtvis inmatningens container. AAC-inmatning skrivs som M4A, och inmatningar som endast kan avkodas och inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Skapa en ringsignalklipp från valfri ljudfil."
|
||||
i18n_source_hash: 8fcdcc545fbc
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 772a5e405a9d
|
||||
---
|
||||
|
||||
# Ringtone Maker {#ringtone-maker}
|
||||
|
||||
Skapa ett ringsignalklipp (.m4r) från valfri ljudfil genom att välja en starttid och längd.
|
||||
|
||||
## API-slutpunkt {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/ringtone-maker`
|
||||
|
||||
Accepterar multipart-formulärdata med en ljudfil och ett JSON `settings`-fält.
|
||||
|
||||
## Parametrar {#parameters}
|
||||
|
||||
| Parameter | Typ | Obligatorisk | Standard | Beskrivning |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| startS | number | Nej | `0` | Starttid i sekunder (minst 0) |
|
||||
| durationS | number | Nej | `30` | Klippets längd i sekunder (1 till 30) |
|
||||
|
||||
## Exempelförfrågan {#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}'
|
||||
```
|
||||
|
||||
## Exempelsvar {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.m4r",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 620000
|
||||
}
|
||||
```
|
||||
|
||||
## Anteckningar {#notes}
|
||||
|
||||
- Utdata är alltid M4R-format, kompatibelt med iPhone-ringsignaler.
|
||||
- Maximal ringsignallängd är 30 sekunder (Apples gräns).
|
||||
- Vilket ljudformat som helst kan användas som inmatning.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Ta bort tysta avsnitt från en ljudfil."
|
||||
i18n_source_hash: a7624fc99b50
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: b73b5b388edd
|
||||
---
|
||||
|
||||
# Silence Removal {#silence-removal}
|
||||
|
||||
Identifiera och ta bort tysta avsnitt från en ljudfil baserat på ett konfigurerbart tröskelvärde och en minsta varaktighet.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/silence-removal`
|
||||
|
||||
Tar emot multipart-formulärdata med en ljudfil och ett JSON-fält `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| thresholdDb | number | No | `-50` | Tystnadströskel i dB (-80 till -20). Ljud under denna nivå betraktas som tystnad. |
|
||||
| minSilenceS | number | No | `0.5` | Minsta tystnadsvaraktighet i sekunder att ta bort (0,1 till 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}
|
||||
|
||||
- Ett högre (mindre negativt) tröskelvärde är mer aggressivt och tar bort tystare partier likaväl som ren tystnad.
|
||||
- Öka `minSilenceS` för att bara ta bort längre pauser samtidigt som korta naturliga mellanrum behålls.
|
||||
- Användbart för att städa upp poddinspelningar, föreläsningar och röstmemon.
|
||||
- Utdata behåller vanligtvis samma container som indata. AAC-indata skrivs som M4A, och indata som endast går att avkoda men inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,64 @@
|
||||
---
|
||||
description: "Dela upp ljud efter tidsintervall, lika delar eller tystnadsdetektering."
|
||||
i18n_source_hash: c062a395dbac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 1c9add2dc75c
|
||||
---
|
||||
|
||||
# Split Audio {#split-audio}
|
||||
|
||||
Dela upp en ljudfil i segment efter fasta tidsintervall, lika delar eller automatisk tystnadsdetektering. Returnerar ett ZIP-arkiv med segmenten.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/split-audio`
|
||||
|
||||
Tar emot multipart-formulärdata med en ljudfil och ett JSON-fält `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | No | `"time"` | Uppdelningsstrategi: `time`, `parts`, `silence` |
|
||||
| segmentS | number | No | `60` | Segmentlängd i sekunder, 1 till 3600 (används när mode är `time`) |
|
||||
| parts | integer | No | `2` | Antal lika delar, 2 till 20 (används när mode är `parts`) |
|
||||
| thresholdDb | number | No | `-40` | Tystnadströskel i dB, -80 till -20 (används när mode är `silence`) |
|
||||
| minSilenceS | number | No | `0.3` | Minsta tystnadsmellanrum i sekunder, 0,1 till 10 (används när mode är `silence`) |
|
||||
|
||||
## Example Request {#example-request}
|
||||
|
||||
Dela upp i 30-sekunderssegment:
|
||||
|
||||
```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}'
|
||||
```
|
||||
|
||||
Dela upp efter tystnadsdetektering:
|
||||
|
||||
```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` pekar på ett ZIP-arkiv som innehåller alla segment.
|
||||
- Endast de parametrar som är relevanta för det valda `mode` används; övriga ignoreras.
|
||||
- Segmentens filnamn numreras i sekvens (t.ex. `part-000.mp3`, `part-001.mp3`).
|
||||
- Utdataformatet matchar indataformatet.
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
description: "Omvandla tal till text med AI-driven transkribering."
|
||||
i18n_source_hash: ae98c4c0aed2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2c0cc1fc4468
|
||||
---
|
||||
|
||||
# Transcribe Audio {#transcribe-audio}
|
||||
|
||||
Omvandla tal till text med AI-driven transkribering (faster-whisper). Stöder utdataformaten oformaterad text, SRT och VTT med automatiskt eller manuellt språkval.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/transcribe-audio`
|
||||
|
||||
Tar emot multipart-formulärdata med en ljudfil och ett JSON-fält `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| language | string | No | `"auto"` | Språk: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko`, `id`, `th`, `vi` |
|
||||
| outputFormat | string | No | `"txt"` | Utdataformat: `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}
|
||||
|
||||
Detta är ett asynkront verktyg. API:et returnerar `202 Accepted` omedelbart:
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
Följ förloppet via SSE på `GET /api/v1/jobs/{jobId}/progress`. När jobbet är klart levererar SSE-strömmen det slutliga resultatet med en `downloadUrl`.
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Kräver att funktionspaketet **transcription** är installerat. Returnerar `501` med koden `FEATURE_NOT_INSTALLED`, det saknade `feature`, `featureName` och `estimatedSize` om paketet inte är tillgängligt.
|
||||
- Använder faster-whisper för transkribering. Språket `auto` identifierar det talade språket automatiskt.
|
||||
- Formaten `srt` och `vtt` innehåller tidsstämplar för varje segment, lämpliga för undertexter.
|
||||
- Formatet `txt` returnerar oformaterad text utan tidsstämplar.
|
||||
- Detta är ett långkörande AI-verktyg; bearbetningstiden beror på ljudets längd och serverns hårdvara.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Klipp ut ett avsnitt ur en ljudfil genom att ange start- och sluttider."
|
||||
i18n_source_hash: 8b80c5c8a711
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 1770fa7c239a
|
||||
---
|
||||
|
||||
# Trim Audio {#trim-audio}
|
||||
|
||||
Klipp ut ett avsnitt ur en ljudfil genom att ange start- och sluttider i sekunder.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/trim-audio`
|
||||
|
||||
Tar emot multipart-formulärdata med en ljudfil och ett JSON-fält `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| startS | number | No | `0` | Starttid i sekunder (minst 0) |
|
||||
| endS | number | Yes | - | Sluttid i sekunder (måste vara efter start) |
|
||||
|
||||
## 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}
|
||||
|
||||
- Tider anges i sekunder och kan innehålla decimaler (t.ex. `10.5`).
|
||||
- Värdet `endS` måste vara större än `startS`.
|
||||
- Om `endS` överstiger ljudets varaktighet trimmas filen till slutet.
|
||||
- Utdata behåller vanligtvis samma container som indata. AAC-indata skrivs som M4A, och indata som endast går att avkoda men inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Öka eller minska ljudvolymen med en fast förstärkning i decibel."
|
||||
i18n_source_hash: b9bc1de2c9ef
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 45d6cfb545cc
|
||||
---
|
||||
|
||||
# Volume Adjust {#volume-adjust}
|
||||
|
||||
Öka eller minska volymen på en ljudfil genom att tillämpa en fast förstärkning i decibel.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/volume-adjust`
|
||||
|
||||
Tar emot multipart-formulärdata med en ljudfil och ett JSON-fält `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| gainDb | number | No | `3` | Volymjustering i decibel (-30 till 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}
|
||||
|
||||
- Positiva värden ökar volymen; negativa värden minskar den.
|
||||
- Stora positiva förstärkningar kan orsaka klippning. Använd normalize-audio för nivåjustering som är säker för ljudstyrkan.
|
||||
- Utdata behåller vanligtvis samma container som indata. AAC-indata skrivs som M4A, och indata som endast går att avkoda men inte stöds faller tillbaka till MP3.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Generera en vågformsvisualisering som en PNG-bild från en ljudfil."
|
||||
i18n_source_hash: 5480106dfe48
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 6544e34522a8
|
||||
---
|
||||
|
||||
# Waveform Image {#waveform-image}
|
||||
|
||||
Generera en vågformsvisualisering som en PNG-bild från en ljudfil, med konfigurerbara mått och färg.
|
||||
|
||||
## API Endpoint {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/waveform-image`
|
||||
|
||||
Tar emot multipart-formulärdata med en ljudfil och ett JSON-fält `settings`.
|
||||
|
||||
## Parameters {#parameters}
|
||||
|
||||
| Parameter | Type | Required | Default | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| width | integer | No | `1024` | Bildbredd i pixlar (256 till 3840) |
|
||||
| height | integer | No | `256` | Bildhöjd i pixlar (64 till 1080) |
|
||||
| color | string | No | `"#4f46e5"` | Vågformens hex-färg (t.ex. `"#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}
|
||||
|
||||
- Utdata är alltid en PNG-bild, oavsett indataljudets format.
|
||||
- Vågformen renderas mot en genomskinlig bakgrund.
|
||||
- Användbart för miniatyrbilder, förhandsvisningar i sociala medier eller inbäddning på webbsidor.
|
||||
Reference in New Issue
Block a user