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/it/tools/audio/audio-channels.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Converti tra mono e stereo o scambia i canali sinistro e destro."
i18n_source_hash: 4f5cd6b38c83
i18n_provenance: human
i18n_output_hash: e075bdec462d
---
# Canali audio {#audio-channels}
Converti l'audio tra layout mono e stereo, oppure scambia i canali sinistro e destro di un file stereo.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/audio-channels`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| mode | string | Sì | - | Operazione sui canali: `stereo-to-mono`, `mono-to-stereo`, `swap` |
## Esempio di richiesta {#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"}'
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 2300000
}
```
## Note {#notes}
- `stereo-to-mono` mixa entrambi i canali in un'unica traccia mono.
- `mono-to-stereo` duplica il canale mono su sinistro e destro.
- `swap` scambia i canali sinistro e destro di un file stereo.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A, e gli input decodificabili solo in lettura non supportati ricadono su MP3.
apps/docs/it/tools/audio/audio-metadata.md
+73
View File
@@ -0,0 +1,73 @@
---
description: "Visualizza, modifica o rimuovi i tag di metadati audio (ID3)."
i18n_source_hash: 0717018e11cb
i18n_provenance: human
i18n_output_hash: 1deb134d1e4d
---
# Metadati audio {#audio-metadata}
Visualizza, modifica o rimuovi i tag di metadati audio come titolo, artista e album (ID3 e formati di tag simili).
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/audio-metadata`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| strip | boolean | No | `false` | Rimuovi tutti i tag di metadati esistenti |
| title | string | No | - | Imposta il tag del titolo (max 500 caratteri) |
| artist | string | No | - | Imposta il tag dell'artista (max 500 caratteri) |
| album | string | No | - | Imposta il tag dell'album (max 500 caratteri) |
## Esempio di richiesta {#example-request}
Modifica i tag di metadati:
```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"}'
```
Rimuovi tutti i metadati:
```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}'
```
## Esempio di risposta {#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"
}
}
}
```
## Note {#notes}
- La risposta include un oggetto `metadata` con formato del container, durata, bitrate e tag correnti.
- Quando `strip` è `true`, tutti i campi dei tag vengono ignorati e ogni tag esistente viene rimosso.
- Vengono aggiornati solo i tag che fornisci; i tag non specificati rimangono invariati.
- Il formato di output corrisponde al formato di input.
apps/docs/it/tools/audio/audio-speed.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Accelera o rallenta la riproduzione audio con un moltiplicatore."
i18n_source_hash: e39ba662e594
i18n_provenance: human
i18n_output_hash: 825a567c411c
---
# Velocità audio {#audio-speed}
Accelera o rallenta la riproduzione audio applicando un moltiplicatore di velocità.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/audio-speed`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| factor | number | No | `1.5` | Moltiplicatore di velocità (da 0.25 a 4). Valori inferiori a 1 rallentano; superiori a 1 accelerano. |
## Esempio di richiesta {#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}'
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 2250000
}
```
## Note {#notes}
- Un fattore di `0.25` riproduce a un quarto della velocità (4 volte più lungo). Un fattore di `4` riproduce a velocità quadrupla (4 volte più corto).
- L'intonazione viene preservata mentre la velocità cambia (time-stretch). Usa il pitch-shift per regolare l'intonazione in modo indipendente.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A, e gli input decodificabili solo in lettura non supportati ricadono su MP3.
apps/docs/it/tools/audio/convert-audio.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Converti l'audio tra i formati MP3, WAV, OGG, FLAC e M4A."
i18n_source_hash: fd02c059e6a9
i18n_provenance: human
i18n_output_hash: 6e412e45cdc2
---
# Converti audio {#convert-audio}
Converti i file audio tra i formati comuni tra cui MP3, WAV, OGG, FLAC e M4A, con bitrate di output configurabile.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/convert-audio`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| format | string | No | `"mp3"` | Formato di output: `mp3`, `wav`, `ogg`, `flac`, `m4a` |
| bitrateKbps | integer | No | `192` | Bitrate di output in kbps (da 32 a 320) |
## Esempio di richiesta {#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}'
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.flac",
"originalSize": 4500000,
"processedSize": 8200000
}
```
## Note {#notes}
- I formati di input supportati includono MP3, WAV, OGG, FLAC, AAC, M4A, WMA, AIFF e OPUS.
- Il bitrate si applica solo ai formati con perdita (MP3, OGG, M4A). I formati senza perdita come WAV e FLAC ignorano questa impostazione.
- Il nome del file di output mantiene il nome originale con la nuova estensione.
apps/docs/it/tools/audio/fade-audio.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Aggiungi effetti di dissolvenza in entrata e in uscita all'audio."
i18n_source_hash: 86856451ecb8
i18n_provenance: human
i18n_output_hash: a91f9d495071
---
# Dissolvenza audio {#fade-audio}
Aggiungi effetti di dissolvenza in entrata e in uscita all'inizio e alla fine di un file audio.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/fade-audio`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| fadeInS | number | No | `1` | Durata della dissolvenza in entrata in secondi (da 0 a 30) |
| fadeOutS | number | No | `1` | Durata della dissolvenza in uscita in secondi (da 0 a 30) |
## Esempio di richiesta {#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}'
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Note {#notes}
- Imposta uno dei due valori a `0` per saltare quella direzione della dissolvenza. Almeno uno deve essere maggiore di 0.
- La durata della dissolvenza viene limitata alla lunghezza dell'audio se la supera.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A, e gli input decodificabili solo in lettura non supportati ricadono su MP3.
apps/docs/it/tools/audio/merge-audio.md
+51
View File
@@ -0,0 +1,51 @@
---
description: "Combina più file audio in un'unica traccia sequenziale."
i18n_source_hash: defa993d3f87
i18n_provenance: human
i18n_output_hash: 08623df5e904
---
# Unisci audio {#merge-audio}
Combina due o più file audio in un'unica traccia sequenziale, concatenati nell'ordine in cui vengono caricati.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/merge-audio`
Accetta dati di form multipart con più file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| format | string | No | `"mp3"` | Formato di output: `mp3`, `wav`, `flac`, `m4a` |
## Esempio di richiesta {#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"}'
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.mp3",
"originalSize": 9500000,
"processedSize": 9200000
}
```
## Note {#notes}
- Accetta da 2 a 10 file audio per richiesta.
- I file vengono concatenati nell'ordine di caricamento.
- Tutti i file di input vengono ricodificati nel formato di output e nella frequenza di campionamento scelti per una giunzione senza interruzioni.
- Sono supportati formati di input misti (ad es. un WAV e un MP3).
apps/docs/it/tools/audio/noise-reduction.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Riduci il rumore di fondo dall'audio con denoising basato su FFT."
i18n_source_hash: 57cbdbd449aa
i18n_provenance: human
i18n_output_hash: fca867f7bf41
---
# Riduzione del rumore {#noise-reduction}
Riduci il rumore di fondo in un file audio usando il denoising basato su FFT con intensità selezionabile.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/noise-reduction`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| strength | string | No | `"medium"` | Intensità del denoising: `light`, `medium`, `strong` |
## Esempio di richiesta {#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"}'
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Note {#notes}
- `light` preserva più dettagli ma rimuove meno rumore. `strong` rimuove più rumore ma può introdurre artefatti sottili.
- Risultati migliori su registrazioni con rumore di fondo costante (ronzio di ventole, aria condizionata, statica).
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A, e gli input decodificabili solo in lettura non supportati ricadono su MP3.
apps/docs/it/tools/audio/normalize-audio.md
+46
View File
@@ -0,0 +1,46 @@
---
description: "Uniforma il volume ai livelli dello standard di trasmissione (EBU R128)."
i18n_source_hash: 794d8cfa5ad8
i18n_provenance: human
i18n_output_hash: 9c3207d1da74
---
# Normalizza audio {#normalize-audio}
Uniforma il volume dell'audio ai livelli dello standard di trasmissione usando la normalizzazione EBU R128 (-16 LUFS).
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/normalize-audio`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
Questo strumento non ha parametri configurabili. Applica automaticamente la normalizzazione del volume EBU R128.
## Esempio di richiesta {#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"
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Note {#notes}
- Usa lo standard di volume EBU R128, con target -16 LUFS.
- Ideale per podcast, audiolibri e contenuti di trasmissione dove è importante un volume costante.
- La frequenza di campionamento sorgente viene preservata nell'output.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A, e gli input decodificabili solo in lettura non supportati ricadono su MP3.
apps/docs/it/tools/audio/pitch-shift.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Alza o abbassa l'intonazione dell'audio di semitoni senza cambiare la velocità."
i18n_source_hash: 2804d0eeecc8
i18n_provenance: human
i18n_output_hash: 98878f0a95d7
---
# Pitch Shift {#pitch-shift}
Alza o abbassa l'intonazione di un file audio di un certo numero di semitoni senza cambiarne la velocità di riproduzione.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/pitch-shift`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| semitones | integer | No | `3` | Semitoni di cui spostare (da -12 a 12). Deve essere diverso da zero. |
## Esempio di richiesta {#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}'
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Note {#notes}
- I valori positivi alzano l'intonazione; i valori negativi la abbassano.
- Uno spostamento di 12 semitoni equivale a un'ottava in su; -12 equivale a un'ottava in giù.
- La durata di riproduzione rimane invariata indipendentemente dall'entità dello spostamento.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A, e gli input decodificabili solo in lettura non supportati ricadono su MP3.
apps/docs/it/tools/audio/reverse-audio.md
+44
View File
@@ -0,0 +1,44 @@
---
description: "Inverti un file audio in modo che venga riprodotto al contrario."
i18n_source_hash: 5c2017661803
i18n_provenance: human
i18n_output_hash: 97edd86e80a0
---
# Inverti audio {#reverse-audio}
Inverti un file audio in modo che venga riprodotto al contrario.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/reverse-audio`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
Questo strumento non ha parametri configurabili. L'intero file audio viene invertito.
## Esempio di richiesta {#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"
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
"originalSize": 4500000,
"processedSize": 4500000
}
```
## Note {#notes}
- L'intera traccia audio viene invertita dalla fine all'inizio.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A, e gli input decodificabili solo in lettura non supportati ricadono su MP3.
apps/docs/it/tools/audio/ringtone-maker.md
+49
View File
@@ -0,0 +1,49 @@
---
description: "Crea una suoneria da qualsiasi file audio."
i18n_source_hash: 8fcdcc545fbc
i18n_provenance: human
i18n_output_hash: 365695cb651c
---
# Creatore di suonerie {#ringtone-maker}
Crea una suoneria (.m4r) da qualsiasi file audio selezionando un tempo di inizio e una durata.
## Endpoint API {#api-endpoint}
`POST /api/v1/tools/audio/ringtone-maker`
Accetta dati di form multipart con un file audio e un campo JSON `settings`.
## Parametri {#parameters}
| Parametro | Tipo | Obbligatorio | Predefinito | Descrizione |
|-----------|------|----------|---------|-------------|
| startS | number | No | `0` | Tempo di inizio in secondi (minimo 0) |
| durationS | number | No | `30` | Durata della clip in secondi (da 1 a 30) |
## Esempio di richiesta {#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}'
```
## Esempio di risposta {#example-response}
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.m4r",
"originalSize": 4500000,
"processedSize": 620000
}
```
## Note {#notes}
- L'output è sempre in formato M4R, compatibile con le suonerie iPhone.
- La durata massima della suoneria è di 30 secondi (limite Apple).
- È possibile usare qualsiasi formato audio come input.
apps/docs/it/tools/audio/silence-removal.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Elimina le sezioni silenziose da un file audio."
i18n_source_hash: a7624fc99b50
i18n_provenance: human
i18n_output_hash: 0224e21cff57
---
# Silence Removal {#silence-removal}
Rileva e rimuove le sezioni silenziose da un file audio in base a una soglia e a una durata minima configurabili.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/silence-removal`
Accetta dati form multipart con un file audio e un campo JSON `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| thresholdDb | number | No | `-50` | Soglia di silenzio in dB (da -80 a -20). L'audio al di sotto di questo livello viene considerato silenzio. |
| minSilenceS | number | No | `0.5` | Durata minima del silenzio in secondi da rimuovere (da 0.1 a 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}
- Una soglia più alta (meno negativa) è più aggressiva e rimuove anche i passaggi più silenziosi oltre al silenzio vero e proprio.
- Aumenta `minSilenceS` per eliminare solo le pause più lunghe mantenendo i brevi intervalli naturali.
- Utile per ripulire registrazioni di podcast, lezioni e note vocali.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A e gli input non supportati per la sola decodifica ricadono su MP3.
apps/docs/it/tools/audio/split-audio.md
+64
View File
@@ -0,0 +1,64 @@
---
description: "Divide l'audio per intervalli di tempo, parti uguali o rilevamento del silenzio."
i18n_source_hash: c062a395dbac
i18n_provenance: human
i18n_output_hash: caaeaed100a3
---
# Split Audio {#split-audio}
Divide un file audio in segmenti per intervalli di tempo fissi, parti uguali o rilevamento automatico del silenzio. Restituisce un archivio ZIP dei segmenti.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/split-audio`
Accetta dati form multipart con un file audio e un campo JSON `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| mode | string | No | `"time"` | Strategia di divisione: `time`, `parts`, `silence` |
| segmentS | number | No | `60` | Lunghezza del segmento in secondi, da 1 a 3600 (usato quando la mode è `time`) |
| parts | integer | No | `2` | Numero di parti uguali, da 2 a 20 (usato quando la mode è `parts`) |
| thresholdDb | number | No | `-40` | Soglia di silenzio in dB, da -80 a -20 (usato quando la mode è `silence`) |
| minSilenceS | number | No | `0.3` | Intervallo minimo di silenzio in secondi, da 0.1 a 10 (usato quando la mode è `silence`) |
## Example Request {#example-request}
Dividi in segmenti da 30 secondi:
```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}'
```
Dividi tramite rilevamento del silenzio:
```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}
- Il `downloadUrl` punta a un archivio ZIP contenente tutti i segmenti.
- Vengono usati solo i parametri rilevanti per la `mode` scelta; gli altri vengono ignorati.
- I nomi dei file dei segmenti sono numerati in sequenza (ad esempio `part-000.mp3`, `part-001.mp3`).
- Il formato di output corrisponde al formato di input.
apps/docs/it/tools/audio/transcribe-audio.md
+53
View File
@@ -0,0 +1,53 @@
---
description: "Converte il parlato in testo con trascrizione basata su AI."
i18n_source_hash: ae98c4c0aed2
i18n_provenance: human
i18n_output_hash: 654e18766567
---
# Transcribe Audio {#transcribe-audio}
Converte il parlato in testo usando la trascrizione basata su AI (faster-whisper). Supporta formati di output in testo semplice, SRT e VTT con selezione della lingua automatica o manuale.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/transcribe-audio`
Accetta dati form multipart con un file audio e un campo JSON `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| language | string | No | `"auto"` | Lingua: `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko`, `id`, `th`, `vi` |
| outputFormat | string | No | `"txt"` | Formato di output: `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}
Questo è uno strumento asincrono. L'API restituisce `202 Accepted` immediatamente:
```json
{
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"async": true
}
```
Monitora l'avanzamento tramite SSE su `GET /api/v1/jobs/{jobId}/progress`. Al completamento del job, lo stream SSE fornisce il risultato finale con un `downloadUrl`.
## Notes {#notes}
- Richiede l'installazione del feature bundle **transcription**. Restituisce `501` con codice `FEATURE_NOT_INSTALLED`, il `feature` mancante, `featureName` e `estimatedSize` se il bundle non è disponibile.
- Usa faster-whisper per la trascrizione. La lingua `auto` rileva automaticamente la lingua parlata.
- I formati `srt` e `vtt` includono i timestamp per ogni segmento, adatti ai sottotitoli.
- Il formato `txt` restituisce testo semplice senza timestamp.
- Questo è uno strumento AI a lunga esecuzione; il tempo di elaborazione dipende dalla lunghezza dell'audio e dall'hardware del server.
apps/docs/it/tools/audio/trim-audio.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Ritaglia una sezione da un file audio specificando l'ora di inizio e di fine."
i18n_source_hash: 8b80c5c8a711
i18n_provenance: human
i18n_output_hash: eff2ff178e03
---
# Trim Audio {#trim-audio}
Ritaglia una sezione da un file audio specificando l'ora di inizio e di fine in secondi.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/trim-audio`
Accetta dati form multipart con un file audio e un campo JSON `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| startS | number | No | `0` | Ora di inizio in secondi (minimo 0) |
| endS | number | Yes | - | Ora di fine in secondi (deve essere dopo l'inizio) |
## 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}
- Gli orari sono specificati in secondi e possono includere decimali (ad esempio `10.5`).
- Il valore `endS` deve essere maggiore di `startS`.
- Se `endS` supera la durata dell'audio, il file viene ritagliato fino alla fine.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A e gli input non supportati per la sola decodifica ricadono su MP3.
apps/docs/it/tools/audio/volume-adjust.md
+48
View File
@@ -0,0 +1,48 @@
---
description: "Aumenta o riduce il volume dell'audio applicando un guadagno fisso in decibel."
i18n_source_hash: b9bc1de2c9ef
i18n_provenance: human
i18n_output_hash: 5872c4abd11c
---
# Volume Adjust {#volume-adjust}
Aumenta o riduce il volume di un file audio applicando un guadagno fisso in decibel.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/volume-adjust`
Accetta dati form multipart con un file audio e un campo JSON `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| gainDb | number | No | `3` | Regolazione del volume in decibel (da -30 a 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}
- I valori positivi aumentano il volume; i valori negativi lo riducono.
- Guadagni positivi elevati possono causare clipping. Usa normalize-audio per un livellamento sicuro rispetto al volume.
- L'output di solito mantiene il container di input. L'input AAC viene scritto come M4A e gli input non supportati per la sola decodifica ricadono su MP3.
apps/docs/it/tools/audio/waveform-image.md
+50
View File
@@ -0,0 +1,50 @@
---
description: "Genera una visualizzazione della forma d'onda come immagine PNG da un file audio."
i18n_source_hash: 5480106dfe48
i18n_provenance: human
i18n_output_hash: 7219960b7892
---
# Waveform Image {#waveform-image}
Genera una visualizzazione della forma d'onda come immagine PNG da un file audio, con dimensioni e colore configurabili.
## API Endpoint {#api-endpoint}
`POST /api/v1/tools/audio/waveform-image`
Accetta dati form multipart con un file audio e un campo JSON `settings`.
## Parameters {#parameters}
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| width | integer | No | `1024` | Larghezza dell'immagine in pixel (da 256 a 3840) |
| height | integer | No | `256` | Altezza dell'immagine in pixel (da 64 a 1080) |
| color | string | No | `"#4f46e5"` | Colore esadecimale della forma d'onda (ad esempio `"#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}
- L'output è sempre un'immagine PNG, indipendentemente dal formato audio di input.
- La forma d'onda viene renderizzata su uno sfondo trasparente.
- Utile per miniature, anteprime per i social media o l'incorporamento nelle pagine web.