Files
SnapOtter/apps/docs/it/tools/video/embed-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

1.7 KiB

description, i18n_source_hash, i18n_provenance, i18n_output_hash
description i18n_source_hash i18n_provenance i18n_output_hash
Effettua il mux di una traccia di sottotitoli nel contenitore video. be272730fff5 human 007bfde593fa

Embed Subtitles

Effettua il mux di un file di sottotitoli nel contenitore video come traccia di sottotitoli soft che gli spettatori possono attivare o disattivare.

API Endpoint

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

Accetta dati form multipart con un file video e un file di sottotitoli, più un campo JSON settings.

Parameters

Parameter Type Required Default Description
language string No "eng" Codice lingua ISO 639-2/B (3 lettere minuscole, ad es. "eng", "fra", "deu")

Example Request

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

Example Response

{
  "jobId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "downloadUrl": "/api/v1/download/a1b2c3d4-e5f6-7890-abcd-ef1234567890/clip.mp4",
  "originalSize": 12500000,
  "processedSize": 12520000
}

Notes

  • Carica due file: il primo deve essere un video, il secondo deve essere un file di sottotitoli (.srt, .vtt o .ass).
  • I sottotitoli incorporati (soft) possono essere attivati e disattivati dallo spettatore nel proprio lettore multimediale. Per sottotitoli sempre visibili, usa invece lo strumento Burn Subtitles.
  • Il codice lingua viene memorizzato come metadato nel contenitore e aiuta i lettori multimediali a etichettare la traccia dei sottotitoli.