/start-15-1.es

description: "Lesson command"
chapter: "courses/aiagent/lesson03-core/module15-video"
duration: "~30 min"
prerequisites: ["start-0-3"]
level: "intermediate"
tags: ["video", "keyframe", "analysis", "ffmpeg"]
nonInteractiveMode: deferred

Lección 15-1: Análisis de Fotogramas de Video

Lo Que Hará en Esta Sesión

Bienvenido a **Lección 15-1: Análisis de Fotogramas de Video**!

| Elemento | Detalles | |----------|----------| | Objetivo | Extraer fotogramas clave de un video, analizar el contenido y crear un informe resumen | | Duración | ~30 min | | Habilidades utilizadas | video-frame-reader (FFmpeg, Gemini Visión API) | | Requisitos previos | FFmpeg, Python 3.9+, y clave API de Gemini configurada | | Página del curso | Consulte [Module 15: Generación de Video](https://ai-agent.camp/es/course/module-15) en paralelo |

**Flujo de la sesión:** 1. Verificar el entorno 2. Preparar el video de muestra 3. Extraer y analizar fotogramas clave 4. Crear un informe resumen del video

Al finalizar esta sesión, los fotogramas clave y el resumen estaran guardados en los outputs.

> **Consejo**: Si la respuesta de la IA se detiene a mitad, escriba "por favor continue" para reanudar.

---

Verificación de Preparación

Primero, confirme que todo está listo.

**Configuración de AskQuestion:**

{
  "title": "Verificacion previa a la sesion",
  "questions": [{
    "id": "readiness",
    "prompt": "Esta listo?",
    "options": [
      {"id": "ready", "label": "Listo! Comencemos"},
      {"id": "check_prereq", "label": "Quiero verificar los requisitos previos"},
      {"id": "view_html", "label": "Quiero ver la pagina del curso primero"},
      {"id": "different_lesson", "label": "Quiero ir a otra leccion"}
    ]
  }]
}

(ready -> Ir al Paso 1) (check_prereq -> Ejecutar verificación de requisitos previos) (view_html -> Mostrar la ruta de la página del curso) (different_lesson -> Mostrar lista de modulos)

---

Paso 0: Preparar un Video de Prueba

Use el video de muestra incluido primero. Solo agregue un video de práctica con FFmpeg si no tiene uno.

# Crear el directorio data bajo lesson (si es necesario)
mkdir -p courses/aiagent/lesson03-core/module15-video/practice/data/videos

# Generar un video de prueba con FFmpeg (10 segundos, 640x480, 30fps):
ffmpeg -f lavfi -i testsrc=duration=10:size=640x480:rate=30 -pix_fmt yuv420p courses/aiagent/lesson03-core/module15-video/practice/data/videos/module15-lesson1-sample.mp4

> **Nota**: Si FFmpeg no está instalado, la verificación del entorno en el Paso 1 le guiará.

---

Paso 1: Verificar el Entorno

**Configuración de AskQuestion:**

{
  "title": "Paso 1: Verificar el entorno",
  "questions": [{
    "id": "step_action",
    "prompt": "Que desea hacer con este paso?",
    "options": [
      {"id": "practice", "label": "Continuar"},
      {"id": "review", "label": "Solo revisar ejemplos"},
      {"id": "skip", "label": "Omitir"}
    ]
  }]
}

**Instrucciones (ejemplo)**: Entrada:

Verifique el entorno necesario para la extraccion de fotogramas de video:
- Esta instalado FFmpeg?
- Esta instalado Python 3.9+?
- Esta disponible la habilidad video-frame-reader?

Si falta algo, muestre los pasos de instalacion.

**Resultado esperado**: Se verifica el entorno requerido y se muestran los pasos de instalación si falta algo.

---

Paso 2: Preparar Video de Muestra

**Configuración de AskQuestion:**

{
  "title": "Paso 2: Preparar video de muestra",
  "questions": [{
    "id": "step_action",
    "prompt": "Que desea hacer con este paso?",
    "options": [
      {"id": "practice", "label": "Continuar"},
      {"id": "review", "label": "Solo revisar ejemplos"},
      {"id": "skip", "label": "Omitir"}
    ]
  }]
}

**Instrucciones (ejemplo)**: Entrada:

Para las pruebas de extraccion de fotogramas, verifique lo siguiente:
1. Existe la carpeta `courses/aiagent/lesson03-core/module15-video/practice/data/videos/`
2. Se puede usar el ejemplo oficial `data/videos/module7-lesson1-frame-lab-sample.mp4` o `courses/aiagent/lesson03-core/module15-video/practice/data/videos/module15-lesson1-sample.mp4`

Si desea probar con otro video, puede colocar un MP4 de 30 segundos o menos en `courses/aiagent/lesson03-core/module15-video/practice/data/videos/`.

**Resultado esperado**: Los videos de prueba están listos y las rutas confirmadas.

---

Paso 3: Extraer Fotogramas Clave

**Configuración de AskQuestion:**

{
  "title": "Paso 3: Extraer fotogramas clave",
  "questions": [{
    "id": "step_action",
    "prompt": "Que desea hacer con este paso?",
    "options": [
      {"id": "practice", "label": "Continuar"},
      {"id": "review", "label": "Solo revisar ejemplos"},
      {"id": "skip", "label": "Omitir"}
    ]
  }]
}

**Instrucciones (ejemplo)**: Entrada:

Extraiga fotogramas clave de data/videos/module7-lesson1-frame-lab-sample.mp4 o
courses/aiagent/lesson03-core/module15-video/practice/data/videos/module15-lesson1-sample.mp4
(usando extract_keyframes.py de video-frame-reader).

Configuracion:
- Intervalo de extraccion: cada 5 segundos (o valor predeterminado de la habilidad)
- Formato de salida: segun la habilidad (PNG, etc.)
- Ruta de salida: data/frames/ u otra ruta clara

Despues de la extraccion, muestre la lista de imagenes de fotogramas generadas.

**Resultado esperado**: Los fotogramas clave se guardan como PNG en el intervalo especificado.

---

Paso 4: Analizar los Fotogramas Extraidos

**Configuración de AskQuestion:**

{
  "title": "Paso 4: Analizar los fotogramas extraidos",
  "questions": [{
    "id": "step_action",
    "prompt": "Que desea hacer con este paso?",
    "options": [
      {"id": "practice", "label": "Continuar"},
      {"id": "review", "label": "Solo revisar ejemplos"},
      {"id": "skip", "label": "Omitir"}
    ]
  }]
}

**Instrucciones (ejemplo)**: Entrada:

Analice las imagenes de fotogramas extraidas:

Para cada imagen en data/frames/, propor