Files
SnapOtter/apps/docs/pl/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.0 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Generuj pliki napisów ze ścieżek dźwiękowych filmów za pomocą AI. 35b1e78501ad human 0f22e0c5dfe6

Auto Subtitles

Generuj pliki napisów ze ścieżki dźwiękowej filmu za pomocą rozpoznawania mowy opartego na AI (faster-whisper). Obsługuje automatyczne wykrywanie oraz 10 jawnie wskazanych języków.

API Endpoint

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

Przyjmuje dane formularza multipart z plikiem wideo oraz polem JSON settings. To punkt końcowy asynchroniczny - zwraca natychmiast 202 Accepted, a postęp jest strumieniowany przez SSE pod GET /api/v1/jobs/{jobId}/progress.

Parameters

Parameter Type Required Default Description
language string No "auto" Język mowy: auto, en, de, fr, es, zh, ja, ko, id, th, vi
format string No "srt" Format wyjściowy napisów: 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

  • To narzędzie AI, które wymaga zainstalowania pakietu funkcji transcription. Jeśli pakiet nie jest zainstalowany, API zwraca 501 Feature Not Installed z instrukcjami instalacji przez interfejs administratora.
  • Opcja języka auto używa wbudowanego wykrywania języka whisper. Jawne wskazanie języka poprawia dokładność i szybkość.
  • SRT jest najszerzej obsługiwanym formatem napisów. VTT (WebVTT) to standard dla internetowych odtwarzaczy wideo.
  • Aktualizacje postępu są dostępne przez SSE pod GET /api/v1/jobs/{jobId}/progress do momentu zakończenia zadania.