Files
SnapOtter/apps/docs/pt-BR/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.1 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Gere arquivos de legenda a partir das faixas de áudio de vídeos usando IA. 35b1e78501ad human 07156969c129

Auto Subtitles

Gere arquivos de legenda a partir da faixa de áudio de um vídeo usando reconhecimento de fala com tecnologia de IA (faster-whisper). Oferece suporte à detecção automática e a 10 idiomas explícitos.

API Endpoint

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

Aceita dados de formulário multipart com um arquivo de vídeo e um campo JSON settings. Este é um endpoint assíncrono - ele retorna 202 Accepted imediatamente e o progresso é transmitido via SSE em GET /api/v1/jobs/{jobId}/progress.

Parameters

Parâmetro Tipo Obrigatório Padrão Descrição
language string Não "auto" Idioma da fala: auto, en, de, fr, es, zh, ja, ko, id, th, vi
format string Não "srt" Formato de legenda de saída: 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 é uma ferramenta de IA que requer que o pacote de recurso transcription esteja instalado. Se o pacote não estiver instalado, a API retorna 501 Feature Not Installed com instruções para instalá-lo pela interface de administração.
  • A opção de idioma auto usa a detecção de idioma integrada do whisper. Especificar o idioma explicitamente melhora a precisão e a velocidade.
  • SRT é o formato de legenda com suporte mais amplo. VTT (WebVTT) é o padrão para reprodutores de vídeo web.
  • Atualizações de progresso ficam disponíveis via SSE em GET /api/v1/jobs/{jobId}/progress até o job ser concluído.