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:
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
@@ -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.
+48
View File
@@ -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.
+49
View File
@@ -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.
+49
View File
@@ -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.
+51
View File
@@ -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.
+49
View File
@@ -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.
+44
View File
@@ -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.
+64
View File
@@ -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.
+50
View File
@@ -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.
+48
View File
@@ -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.