Habilidade VideoDB

Percepção + memória + ações para vídeos, transmissões ao vivo e sessões de desktop.

Use esta habilidade quando precisar:

Quando Usar

• Você precisa de percepção, indexação, busca ou edição de linha do tempo de vídeo ou áudio a partir de arquivos, URLs, sessões de desktop ou transmissões ao vivo.
• A tarefa envolve carimbos de data/hora, evidências pesquisáveis, legendas, clipes, sobreposições ou alertas de monitoramento em tempo real.
• Você deseja um fluxo de trabalho que combine ingestão, compreensão, recuperação e ações de mídia.

1) Percepção de Desktop

• Iniciar/parar uma sessão de desktop capturando tela, microfone e áudio do sistema
• Transmitir contexto em tempo real e armazenar memória episódica da sessão
• Executar alertas/gatilhos em tempo real sobre o que está sendo falado e o que está acontecendo na tela
• Produzir resumos da sessão, uma linha do tempo pesquisável e links de evidências reproduzíveis

2) Ingestão + transmissão de vídeo

• Ingerir um arquivo ou URL e retornar um link de transmissão web reproduzível
• Transcodificar/normalizar: codec, taxa de bits, fps, resolução, proporção

3) Indexar + buscar (carimbos de data/hora + evidências)

• Construir índices visuais, falados e por palavras-chave
• Buscar e retornar momentos exatos com carimbos de data/hora e evidências reproduzíveis
• Criar automaticamente clipes a partir dos resultados da busca

4) Edição de linha do tempo + geração

• Legendas: gerar, traduzir, queimar na mídia
• Sobreposições: texto/imagem/marca, legendas animadas
• Áudio: música de fundo, narração, dublagem
• Composição programática e exportações via operações de linha do tempo

5) Transmissões ao vivo (RTSP) + monitoramento

• Conectar feeds RTSP/ao vivo
• Executar compreensão visual e falada em tempo real e emitir eventos/alertas para fluxos de trabalho de monitoramento

Entradas comuns

• Caminho do arquivo local, URL público ou URL RTSP
• Solicitação de captura de desktop: iniciar / parar / resumir sessão
• Operações desejadas: obter contexto para compreensão, especificação de transcodificação, especificação de indexação, consulta de busca, intervalos de clipes, edições de linha do tempo, regras de alerta

Saídas comuns

• URL de transmissão
• Resultados da busca com carimbos de data/hora e links de evidências
• Ativos gerados: legendas, áudio, imagens, clipes
• Cargas úteis de eventos/alertas para transmissões ao vivo
• Resumos de sessão de desktop e entradas de memória

Prompts canônicos (exemplos)

• "Iniciar captura de desktop e alertar quando um campo de senha aparecer."
• "Gravar minha sessão e produzir um resumo acionável quando ela terminar."
• "Ingerir este arquivo e retornar um link de transmissão reproduzível."
• "Indexar esta pasta e encontrar todas as cenas com pessoas, retornar os carimbos de data/hora."
• "Gerar legendas, queimá-las na mídia e adicionar música de fundo leve."
• "Conectar este URL RTSP e alertar quando uma pessoa entrar na zona."

Executando código Python

Antes de executar qualquer código VideoDB, mude para o diretório do projeto e carregue as variáveis de ambiente:

from dotenv import load_dotenv
load_dotenv(".env")

import videodb
conn = videodb.connect()

Isso lê VIDEO_DB_API_KEY de:

1. Ambiente (se já exportado)
2. Arquivo .env do projeto no diretório atual

Se a chave estiver faltando, videodb.connect() levanta AuthenticationError automaticamente.

NÃO escreva um arquivo de script quando um comando inline curto funcionar.

Ao escrever Python inline (python -c "..."), sempre use código formatado corretamente — use ponto e vírgulas para separar instruções e mantenha-o legível. Para qualquer coisa com mais de ~3 instruções, use um heredoc em vez disso:

python << 'EOF'
from dotenv import load_dotenv
load_dotenv(".env")

import videodb
conn = videodb.connect()
coll = conn.get_collection()
print(f"Videos: {len(coll.get_videos())}")
EOF

Configuração

Quando o usuário pedir para "configurar videodb" ou similar:

1. Instalar SDK

pip install "videodb[capture]" python-dotenv

Se videodb[capture] falhar no Linux, instale sem o extra de captura:

pip install videodb python-dotenv

2. Configurar chave de API

O usuário deve definir VIDEO_DB_API_KEY usando um dos dois métodos:

• Exportar no terminal (antes de iniciar o Claude): export VIDEO_DB_API_KEY=your-key
• Arquivo .env do projeto: Salve VIDEO_DB_API_KEY=your-key no arquivo .env do projeto

Obtenha uma chave de API gratuita em https://console.videodb.io (50 uploads gratuitos, sem cartão de crédito).

NÃO leia, escreva ou manipule a chave de API você mesmo. Sempre deixe o usuário configurá-la.

Referência Rápida

Fazer upload de mídia

# URL
video = coll.upload(url="https://example.com/video.mp4")

# YouTube
video = coll.upload(url="https://www.youtube.com/watch?v=VIDEO_ID")

# Local file
video = coll.upload(file_path="/path/to/video.mp4")

…