REST API + MCP Server

Desarrolla con Video Intelligence

Dos formas de integrar: una API REST completa para aplicaciones personalizadas y un servidor MCP para que los asistentes de IA trabajen con tus videos de forma nativa.

Referencia APIObtener clave API
REST API

Control programático completo

Una API RESTful integral que cubre todo el ciclo de vida del video — desde la carga y codificación hasta el análisis IA, transcripción, búsqueda y gestión de equipos.

Carga e importación

Importa videos desde YouTube o carga directamente mediante URLs S3 prefirmadas. La codificación ocurre automáticamente en segundo plano.

Análisis IA

Envía videos para análisis con IA — genera capítulos, detecta escenas, extrae entidades y produce resúmenes detallados.

Transcripción

Transcribe audio con Whisper y luego traduce a más de 100 idiomas. Soporte completo de subtítulos multilingües incluido.

Búsqueda y Chat

Búsqueda híbrida semántica + palabras clave en tu biblioteca. Habilita chat IA basado en RAG para videos individuales o toda la colección.

Embeddings

Genera embeddings vectoriales a partir de datos de análisis y transcripción para potenciar la búsqueda semántica y el chat IA basado en RAG.

Organizaciones

Gestiona equipos con acceso basado en roles, aislamiento de datos entre grupos y flujos de invitación — todo vía API.

bash
curl -X POST "https://www.coniviso.com/api/v1/videos/{id}/analyze" \
  -H "Authorization: Bearer vi_live_..." \
  -H "Content-Type: application/json" \
  -d '{"analysisType": "comprehensive"}'
Servidor MCP

Tus videos en cualquier asistente IA

Coniviso expone un servidor Model Context Protocol (MCP) para que asistentes IA como Claude, Cursor y agentes personalizados accedan a tu biblioteca de videos, busquen contenido, lean transcripciones y ejecuten análisis — todo a través de la interfaz MCP estándar.

¿Qué es MCP?

El Model Context Protocol es un estándar abierto que permite a los modelos de IA interactuar de forma segura con herramientas y fuentes de datos externas. En lugar de escribir integraciones personalizadas, cualquier cliente IA compatible con MCP puede conectarse a Coniviso y usar inmediatamente tus videos como contexto.

21 herramientas disponibles

Cada herramienta está limitada a los permisos de tu clave API. Tu asistente IA puede listar, buscar, actualizar y eliminar videos, gestionar organizaciones, grupos, permisos y visibilidad, recuperar análisis y transcripciones, chatear con videos individuales o toda tu biblioteca, generar embeddings y enviar nuevos trabajos de análisis — todo sin salir de la conversación.

  • list_videosExplora tu biblioteca de videos con paginación y filtros de estado
  • get_videoObtén metadatos completos, estado de procesamiento y configuración de cualquier video
  • search_videosBúsqueda híbrida semántica + palabras clave en todos los videos accesibles
  • chat_with_libraryHaz preguntas sobre toda tu colección de videos usando RAG
  • chat_with_videoPreguntas y respuestas sobre un video específico con soporte de conversación multi-turno
  • get_analysisRecupera resultados de análisis IA: resúmenes, capítulos, escenas, entidades
  • get_transcriptionObtén datos de transcripción, opcionalmente filtrados por idioma
  • analyze_videoEnvía un video para análisis IA (completo, escenas, objetos o texto)
  • generate_embeddingsCrear embeddings vectoriales a partir de datos de análisis y transcripción para búsqueda semántica
  • update_videoActualizar título, descripción, visibilidad u organización de un video
  • delete_videoEliminar permanentemente un video y todos sus datos asociados
  • get_permissionsListar todos los permisos de acceso otorgados en un video
  • grant_permissionConceder acceso a un usuario, grupo u organización en un video
  • revoke_permissionRevocar un permiso de acceso previamente otorgado en un video
  • list_organizationsDevuelve una lista de las organizaciones a las que perteneces
  • get_organizationDevuelve detalles de una organización específica
  • list_org_membersDevuelve todos los miembros de una organización
  • invite_org_memberInvitar a un miembro a una organización
  • remove_org_memberEliminar a un miembro de una organización
  • list_org_groupsListar todos los grupos dentro de una organización
  • list_group_membersListar todos los miembros de un grupo específico dentro de una organización

8 recursos

Los recursos MCP dan a los asistentes IA acceso directo a tus datos de video como contexto estructurado:

  • coniviso://videosLista completa de todos los videos accesibles con metadatos
  • coniviso://video/:idDetalle completo del video incluyendo análisis y transcripción
  • coniviso://video/:id/transcriptionDatos de transcripción completos para un video específico
  • coniviso://video/:id/analysisResultados del análisis IA: resumen, capítulos, escenas, entidades
  • coniviso://video/:id/permissionsLista de control de acceso con permisos otorgados
  • coniviso://organizationsLista de todas las organizaciones a las que perteneces
  • coniviso://organization/:idDetalles de la organización y lista de sus miembros
  • coniviso://organization/:id/groupsLista de todos los grupos dentro de una organización

Conéctate en 30 segundos

Añade Coniviso a cualquier cliente MCP con un solo bloque de configuración. Usa tu clave API existente para autenticación.

Endpointhttps://www.coniviso.com/mcp
AutenticaciónBearer vi_live_...
TransporteStreamable HTTP (JSON-RPC sobre HTTP)

Cada sesión obtiene su propia instancia de servidor aislada. Las sesiones se identifican por el encabezado mcp-session-id.

mcp config
{
  "mcpServers": {
    "coniviso": {
      "url": "https://www.coniviso.com/mcp",
      "headers": {
        "Authorization": "Bearer vi_live_..."
      }
    }
  }
}
Primeros pasos

En funcionamiento en minutos

1. Crea una clave API

Ve a Configuración → Claves API en tu panel de Coniviso. Las claves API siguen el formato vi_live_* y pueden tener permisos granulares.

2. Autentica las solicitudes

Incluye tu clave API como token Bearer en el encabezado Authorization. Funciona tanto para llamadas REST API como para conexiones MCP.

3. Empieza a desarrollar

Usa la REST API desde cualquier lenguaje o conecta el servidor MCP a tu asistente IA. Ambos comparten la misma clave API y permisos.

Permisos disponibles

  • videos:readListar y leer metadatos de video
  • videos:writeSubir, actualizar y eliminar videos
  • analysisEnviar y leer resultados de análisis IA
  • searchBuscar en el contenido de video
  • chatUsar funciones de chat IA (por video y biblioteca)
  • embeddingsGenerar y gestionar embeddings vectoriales

¿Listo para integrar?

Empieza a desarrollar con la API de Coniviso y el servidor MCP. El plan gratuito incluye 60 minutos de procesamiento IA.

Obtén tu clave APILeer la documentación