Documentación

Todo lo que necesitas saber sobre el uso de la plataforma de análisis de vídeo de PitchView AI

Guías

Ayuda paso a paso para cada parte de PitchView AI, basada en cómo funciona hoy el portal.

Primeros pasos

Guía de inicio rápido

Del registro a tu primera línea de tiempo de eventos en cinco pasos:

  1. Crea una cuenta en el portal e inicia sesión.
  2. Abre Analyze y elige una fuente: un enlace de YouTube, la URL directa de un vídeo o un archivo de tu ordenador.
  3. Selecciona el deporte, o deja que la detección automática lo elija para un enlace de YouTube.
  4. Si quieres, elige el equipo A y el equipo B entre tus equipos: los nombres de los equipos mejoran la precisión.
  5. Inicia el análisis, sigue su progreso en directo y abre los resultados desde History.

Configuración de la cuenta

Regístrate en el portal de PitchView AI con tu correo electrónico y una contraseña, y después inicia sesión. Tu perfil muestra cuánto tiempo llevas como miembro y el total de tus análisis y de los eventos detectados.

Antes de tu primer análisis, añade los equipos con los que trabajas en la página Teams. Al iniciar un análisis podrás buscarlos y seleccionarlos como equipo A y equipo B, para que los eventos se asignen al lado correcto.

Si quieres que la IA siga tus propias instrucciones, crea un prompt personalizado en la página Prompts.

Primer análisis de vídeo

En la página Analyze, elige el tipo de fuente. Para un enlace de YouTube también puedes elegir la calidad de vídeo. Después selecciona el deporte y, si quieres, los equipos y el prompt.

Una vez iniciado, el análisis pasa por etapas claras: descarga del vídeo, extracción de los metadatos, subida al almacenamiento en la nube y análisis con IA. Un vídeo típico termina en 2 a 5 minutos.

Para partidos completos, usa Parallel: divide el vídeo en segmentos y analiza varios a la vez (tres por defecto), así los vídeos largos terminan mucho antes.

Leer más

Entender los resultados

Cada resultado es una línea de tiempo de eventos. Cada evento tiene una marca de tiempo, un tipo (por ejemplo gol, falta o córner), una descripción, el equipo implicado y su origen: IA o manual.

Haz clic en cualquier marca de tiempo para saltar a ese momento del vídeo. Puedes buscar eventos y filtrarlos por tipo, estado de revisión y equipo.

Tú controlas los datos: marca cada evento como Correct, Wrong, Uncertain, Partial o Duplicate (los eventos nuevos empiezan en Pending) con un comentario opcional, edita o elimina eventos, añade los que la IA no detectó o vuelve a ejecutar todo el análisis con Reanalyze.

Subida de vídeo

Formatos compatibles

Puedes subir archivos MP4, MOV, AVI, MKV y WebM. Cualquier otro tipo de archivo se rechaza con un mensaje que indica los formatos aceptados.

No es necesario subir nada: pega un enlace de YouTube o un enlace directo a un archivo de vídeo y PitchView AI obtiene el vídeo por ti.

Integración con YouTube

Pega un enlace de YouTube en la página Analyze. PitchView AI lee las calidades disponibles del vídeo para que elijas una, y puede detectar el deporte automáticamente a partir del vídeo.

El vídeo se descarga y se guarda en el almacenamiento en la nube para el análisis, por lo que volver a analizar el mismo vídeo es más rápido.

Solo se pueden analizar vídeos a los que PitchView AI tiene acceso: los vídeos privados o eliminados no se pueden descargar.

Límites de tamaño

Cada archivo subido puede tener hasta 500 MB.

Si tu grabación es más grande, analízala desde un enlace de YouTube o una URL directa en lugar de subir el archivo, y usa Parallel para partidos completos.

Solución de problemas de subida

La mayoría de los problemas de subida tienen una solución rápida:

  • Tipo de archivo no válido: convierte el vídeo a MP4, MOV, AVI, MKV o WebM.
  • Archivo demasiado grande: los archivos de más de 500 MB se rechazan; comprime o recorta el vídeo, o usa un enlace.
  • No cargan las calidades de un enlace de YouTube: comprueba que el enlace es correcto y que el vídeo es público, y vuelve a intentarlo.
  • ¿Sigues con problemas? Contacta con soporte indicando el ID del análisis que aparece en History y lo revisaremos.

Análisis con IA

Cómo funciona

PitchView AI envía tu vídeo a los modelos multimodales Google Gemini junto con un prompt escrito para el deporte seleccionado. El modelo ve el vídeo y devuelve los eventos que encuentra, cada uno con marca de tiempo, tipo, descripción y equipo.

