Files
SnapOtter/apps/docs/fr/tools/video/auto-subtitles.md
T
SnapOtterandGitHub 4963ab3bbd 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.
2026-07-11 13:52:47 +08:00

2.2 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Générer des fichiers de sous-titres à partir des pistes audio d'une vidéo à l'aide de l'IA. 35b1e78501ad human 979fd7cb561a

Sous-titres automatiques

Générez des fichiers de sous-titres à partir de la piste audio d'une vidéo à l'aide de la reconnaissance vocale assistée par IA (faster-whisper). Prend en charge la détection automatique et 10 langues explicites.

Point de terminaison de l'API

POST /api/v1/tools/video/auto-subtitles

Accepte des données de formulaire multipart avec un fichier vidéo et un champ settings au format JSON. Il s'agit d'un point de terminaison asynchrone : il renvoie 202 Accepted immédiatement et la progression est diffusée via SSE à GET /api/v1/jobs/{jobId}/progress.

Paramètres

Paramètre Type Requis Par défaut Description
language string Non "auto" Langue de la parole : auto, en, de, fr, es, zh, ja, ko, id, th, vi
format string Non "srt" Format de sous-titres de sortie : srt, vtt

Exemple de requête

curl -X POST http://localhost:1349/api/v1/tools/video/auto-subtitles \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"language": "en", "format": "srt"}'

Exemple de réponse

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "async": true
}

Remarques

  • Il s'agit d'un outil d'IA qui nécessite l'installation du pack de fonctionnalités transcription. Si le pack n'est pas installé, l'API renvoie 501 Feature Not Installed avec des instructions pour l'installer via l'interface d'administration.
  • L'option de langue auto utilise la détection de langue intégrée de whisper. Spécifier explicitement la langue améliore la précision et la vitesse.
  • SRT est le format de sous-titres le plus largement pris en charge. VTT (WebVTT) est la norme pour les lecteurs vidéo web.
  • Les mises à jour de progression sont disponibles via SSE à GET /api/v1/jobs/{jobId}/progress jusqu'à ce que le travail soit terminé.