REST API + MCP Server

Sviluppa con Video Intelligence

Due modi per integrare: un'API REST completa per applicazioni personalizzate e un server MCP perché gli assistenti AI possano lavorare con i tuoi video nativamente.

Riferimento APIOttieni chiave API
REST API

Controllo programmatico completo

Un'API RESTful completa che copre l'intero ciclo di vita del video — dall'upload e codifica all'analisi AI, trascrizione, ricerca e gestione del team.

Upload e Importazione

Importa video da YouTube o carica direttamente tramite URL S3 pre-firmate. La codifica avviene automaticamente in background.

Analisi AI

Invia video per l'analisi AI — genera capitoli, rileva scene, estrai entità e produci riassunti dettagliati.

Trascrizione

Trascrivi l'audio con Whisper, poi traduci in oltre 100 lingue. Supporto completo per sottotitoli multilingue incluso.

Ricerca e Chat

Ricerca ibrida semantica + keyword nella tua libreria. Abilita la chat AI basata su RAG per singoli video o l'intera collezione.

Embeddings

Genera embeddings vettoriali dai dati di analisi e trascrizione per alimentare la ricerca semantica e la chat AI basata su RAG.

Organizzazioni

Gestisci i team con accesso basato sui ruoli, isolamento dei dati tra gruppi e flussi di invito — tutto tramite 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"}'
Server MCP

I tuoi video in qualsiasi assistente AI

Coniviso espone un server Model Context Protocol (MCP) cosicché assistenti AI come Claude, Cursor e agenti personalizzati possano accedere alla tua libreria video, cercare contenuti, leggere trascrizioni e avviare analisi — il tutto tramite l'interfaccia MCP standard.

Cos'è MCP?

Il Model Context Protocol è uno standard aperto che permette ai modelli AI di interagire in modo sicuro con strumenti e sorgenti dati esterni. Invece di scrivere integrazioni personalizzate, qualsiasi client AI compatibile con MCP può connettersi a Coniviso e utilizzare immediatamente i tuoi video come contesto.

21 strumenti disponibili

Ogni strumento è limitato ai permessi della tua chiave API. Il tuo assistente AI può elencare, cercare, aggiornare e eliminare video, gestire organizzazioni, gruppi, permessi e visibilità, recuperare analisi e trascrizioni, chattare con video singoli o con l'intera libreria, generare embeddings e inviare nuovi lavori di analisi — tutto senza lasciare la conversazione.

  • list_videosSfoglia la tua libreria video con paginazione e filtri di stato
  • get_videoOttieni metadati completi, stato di elaborazione e configurazione di qualsiasi video
  • search_videosRicerca ibrida semantica + keyword in tutti i video accessibili
  • chat_with_libraryFai domande sull'intera collezione video usando RAG
  • chat_with_videoQ&A su un video specifico con supporto per conversazioni multi-turno
  • get_analysisRecupera risultati dell'analisi AI: riassunti, capitoli, scene, entità
  • get_transcriptionOttieni dati di trascrizione, opzionalmente filtrati per lingua
  • analyze_videoInvia un video per l'analisi AI (completa, scene, oggetti o testo)
  • generate_embeddingsCrea embeddings vettoriali dai dati di analisi e trascrizione per la ricerca semantica
  • update_videoAggiorna titolo, descrizione, visibilità o organizzazione di un video
  • delete_videoElimina permanentemente un video e tutti i dati associati
  • get_permissionsElenca tutti i permessi di accesso concessi su un video
  • grant_permissionConcedi l'accesso a un utente, gruppo o organizzazione su un video
  • revoke_permissionRevoca un permesso di accesso precedentemente concesso su un video
  • list_organizationsRestituisce un elenco delle organizzazioni a cui appartieni
  • get_organizationRestituisce i dettagli di un'organizzazione specifica
  • list_org_membersRestituisce tutti i membri di un'organizzazione
  • invite_org_memberInvita un membro in un'organizzazione
  • remove_org_memberRimuove un membro da un'organizzazione
  • list_org_groupsElenca tutti i gruppi all'interno di un'organizzazione
  • list_group_membersElenca tutti i membri di un gruppo specifico all'interno di un'organizzazione

8 risorse

Le risorse MCP danno agli assistenti AI accesso diretto ai tuoi dati video come contesto strutturato:

  • coniviso://videosLista completa di tutti i video accessibili con metadati
  • coniviso://video/:idDettaglio completo del video inclusi analisi e trascrizione
  • coniviso://video/:id/transcriptionDati di trascrizione completi per un video specifico
  • coniviso://video/:id/analysisRisultati dell'analisi AI: riepilogo, capitoli, scene, entità
  • coniviso://video/:id/permissionsLista di controllo accessi con permessi concessi
  • coniviso://organizationsElenco di tutte le organizzazioni a cui appartieni
  • coniviso://organization/:idDettagli dell'organizzazione ed elenco dei suoi membri
  • coniviso://organization/:id/groupsElenco di tutti i gruppi all'interno di un'organizzazione

Connettiti in 30 secondi

Aggiungi Coniviso a qualsiasi client MCP con un singolo blocco di configurazione. Usa la tua chiave API esistente per l'autenticazione.

Endpointhttps://www.coniviso.com/mcp
AutenticazioneBearer vi_live_...
TrasportoStreamable HTTP (JSON-RPC su HTTP)

Ogni sessione ottiene la propria istanza server isolata. Le sessioni sono identificate dall'header mcp-session-id.

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

Operativo in pochi minuti

1. Crea una chiave API

Vai su Impostazioni → Chiavi API nella tua dashboard Coniviso. Le chiavi API seguono il formato vi_live_* e possono avere permessi granulari.

2. Autentica le richieste

Includi la tua chiave API come token Bearer nell'header Authorization. Funziona sia per le chiamate REST API che per le connessioni MCP.

3. Inizia a sviluppare

Usa la REST API da qualsiasi linguaggio o connetti il server MCP al tuo assistente AI. Entrambi condividono la stessa chiave API e gli stessi permessi.

Permessi disponibili

  • videos:readElenca e leggi i metadati dei video
  • videos:writeCarica, aggiorna ed elimina video
  • analysisInvia e leggi risultati dell'analisi AI
  • searchCerca nei contenuti video
  • chatUsa le funzionalità di chat AI (per video e libreria)
  • embeddingsGenera e gestisci embeddings vettoriali

Pronto per l'integrazione?

Inizia a sviluppare con l'API Coniviso e il server MCP. Il piano gratuito include 60 minuti di elaborazione AI.

Ottieni la tua chiave APILeggi la documentazione