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:
SnapOtter
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Convertir entre mono et stéréo ou intervertir les canaux gauche et droit."
|
||||
i18n_source_hash: 4f5cd6b38c83
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 52a4d4eafb6c
|
||||
---
|
||||
|
||||
# Canaux audio {#audio-channels}
|
||||
|
||||
Convertir l'audio entre les dispositions mono et stéréo, ou intervertir les canaux gauche et droit d'un fichier stéréo.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-channels`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | Oui | - | Opération sur les canaux : `stereo-to-mono`, `mono-to-stereo`, `swap` |
|
||||
|
||||
## Exemple de requête {#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"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 2300000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- `stereo-to-mono` mixe les deux canaux en une seule piste mono.
|
||||
- `mono-to-stereo` duplique le canal mono vers la gauche et la droite.
|
||||
- `swap` échange les canaux gauche et droit d'un fichier stéréo.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées à décodage seul non prises en charge se replient sur le MP3.
|
||||
@@ -0,0 +1,73 @@
|
||||
---
|
||||
description: "Consulter, modifier ou supprimer les balises de métadonnées audio (ID3)."
|
||||
i18n_source_hash: 0717018e11cb
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: a4a43115a499
|
||||
---
|
||||
|
||||
# Métadonnées audio {#audio-metadata}
|
||||
|
||||
Consulter, modifier ou supprimer les balises de métadonnées audio telles que le titre, l'artiste et l'album (formats de balises ID3 et similaires).
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-metadata`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| strip | boolean | Non | `false` | Supprimer toutes les balises de métadonnées existantes |
|
||||
| title | string | Non | - | Définir la balise de titre (500 caractères max) |
|
||||
| artist | string | Non | - | Définir la balise d'artiste (500 caractères max) |
|
||||
| album | string | Non | - | Définir la balise d'album (500 caractères max) |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
Modifier les balises de métadonnées :
|
||||
|
||||
```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"}'
|
||||
```
|
||||
|
||||
Supprimer toutes les métadonnées :
|
||||
|
||||
```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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4480000,
|
||||
"metadata": {
|
||||
"container": "mp3",
|
||||
"durationS": 245.3,
|
||||
"bitrateKbps": 192,
|
||||
"tags": {
|
||||
"title": "My Song",
|
||||
"artist": "Artist Name",
|
||||
"album": "Album Name"
|
||||
}
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- La réponse inclut un objet `metadata` avec le format du conteneur, la durée, le débit et les balises actuelles.
|
||||
- Lorsque `strip` vaut `true`, tous les champs de balises sont ignorés et chaque balise existante est supprimée.
|
||||
- Seules les balises que vous fournissez sont mises à jour ; les balises non spécifiées restent inchangées.
|
||||
- Le format de sortie correspond au format d'entrée.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Accélérer ou ralentir la lecture audio à l'aide d'un multiplicateur."
|
||||
i18n_source_hash: e39ba662e594
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0f2f8d4b8b67
|
||||
---
|
||||
|
||||
# Vitesse audio {#audio-speed}
|
||||
|
||||
Accélérer ou ralentir la lecture audio en appliquant un multiplicateur de vitesse.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/audio-speed`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| factor | number | Non | `1.5` | Multiplicateur de vitesse (0,25 à 4). Les valeurs inférieures à 1 ralentissent ; supérieures à 1 accélèrent. |
|
||||
|
||||
## Exemple de requête {#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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 2250000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Un facteur de `0.25` lit à quart de vitesse (4x plus long). Un facteur de `4` lit à quadruple vitesse (4x plus court).
|
||||
- La hauteur est préservée pendant les changements de vitesse (time-stretch). Utilisez le pitch-shift pour ajuster la hauteur indépendamment.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées à décodage seul non prises en charge se replient sur le MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Convertir l'audio entre les formats MP3, WAV, OGG, FLAC et M4A."
|
||||
i18n_source_hash: fd02c059e6a9
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 9885ffa48ef0
|
||||
---
|
||||
|
||||
# Convertir l'audio {#convert-audio}
|
||||
|
||||
Convertir des fichiers audio entre les formats courants, dont MP3, WAV, OGG, FLAC et M4A, avec un débit de sortie configurable.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/convert-audio`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Non | `"mp3"` | Format de sortie : `mp3`, `wav`, `ogg`, `flac`, `m4a` |
|
||||
| bitrateKbps | integer | Non | `192` | Débit de sortie en kbps (32 à 320) |
|
||||
|
||||
## Exemple de requête {#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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.flac",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 8200000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Les formats d'entrée pris en charge incluent MP3, WAV, OGG, FLAC, AAC, M4A, WMA, AIFF et OPUS.
|
||||
- Le débit ne s'applique qu'aux formats avec perte (MP3, OGG, M4A). Les formats sans perte comme WAV et FLAC ignorent ce paramètre.
|
||||
- Le nom du fichier de sortie conserve le nom d'origine avec la nouvelle extension.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Ajouter des effets de fondu en ouverture et en fermeture à l'audio."
|
||||
i18n_source_hash: 86856451ecb8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7afeec52bfee
|
||||
---
|
||||
|
||||
# Fondu audio {#fade-audio}
|
||||
|
||||
Ajouter des effets de fondu en ouverture et en fermeture au début et à la fin d'un fichier audio.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/fade-audio`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| fadeInS | number | Non | `1` | Durée du fondu en ouverture en secondes (0 à 30) |
|
||||
| fadeOutS | number | Non | `1` | Durée du fondu en fermeture en secondes (0 à 30) |
|
||||
|
||||
## Exemple de requête {#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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#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}
|
||||
|
||||
- Réglez l'une ou l'autre des valeurs sur `0` pour ignorer ce sens de fondu. Au moins une doit être supérieure à 0.
|
||||
- La durée du fondu est bornée à la longueur de l'audio si elle la dépasse.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées à décodage seul non prises en charge se replient sur le MP3.
|
||||
@@ -0,0 +1,51 @@
|
||||
---
|
||||
description: "Combiner plusieurs fichiers audio en une seule piste séquentielle."
|
||||
i18n_source_hash: defa993d3f87
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0c63bdc49bcb
|
||||
---
|
||||
|
||||
# Fusionner l'audio {#merge-audio}
|
||||
|
||||
Combiner deux fichiers audio ou plus en une seule piste séquentielle, concaténés dans l'ordre de leur envoi.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/merge-audio`
|
||||
|
||||
Accepte des données de formulaire multipart avec plusieurs fichiers audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| format | string | Non | `"mp3"` | Format de sortie : `mp3`, `wav`, `flac`, `m4a` |
|
||||
|
||||
## Exemple de requête {#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"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/merged.mp3",
|
||||
"originalSize": 9500000,
|
||||
"processedSize": 9200000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- Accepte de 2 à 10 fichiers audio par requête.
|
||||
- Les fichiers sont concaténés dans l'ordre d'envoi.
|
||||
- Tous les fichiers d'entrée sont réencodés au format de sortie et à la fréquence d'échantillonnage choisis pour un raccord sans coupure.
|
||||
- Les formats d'entrée mixtes sont pris en charge (par exemple, un WAV et un MP3).
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Réduire le bruit de fond de l'audio avec un débruitage basé sur la FFT."
|
||||
i18n_source_hash: 57cbdbd449aa
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2c2cc019e55d
|
||||
---
|
||||
|
||||
# Réduction du bruit {#noise-reduction}
|
||||
|
||||
Réduire le bruit de fond d'un fichier audio à l'aide d'un débruitage basé sur la FFT, avec une intensité sélectionnable.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/noise-reduction`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| strength | string | Non | `"medium"` | Intensité du débruitage : `light`, `medium`, `strong` |
|
||||
|
||||
## Exemple de requête {#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"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#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}
|
||||
|
||||
- `light` préserve plus de détails mais retire moins de bruit. `strong` retire plus de bruit mais peut introduire de subtils artefacts.
|
||||
- Meilleurs résultats sur des enregistrements présentant un bruit de fond constant (ronronnement de ventilateur, climatisation, statique).
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées à décodage seul non prises en charge se replient sur le MP3.
|
||||
@@ -0,0 +1,46 @@
|
||||
---
|
||||
description: "Uniformiser le volume aux niveaux standard de diffusion (EBU R128)."
|
||||
i18n_source_hash: 794d8cfa5ad8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 44d1e25c0c86
|
||||
---
|
||||
|
||||
# Normaliser l'audio {#normalize-audio}
|
||||
|
||||
Uniformiser le volume audio aux niveaux standard de diffusion à l'aide de la normalisation EBU R128 (-16 LUFS).
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/normalize-audio`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. Il applique automatiquement la normalisation du volume EBU R128.
|
||||
|
||||
## Exemple de requête {#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"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#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}
|
||||
|
||||
- Utilise le standard de volume EBU R128, visant -16 LUFS.
|
||||
- Idéal pour les podcasts, les livres audio et les contenus de diffusion où un volume constant est important.
|
||||
- La fréquence d'échantillonnage source est préservée dans la sortie.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées à décodage seul non prises en charge se replient sur le MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Monter ou baisser la hauteur de l'audio par demi-tons sans changer la vitesse."
|
||||
i18n_source_hash: 2804d0eeecc8
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 724d8472c29b
|
||||
---
|
||||
|
||||
# Décalage de hauteur {#pitch-shift}
|
||||
|
||||
Monter ou baisser la hauteur d'un fichier audio d'un nombre de demi-tons sans changer sa vitesse de lecture.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/pitch-shift`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| semitones | integer | Non | `3` | Demi-tons à décaler (-12 à 12). Doit être différent de zéro. |
|
||||
|
||||
## Exemple de requête {#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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#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}
|
||||
|
||||
- Les valeurs positives montent la hauteur ; les valeurs négatives la baissent.
|
||||
- Un décalage de 12 demi-tons équivaut à une octave vers le haut ; -12 équivaut à une octave vers le bas.
|
||||
- La durée de lecture reste identique quelle que soit l'ampleur du décalage.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées à décodage seul non prises en charge se replient sur le MP3.
|
||||
@@ -0,0 +1,44 @@
|
||||
---
|
||||
description: "Inverser un fichier audio pour qu'il soit lu à l'envers."
|
||||
i18n_source_hash: 5c2017661803
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 0233725da70e
|
||||
---
|
||||
|
||||
# Inverser l'audio {#reverse-audio}
|
||||
|
||||
Inverser un fichier audio pour qu'il soit lu à l'envers.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/reverse-audio`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
Cet outil n'a aucun paramètre configurable. L'intégralité du fichier audio est inversée.
|
||||
|
||||
## Exemple de requête {#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"
|
||||
```
|
||||
|
||||
## Exemple de réponse {#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}
|
||||
|
||||
- La piste audio complète est inversée de la fin vers le début.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées à décodage seul non prises en charge se replient sur le MP3.
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
description: "Créer un extrait de sonnerie à partir de n'importe quel fichier audio."
|
||||
i18n_source_hash: 8fcdcc545fbc
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: f54876511b98
|
||||
---
|
||||
|
||||
# Créateur de sonneries {#ringtone-maker}
|
||||
|
||||
Créer un extrait de sonnerie (.m4r) à partir de n'importe quel fichier audio en sélectionnant un temps de départ et une durée.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/ringtone-maker`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| startS | number | Non | `0` | Temps de départ en secondes (minimum 0) |
|
||||
| durationS | number | Non | `30` | Durée de l'extrait en secondes (1 à 30) |
|
||||
|
||||
## Exemple de requête {#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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.m4r",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 620000
|
||||
}
|
||||
```
|
||||
|
||||
## Notes {#notes}
|
||||
|
||||
- La sortie est toujours au format M4R, compatible avec les sonneries iPhone.
|
||||
- La durée maximale d'une sonnerie est de 30 secondes (limite Apple).
|
||||
- N'importe quel format audio peut servir d'entrée.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Supprime les sections silencieuses d'un fichier audio."
|
||||
i18n_source_hash: a7624fc99b50
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: acb9cae0a9f2
|
||||
---
|
||||
|
||||
# Suppression du silence {#silence-removal}
|
||||
|
||||
Détecte et supprime les sections silencieuses d'un fichier audio en fonction d'un seuil et d'une durée minimale configurables.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/silence-removal`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| thresholdDb | number | Non | `-50` | Seuil de silence en dB (-80 à -20). L'audio en dessous de ce niveau est considéré comme silencieux. |
|
||||
| minSilenceS | number | Non | `0.5` | Durée minimale de silence en secondes à supprimer (0,1 à 5) |
|
||||
|
||||
## Exemple de requête {#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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 3200000
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Un seuil plus élevé (moins négatif) est plus agressif et supprime aussi bien les passages plus discrets que le silence réel.
|
||||
- Augmentez `minSilenceS` pour ne supprimer que les pauses plus longues tout en conservant les courts silences naturels.
|
||||
- Utile pour nettoyer des enregistrements de podcasts, des cours et des mémos vocaux.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées uniquement décodables non prises en charge basculent vers MP3.
|
||||
@@ -0,0 +1,64 @@
|
||||
---
|
||||
description: "Découpe l'audio par intervalles de temps, parts égales ou détection de silence."
|
||||
i18n_source_hash: c062a395dbac
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 7303c75d930d
|
||||
---
|
||||
|
||||
# Découper l'audio {#split-audio}
|
||||
|
||||
Découpe un fichier audio en segments par intervalles de temps fixes, parts égales ou détection automatique du silence. Renvoie une archive ZIP des segments.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/split-audio`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| mode | string | Non | `"time"` | Stratégie de découpage : `time`, `parts`, `silence` |
|
||||
| segmentS | number | Non | `60` | Longueur de segment en secondes, 1 à 3600 (utilisé lorsque le mode est `time`) |
|
||||
| parts | integer | Non | `2` | Nombre de parts égales, 2 à 20 (utilisé lorsque le mode est `parts`) |
|
||||
| thresholdDb | number | Non | `-40` | Seuil de silence en dB, -80 à -20 (utilisé lorsque le mode est `silence`) |
|
||||
| minSilenceS | number | Non | `0.3` | Écart de silence minimal en secondes, 0,1 à 10 (utilisé lorsque le mode est `silence`) |
|
||||
|
||||
## Exemple de requête {#example-request}
|
||||
|
||||
Découper en segments de 30 secondes :
|
||||
|
||||
```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}'
|
||||
```
|
||||
|
||||
Découper par détection de silence :
|
||||
|
||||
```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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#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
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Le `downloadUrl` pointe vers une archive ZIP contenant tous les segments.
|
||||
- Seuls les paramètres pertinents pour le `mode` choisi sont utilisés ; les autres sont ignorés.
|
||||
- Les noms de fichiers des segments sont numérotés de façon séquentielle (par ex. `part-000.mp3`, `part-001.mp3`).
|
||||
- Le format de sortie correspond au format d'entrée.
|
||||
@@ -0,0 +1,53 @@
|
||||
---
|
||||
description: "Convertit la parole en texte grâce à une transcription assistée par IA."
|
||||
i18n_source_hash: ae98c4c0aed2
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 1d7bfa5a8cf3
|
||||
---
|
||||
|
||||
# Transcrire l'audio {#transcribe-audio}
|
||||
|
||||
Convertit la parole en texte grâce à une transcription assistée par IA (faster-whisper). Prend en charge les formats de sortie texte brut, SRT et VTT, avec sélection automatique ou manuelle de la langue.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/transcribe-audio`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| language | string | Non | `"auto"` | Langue : `auto`, `en`, `de`, `fr`, `es`, `zh`, `ja`, `ko`, `id`, `th`, `vi` |
|
||||
| outputFormat | string | Non | `"txt"` | Format de sortie : `txt`, `srt`, `vtt` |
|
||||
|
||||
## Exemple de requête {#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"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
C'est un outil asynchrone. L'API renvoie immédiatement `202 Accepted` :
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"async": true
|
||||
}
|
||||
```
|
||||
|
||||
Suivez la progression via SSE à `GET /api/v1/jobs/{jobId}/progress`. Lorsque la tâche se termine, le flux SSE fournit le résultat final avec une `downloadUrl`.
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Nécessite l'installation du pack de fonctionnalités **transcription**. Renvoie `501` avec le code `FEATURE_NOT_INSTALLED`, le `feature` manquant, `featureName` et `estimatedSize` si le pack n'est pas disponible.
|
||||
- Utilise faster-whisper pour la transcription. La langue `auto` détecte automatiquement la langue parlée.
|
||||
- Les formats `srt` et `vtt` incluent des horodatages pour chaque segment, adaptés aux sous-titres.
|
||||
- Le format `txt` renvoie du texte brut sans horodatages.
|
||||
- C'est un outil IA de longue durée ; le temps de traitement dépend de la longueur de l'audio et du matériel du serveur.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Découpe une section d'un fichier audio en spécifiant les temps de début et de fin."
|
||||
i18n_source_hash: 8b80c5c8a711
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d2a8af2e0e7f
|
||||
---
|
||||
|
||||
# Rogner l'audio {#trim-audio}
|
||||
|
||||
Découpe une section d'un fichier audio en spécifiant les temps de début et de fin en secondes.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/trim-audio`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| startS | number | Non | `0` | Temps de début en secondes (minimum 0) |
|
||||
| endS | number | Oui | - | Temps de fin en secondes (doit être postérieur au début) |
|
||||
|
||||
## Exemple de requête {#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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 1575000
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Les temps sont spécifiés en secondes et peuvent inclure des décimales (par ex. `10.5`).
|
||||
- La valeur `endS` doit être supérieure à `startS`.
|
||||
- Si `endS` dépasse la durée de l'audio, le fichier est rogné jusqu'à la fin.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées uniquement décodables non prises en charge basculent vers MP3.
|
||||
@@ -0,0 +1,48 @@
|
||||
---
|
||||
description: "Augmente ou diminue le volume audio d'un gain fixe en décibels."
|
||||
i18n_source_hash: b9bc1de2c9ef
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: d9ac750b5475
|
||||
---
|
||||
|
||||
# Ajuster le volume {#volume-adjust}
|
||||
|
||||
Augmente ou diminue le volume d'un fichier audio en appliquant un gain fixe en décibels.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/volume-adjust`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| gainDb | number | Non | `3` | Ajustement du volume en décibels (-30 à 30) |
|
||||
|
||||
## Exemple de requête {#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}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.mp3",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 4500000
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- Les valeurs positives augmentent le volume ; les valeurs négatives le diminuent.
|
||||
- Des gains positifs importants peuvent provoquer de l'écrêtage. Utilisez normalize-audio pour un nivellement sûr de la sonie.
|
||||
- La sortie conserve généralement le conteneur d'entrée. Une entrée AAC est écrite en M4A, et les entrées uniquement décodables non prises en charge basculent vers MP3.
|
||||
@@ -0,0 +1,50 @@
|
||||
---
|
||||
description: "Génère une visualisation de forme d'onde en image PNG à partir d'un fichier audio."
|
||||
i18n_source_hash: 5480106dfe48
|
||||
i18n_provenance: human
|
||||
i18n_output_hash: 2f164b1945d5
|
||||
---
|
||||
|
||||
# Image de forme d'onde {#waveform-image}
|
||||
|
||||
Génère une visualisation de forme d'onde en image PNG à partir d'un fichier audio, avec des dimensions et une couleur configurables.
|
||||
|
||||
## Point de terminaison de l'API {#api-endpoint}
|
||||
|
||||
`POST /api/v1/tools/audio/waveform-image`
|
||||
|
||||
Accepte des données de formulaire multipart avec un fichier audio et un champ JSON `settings`.
|
||||
|
||||
## Paramètres {#parameters}
|
||||
|
||||
| Paramètre | Type | Requis | Par défaut | Description |
|
||||
|-----------|------|----------|---------|-------------|
|
||||
| width | integer | Non | `1024` | Largeur de l'image en pixels (256 à 3840) |
|
||||
| height | integer | Non | `256` | Hauteur de l'image en pixels (64 à 1080) |
|
||||
| color | string | Non | `"#4f46e5"` | Couleur hexadécimale de la forme d'onde (par ex. `"#4f46e5"`) |
|
||||
|
||||
## Exemple de requête {#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"}'
|
||||
```
|
||||
|
||||
## Exemple de réponse {#example-response}
|
||||
|
||||
```json
|
||||
{
|
||||
"jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
|
||||
"downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/audio.png",
|
||||
"originalSize": 4500000,
|
||||
"processedSize": 45000
|
||||
}
|
||||
```
|
||||
|
||||
## Remarques {#notes}
|
||||
|
||||
- La sortie est toujours une image PNG, quel que soit le format audio d'entrée.
|
||||
- La forme d'onde est rendue sur un fond transparent.
|
||||
- Utile pour les vignettes, les aperçus sur les réseaux sociaux ou l'intégration dans des pages web.
|
||||
Reference in New Issue
Block a user