Files
SnapOtter/apps/docs/es/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
Genera archivos de subtítulos a partir de las pistas de audio de un vídeo mediante IA. 35b1e78501ad human b9f08b6dd120

Subtítulos automáticos

Genera archivos de subtítulos a partir de la pista de audio de un vídeo mediante reconocimiento de voz con inteligencia artificial (faster-whisper). Admite la detección automática y 10 idiomas explícitos.

API Endpoint

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

Acepta datos de formulario multipart con un archivo de vídeo y un campo JSON settings. Este es un endpoint asíncrono: devuelve 202 Accepted de inmediato y el progreso se transmite mediante SSE en GET /api/v1/jobs/{jobId}/progress.

Parameters

Parámetro Tipo Obligatorio Predeterminado Descripción
language string No "auto" Idioma del habla: auto, en, de, fr, es, zh, ja, ko, id, th, vi
format string No "srt" Formato de subtítulos de salida: srt, vtt

Example Request

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"}'

Example Response

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

Notes

  • Esta es una herramienta de IA que requiere que el paquete de funciones de transcripción esté instalado. Si el paquete no está instalado, la API devuelve 501 Feature Not Installed con instrucciones para instalarlo mediante la interfaz de administración.
  • La opción de idioma auto usa la detección de idioma integrada de whisper. Especificar el idioma de forma explícita mejora la precisión y la velocidad.
  • SRT es el formato de subtítulos más ampliamente compatible. VTT (WebVTT) es el estándar para los reproductores de vídeo web.
  • Las actualizaciones de progreso están disponibles mediante SSE en GET /api/v1/jobs/{jobId}/progress hasta que el trabajo se complete.