Files
SnapOtter/apps/docs/es/tools/video/video-to-frames.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
Extrae fotogramas de un vídeo como un ZIP de imágenes. b06f038dafb3 human 96639415435f

Video to Frames

Extrae fotogramas individuales de un vídeo y descárgalos como un archivo ZIP de imágenes PNG o JPG.

API Endpoint

POST /api/v1/tools/video/video-to-frames

Acepta datos de formulario multipart con un archivo de vídeo y un campo JSON settings.

Parameters

Parameter Type Required Default Description
mode string No "all" Modo de extracción: all, nth, timestamps
n integer No 10 Extraer cada N-ésimo fotograma (2-1000). Solo se usa cuando el modo es "nth"
timestamps string No "" Marcas de tiempo en segundos separadas por comas. Obligatorio cuando el modo es "timestamps"
format string No "png" Formato de imagen para los fotogramas extraídos: png, jpg

Example Request

Extraer cada 30º fotograma como JPG:

curl -X POST http://localhost:1349/api/v1/tools/video/video-to-frames \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"mode": "nth", "n": 30, "format": "jpg"}'

Extraer fotogramas en marcas de tiempo específicas:

curl -X POST http://localhost:1349/api/v1/tools/video/video-to-frames \
  -H "Authorization: Bearer si_your-api-key" \
  -F "file=@clip.mp4" \
  -F 'settings={"mode": "timestamps", "timestamps": "1.5,5,12.3"}'

Example Response

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

Notes

  • El modo all extrae cada fotograma y puede producir archivos ZIP muy grandes para vídeos largos. Usa el modo nth o timestamps para una extracción selectiva.
  • PNG conserva toda la calidad pero produce archivos más grandes. JPG es más pequeño pero con pérdida.
  • La respuesta se descarga como un archivo ZIP que contiene archivos de imagen numerados secuencialmente.