REST API + MCP Server

Bouw met Video Intelligence

Twee manieren om te integreren: een volledige REST API voor aangepaste applicaties en een MCP-server zodat AI-assistenten native met je video's kunnen werken.

API ReferentieAPI-sleutel ophalen
REST API

Volledige programmatische controle

Een uitgebreide RESTful API die de volledige videolevenscyclus omvat — van upload en encoding tot AI-analyse, transcriptie, zoeken en teambeheer.

Upload en import

Importeer video's van YouTube of upload direct via vooraf ondertekende S3-URL's. Encoding gebeurt automatisch op de achtergrond.

AI-analyse

Dien video's in voor AI-analyse — genereer hoofdstukken, detecteer scènes, extraheer entiteiten en produceer gedetailleerde samenvattingen.

Transcriptie

Transcribeer audio met Whisper en vertaal naar meer dan 100 talen. Volledige meertalige ondertitelondersteuning inbegrepen.

Zoeken en Chat

Hybride semantisch + trefwoord zoeken in je bibliotheek. Schakel RAG-gebaseerde AI-chat in voor individuele video's of de hele collectie.

Embeddings

Genereer vectorembeddings uit analyse- en transcriptiegegevens om semantisch zoeken en RAG-gebaseerde AI-chat aan te sturen.

Organisaties

Beheer teams met rolgebaseerde toegang, data-isolatie tussen groepen en uitnodigingsflows — alles via 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"}'
MCP-server

Je video's in elke AI-assistent

Coniviso biedt een Model Context Protocol (MCP) server zodat AI-assistenten zoals Claude, Cursor en aangepaste agents toegang krijgen tot je videobibliotheek, content doorzoeken, transcripties lezen en analyses starten — allemaal via de standaard MCP-interface.

Wat is MCP?

Het Model Context Protocol is een open standaard die AI-modellen in staat stelt veilig te communiceren met externe tools en databronnen. In plaats van aangepaste integraties te schrijven, kan elke MCP-compatibele AI-client verbinding maken met Coniviso en direct je video's als context gebruiken.

21 beschikbare tools

Elke tool is beperkt tot de machtigingen van je API-sleutel. Je AI-assistent kan video's opsommen, zoeken, bijwerken en verwijderen, organisaties, groepen, machtigingen en zichtbaarheid beheren, analyses en transcripties ophalen, chatten met individuele video's of je hele bibliotheek, embeddings genereren en nieuwe analyseopdrachten indienen — allemaal zonder het gesprek te verlaten.

  • list_videosBlader door je videobibliotheek met paginering en statusfilters
  • get_videoVerkrijg volledige metadata, verwerkingsstatus en configuratie van elke video
  • search_videosHybride semantisch + trefwoord zoeken in alle toegankelijke video's
  • chat_with_libraryStel vragen over je hele videocollectie met RAG
  • chat_with_videoQ&A over een specifieke video met multi-turn gespreksondersteuning
  • get_analysisHaal AI-analyseresultaten op: samenvattingen, hoofdstukken, scènes, entiteiten
  • get_transcriptionHaal transcriptiegegevens op, optioneel gefilterd op taal
  • analyze_videoDien een video in voor AI-analyse (uitgebreid, scènes, objecten of tekst)
  • generate_embeddingsVectorembeddings aanmaken uit analyse- en transcriptiegegevens voor semantisch zoeken
  • update_videoTitel, beschrijving, zichtbaarheid of organisatie van een video bijwerken
  • delete_videoEen video en alle bijbehorende gegevens permanent verwijderen
  • get_permissionsAlle verleende toegangsmachtigingen op een video weergeven
  • grant_permissionEen gebruiker, groep of organisatie toegang verlenen tot een video
  • revoke_permissionEen eerder verleende toegangsmachtiging van een video intrekken
  • list_organizationsGeeft een lijst van de organisaties waartoe u behoort
  • get_organizationGeeft details van een specifieke organisatie
  • list_org_membersGeeft alle leden van een organisatie
  • invite_org_memberEen lid uitnodigen voor een organisatie
  • remove_org_memberEen lid verwijderen uit een organisatie
  • list_org_groupsAlle groepen binnen een organisatie opsommen
  • list_group_membersAlle leden van een specifieke groep binnen een organisatie opsommen

8 bronnen

MCP-resources geven AI-assistenten directe toegang tot je videogegevens als gestructureerde context:

  • coniviso://videosVolledige lijst van alle toegankelijke video's met metadata
  • coniviso://video/:idVolledig videodetail inclusief analyse en transcriptie
  • coniviso://video/:id/transcriptionVolledige transcriptiegegevens voor een specifieke video
  • coniviso://video/:id/analysisAI-analyseresultaten: samenvatting, hoofdstukken, scènes, entiteiten
  • coniviso://video/:id/permissionsToegangscontrolelijst met verleende machtigingen
  • coniviso://organizationsLijst van alle organisaties waartoe u behoort
  • coniviso://organization/:idOrganisatiegegevens en lijst van haar leden
  • coniviso://organization/:id/groupsLijst van alle groepen binnen een organisatie

Verbind in 30 seconden

Voeg Coniviso toe aan elke MCP-client met een enkel configuratieblok. Gebruik je bestaande API-sleutel voor authenticatie.

Endpointhttps://www.coniviso.com/mcp
AuthenticatieBearer vi_live_...
TransportStreamable HTTP (JSON-RPC over HTTP)

Elke sessie krijgt zijn eigen geïsoleerde serverinstantie. Sessies worden geïdentificeerd door de mcp-session-id header.

mcp config
{
  "mcpServers": {
    "coniviso": {
      "url": "https://www.coniviso.com/mcp",
      "headers": {
        "Authorization": "Bearer vi_live_..."
      }
    }
  }
}
Aan de slag

Operationeel in minuten

1. Maak een API-sleutel

Ga naar Instellingen → API-sleutels in je Coniviso-dashboard. API-sleutels volgen het vi_live_*-formaat en kunnen granulaire machtigingen hebben.

2. Authenticeer verzoeken

Neem je API-sleutel op als Bearer-token in de Authorization-header. Werkt voor zowel REST API-aanroepen als MCP-verbindingen.

3. Begin met bouwen

Gebruik de REST API vanuit elke taal of verbind de MCP-server met je AI-assistent. Beide delen dezelfde API-sleutel en machtigingen.

Beschikbare machtigingen

  • videos:readVideometadata opsommen en lezen
  • videos:writeVideo's uploaden, bijwerken en verwijderen
  • analysisAI-analyseresultaten indienen en lezen
  • searchZoeken in videocontent
  • chatAI-chatfuncties gebruiken (per video en bibliotheek)
  • embeddingsVectorembeddings genereren en beheren

Klaar om te integreren?

Begin met bouwen met de Coniviso API en MCP-server. Het gratis plan bevat 60 minuten AI-verwerking.

Haal je API-sleutelDocumentatie lezen