API de videos de ejercicios: quién ofrece GIF o video

En la práctica, el término cubre una gama muy amplia de productos muy distintos. Las API REST orientadas a desarrolladores en este espacio suelen devolver hechos estructurados sobre un ejercicio (nombre, parte del cuerpo, músculo objetivo, equipo, a veces MET o dificultad) y, o bien nada visual, o un enlace a una imagen estática o un GIF animado. El video real, es decir un archivo de video de verdad o un formato en streaming como MP4 o HLS con una línea de tiempo navegable y narración opcional, es una categoría de producto distinta: aparece en plataformas de pago de cursos en video y reproductores de entrenamiento integrados en apps, no en la mayoría de las API REST de metadatos de ejercicios. Si un resultado de búsqueda promete una "api de videos de ejercicios", lee su esquema de respuesta antes de asumir que entrega archivos MP4; con más frecuencia entrega un enlace a un GIF o nada visual en absoluto.

Los dos formatos resuelven problemas distintos y cuestan cantidades diferentes de esfuerzo de ingeniería. Un GIF animado se reproduce en bucle automáticamente, no lleva pista de audio, y la mayoría de los frameworks lo renderizan con una simple etiqueta <img>, lo cual es trivial de incluir en una tarjeta o un modal. Un archivo de video real soporta barra de progreso, velocidad de reproducción variable, narración, y bitrate adaptativo para conexiones lentas, pero necesita un componente de reproductor de video adecuado y, si quieres subtítulos o varios idiomas, un pipeline de assets más complejo. Si tu producto solo necesita una demostración corta, silenciosa y en bucle de un movimiento, un GIF suele ser suficiente y más barato de integrar. Si necesita un recorrido narrado y guiado, un GIF no puede cumplir esa función, sin importar qué API elijas.

Ninguno de los dos está incrustado en la API de metadatos. GET /v1/exercises/{id} devuelve hechos (bodyPart, target, equipment, MET, instructions) y un enlace HATEOAS, _links.marketplacePreview.href, que apunta a /marketplace/preview/{id}.gif, una vista previa pública con marca de agua del mismo ejercicio. El GIF limpio, sin marca de agua, es una compra aparte en el mercado, a $0.99 por ejercicio con descuentos por volumen en lotes por parte del cuerpo, equipo o músculo objetivo. No hay ningún archivo de video (MP4) en FitExerciseDB. Consulta el artículo relacionado sobre cómo funciona el mercado de GIFs para precios, paquetes y licencia, y la guía de todos los campos de la respuesta de un ejercicio para ver exactamente qué devuelve la API.

La cobertura y los derechos varían mucho según la fuente, así que es algo a verificar proyecto por proyecto, no una suposición segura. Algunos datasets de ejercicios comunitarios o de código abierto, siendo el proyecto Wger un ejemplo conocido, publican imágenes o GIFs de ejercicios bajo una licencia Creative Commons o similar de tipo permisivo, lo cual es útil para prototipar pero igual requiere leer los términos exactos de la licencia para uso comercial o redistribución. Las colecciones de GIFs obtenidas por scraping que circulan sin fuente declarada rara vez vienen con derechos de redistribución comercial verificados, incluso cuando son técnicamente descargables; asumir que un asset es seguro de usar en un producto de pago solo porque está alojado públicamente en algún sitio es el error de licencia más común en este espacio.

• ¿El cuerpo de la respuesta realmente incluye un campo video o gif, o solo un enlace aparte en otro lugar?
• ¿El recurso visual es un archivo de video real (MP4/HLS) o un GIF animado en bucle, y eso coincide con lo que tu interfaz realmente necesita?
• ¿La licencia está limitada por proyecto, por asiento, o es ilimitada, y permite la redistribución como dataset?
• ¿El precio de los recursos visuales está incluido en tu cuota de API, o se factura aparte por asset o por lote?
• ¿Una vista previa gratuita y una versión limpia de pago son endpoints distintos, y la vista previa gratuita es suficiente para evaluar la calidad antes de pagar?