Los eventos se guardan con el análisis, así que puedes revisarlos, corregirlos y exportarlos. Los vídeos largos pueden dividirse en segmentos que se analizan en paralelo.

Leer más

Prompts personalizados

El prompt le dice a la IA qué debe buscar. PitchView AI incluye plantillas de prompts del sistema para cada deporte, y en la página Prompts puedes crear las tuyas: ponle un nombre, escribe las instrucciones y úsalo en tus próximos análisis.

Los prompts personalizados son útiles cuando te interesan momentos concretos, por ejemplo solo las jugadas a balón parado o las acciones de un jugador determinado.

Ajustes del LLM

Los usuarios avanzados pueden ajustar el modelo de IA desde la página Prompts. Sin ajustes personalizados, los análisis usan la configuración por defecto, y la configuración utilizada se muestra en cada análisis en History.

  • Modelo: se elige entre los modelos Gemini disponibles; Flash es más rápido y económico, Pro ofrece mayor calidad.
  • Temperatura: controla la aleatoriedad, de 0,0 a 2,0; los valores bajos dan resultados más consistentes.
  • Top-P y Top-K: limitan qué tokens considera el modelo en cada paso.
  • Máximo de tokens de salida: la longitud máxima de la respuesta del modelo.

Precisión y confianza

La detección con IA es potente pero no perfecta: puede pasar por alto un evento, interpretar mal otro o registrar dos veces el mismo momento. Por eso cada evento se puede revisar.

Obtendrás los resultados más precisos eligiendo el deporte correcto, añadiendo los nombres de ambos equipos, usando un vídeo nítido y de buena calidad y manteniendo prompts concretos.

Los estados de revisión (Correct, Wrong, Uncertain, Partial y Duplicate) te dan un registro claro de la fiabilidad de cada análisis y se incluyen al exportar.

Funciones

Progreso en tiempo real

Mientras se analiza un vídeo, ves cada etapa actualizarse en directo (descarga, metadatos, subida a la nube y análisis con IA) sin recargar la página.

Para partidos retransmitidos en directo con PitchView, Stream analiza la emisión mientras se reproduce: tú defines la ventana de análisis en segundos y el número máximo de minutos, y los eventos detectados aparecen en Live events a medida que avanza el partido.

Historial de análisis

Cada análisis se guarda en History, junto con el total de análisis y eventos y el deporte que más analizas.

Busca por equipo, ID o contenido, filtra por deporte y estado, abre cualquier análisis para revisar sus eventos, vuelve a ejecutarlo con Reanalyze o elimina los análisis que ya no necesites.

Cronología de eventos

Dentro de un análisis, los eventos aparecen en orden cronológico. Haz clic en una marca de tiempo para ir directamente a ese momento del vídeo.

Busca eventos por tipo, descripción o equipo, fíltralos por tipo, estado y equipo, y añade un evento manual en cualquier momento: los eventos manuales están etiquetados para distinguirlos de los de la IA.

Exportar y compartir

Usa Export en cualquier análisis para descargar sus eventos en un archivo de Excel (.xlsx).

Cada fila incluye la hora, el tiempo en segundos, el tipo de evento, la descripción, el equipo, el origen (IA o manual), el estado de revisión, cuándo y quién cambió el estado, y el ID del evento: listo para compartir con entrenadores y analistas o para cargar en tus propias herramientas.

Referencia de la API

Referencia de la API

El acceso a la API está incluido en los planes que lo indican en la página de precios.

Los datos de autenticación, la referencia de endpoints, los límites de uso y los ejemplos de código se proporcionan cuando se activa el acceso a la API en tu cuenta. Contáctanos para empezar.

Contactar con soporte

Preguntas frecuentes

¿Qué formatos de vídeo son compatibles?

Admitimos los formatos MP4, AVI, MOV, MKV y WEBM. El tamaño máximo es de 5 GB por vídeo.

¿Cuánto tarda el análisis?

El análisis suele tardar de 2 a 5 minutos según la duración y complejidad del vídeo. Puedes ver el progreso en tiempo real.

¿Puedo analizar vídeos de YouTube privados/no listados?

Sí, puedes analizar cualquier vídeo de YouTube siempre que tengas el enlace, incluidos los vídeos no listados.

¿Qué precisión tiene el análisis con IA?

Nuestra IA alcanza una precisión del 99 % en la detección de eventos en todos los deportes compatibles, mejorando continuamente mediante aprendizaje automático.

¿Puedo personalizar el prompt de análisis?

¡Sí! Puedes crear prompts personalizados y configurar los ajustes del LLM para adaptar el análisis a tus necesidades.

¿Aún tienes preguntas? ¡Estamos aquí para ayudarte!

← Volver al inicio
Documentación — PitchView AI