REST API + MCP Server

Desenvolva com Video Intelligence

Duas formas de integrar: uma API REST completa para aplicações personalizadas e um servidor MCP para que assistentes de IA trabalhem com seus vídeos nativamente.

Referência da APIObter chave API
REST API

Controle programático completo

Uma API RESTful abrangente cobrindo todo o ciclo de vida do vídeo — do upload e codificação à análise de IA, transcrição, pesquisa e gestão de equipes.

Upload e importação

Importe vídeos do YouTube ou envie diretamente via URLs S3 pré-assinadas. A codificação acontece automaticamente em segundo plano.

Análise de IA

Envie vídeos para análise com IA — gere capítulos, detecte cenas, extraia entidades e produza resumos detalhados.

Transcrição

Transcreva áudio com Whisper e traduza para mais de 100 idiomas. Suporte completo a legendas multilíngues incluso.

Pesquisa e Chat

Pesquisa híbrida semântica + palavras-chave em sua biblioteca. Habilite chat IA baseado em RAG para vídeos individuais ou toda a coleção.

Embeddings

Gere embeddings vetoriais a partir de dados de análise e transcrição para alimentar a pesquisa semântica e o chat IA baseado em RAG.

Organizações

Gerencie equipes com acesso baseado em funções, isolamento de dados entre grupos e fluxos de convite — tudo 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"}'
Servidor MCP

Seus vídeos em qualquer assistente de IA

O Coniviso expõe um servidor Model Context Protocol (MCP) para que assistentes de IA como Claude, Cursor e agentes personalizados acessem sua biblioteca de vídeos, pesquisem conteúdo, leiam transcrições e disparem análises — tudo pela interface MCP padrão.

O que é MCP?

O Model Context Protocol é um padrão aberto que permite que modelos de IA interajam de forma segura com ferramentas e fontes de dados externas. Em vez de escrever integrações personalizadas, qualquer cliente de IA compatível com MCP pode se conectar ao Coniviso e usar seus vídeos como contexto imediatamente.

21 ferramentas disponíveis

Cada ferramenta é limitada às permissões da sua chave API. Seu assistente IA pode listar, pesquisar, atualizar e excluir vídeos, gerenciar organizações, grupos, permissões e visibilidade, recuperar análises e transcrições, conversar com vídeos individuais ou toda a biblioteca, gerar embeddings e enviar novos trabalhos de análise — tudo sem sair da conversa.

  • list_videosNavegue pela sua biblioteca de vídeos com paginação e filtros de status
  • get_videoObtenha metadados completos, status de processamento e configuração de qualquer vídeo
  • search_videosPesquisa híbrida semântica + palavras-chave em todos os vídeos acessíveis
  • chat_with_libraryFaça perguntas sobre toda sua coleção de vídeos usando RAG
  • chat_with_videoPerguntas e respostas sobre um vídeo específico com suporte a conversas multi-turno
  • get_analysisRecupere resultados de análise de IA: resumos, capítulos, cenas, entidades
  • get_transcriptionObtenha dados de transcrição, opcionalmente filtrados por idioma
  • analyze_videoEnvie um vídeo para análise de IA (completa, cenas, objetos ou texto)
  • generate_embeddingsCriar embeddings vetoriais a partir de dados de análise e transcrição para pesquisa semântica
  • update_videoAtualizar título, descrição, visibilidade ou organização de um vídeo
  • delete_videoExcluir permanentemente um vídeo e todos os dados associados
  • get_permissionsListar todas as permissões de acesso concedidas em um vídeo
  • grant_permissionConceder acesso a um usuário, grupo ou organização em um vídeo
  • revoke_permissionRevogar uma permissão de acesso previamente concedida em um vídeo
  • list_organizationsRetorna uma lista de organizações as quais você pertence
  • get_organizationRetorna os detalhes de uma organização específica
  • list_org_membersRetorna todos os membros de uma organização
  • invite_org_memberConvidar um membro para uma organização
  • remove_org_memberRemover um membro de uma organização
  • list_org_groupsListar todos os grupos dentro de uma organização
  • list_group_membersListar todos os membros de um grupo específico dentro de uma organização

8 recursos

Recursos MCP dão aos assistentes de IA acesso direto aos seus dados de vídeo como contexto estruturado:

  • coniviso://videosLista completa de todos os vídeos acessíveis com metadados
  • coniviso://video/:idDetalhe completo do vídeo incluindo análise e transcrição
  • coniviso://video/:id/transcriptionDados de transcrição completos para um vídeo específico
  • coniviso://video/:id/analysisResultados da análise IA: resumo, capítulos, cenas, entidades
  • coniviso://video/:id/permissionsLista de controle de acesso com permissões concedidas
  • coniviso://organizationsLista de todas as organizações as quais você pertence
  • coniviso://organization/:idDetalhes da organização e lista de seus membros
  • coniviso://organization/:id/groupsLista de todos os grupos dentro de uma organização

Conecte em 30 segundos

Adicione o Coniviso a qualquer cliente MCP com um único bloco de configuração. Use sua chave API existente para autenticação.

Endpointhttps://www.coniviso.com/mcp
AutenticaçãoBearer vi_live_...
TransporteStreamable HTTP (JSON-RPC sobre HTTP)

Cada sessão obtém sua própria instância de servidor isolada. As sessões são identificadas pelo cabeçalho mcp-session-id.

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

Funcionando em minutos

1. Crie uma chave API

Vá em Configurações → Chaves API no seu painel Coniviso. As chaves API seguem o formato vi_live_* e podem ter permissões granulares.

2. Autentique as requisições

Inclua sua chave API como token Bearer no cabeçalho Authorization. Funciona tanto para chamadas REST API quanto para conexões MCP.

3. Comece a desenvolver

Use a REST API de qualquer linguagem ou conecte o servidor MCP ao seu assistente de IA. Ambos compartilham a mesma chave API e permissões.

Permissões disponíveis

  • videos:readListar e ler metadados de vídeo
  • videos:writeEnviar, atualizar e excluir vídeos
  • analysisEnviar e ler resultados de análise de IA
  • searchPesquisar no conteúdo de vídeo
  • chatUsar recursos de chat de IA (por vídeo e biblioteca)
  • embeddingsGerar e gerenciar embeddings vetoriais

Pronto para integrar?

Comece a desenvolver com a API Coniviso e o servidor MCP. O plano gratuito inclui 60 minutos de processamento de IA.

Obtenha sua chave APILeia a documentação