🎬 Video Studio
Adiciona três coisas que o sistema ainda não possui: remover legendas fixadas (hardsubs), análise de canais e um pipeline de republicação. As demais etapas (baixar vídeo, extrair legendas, tradução, TTS) estão em outras extensões — veja as regras abaixo.
🛑 REGRA IMPORTANTE: quando uma ferramenta estiver faltando, GUIE o usuário, não diga "não é possível"
A maioria das etapas de vídeo é tratada por extensões opcionais. Se o usuário solicitar algo cuja extensão não esteja instalada:
- NÃO dê uma resposta genérica como "não tenho essa capacidade".
- Emita
{"action": "video_capabilities"}para obter a lista exata. - Repasse o resultado exato para o usuário — ele lista exatamente qual extensão instalar, descreve cada uma e lembra de ir ao Market (
/market) e reiniciar o servidor.
Tarefa → extensão necessária:
| Tarefa | Extensão necessária |
|---|---|
| Baixar vídeo | video_downloader |
| Extrair legendas / traduzir / queimar legendas | subtitle_extractor |
| Narração (TTS) | tts_vibevoice |
| Remover legendas originais · analisar canal · pipeline | video_studio (já instalado) |
| Pipeline completo de republicação | todas as 4 acima |
📥 video_capabilities — veja o que pode ser feito
{"action": "video_capabilities"}
Use ANTES de recusar qualquer solicitação de vídeo.
📥 analyze_channel — analise um canal, sugira conteúdo
{"action": "analyze_channel", "url": "https://www.youtube.com/@tenkenh"}
Retorna: tópico, público-alvo, tom, a fórmula de títulos de vídeos de sucesso e 5 a 8 novas ideias de vídeo com ganchos. Use quando o usuário perguntar "do que se trata este canal", "qual vídeo devo fazer a seguir".
📥 remove_hardsub — remova legendas fixadas
{"action": "remove_hardsub", "video_path": "C:/path/video.mp4", "mode": "delogo"}
mode: delogo (padrão — interpola a partir da borda circundante; em um fundo plano o texto desaparece sem deixar rastro), blur, pixel, fill.
📥 reup_video — execute toda a cadeia
{"action": "reup_video", "url": "https://v.douyin.com/xxxx"}
Baixar → extrair legendas → traduzir → mascarar as legendas originais → narrar → queimar novas legendas. Cria uma tarefa no Codex aguardando aprovação — informe o número da tarefa ao usuário e lembre-o de approve <n>. Não diga que terminou de executar; ela acabou de ser enfileirada.
🌐 API HTTP
| Método | Endpoint | Tarefa |
|---|---|---|
| GET | /api/v1/video-studio/capabilities | O que pode ser feito / o que está faltando |
| GET | /api/v1/video-studio/capabilities/{job} | Detalhes de uma tarefa |
| POST | /api/v1/video-studio/hardsub/detect | Apenas detectar a região da legenda, sem modificar o vídeo |
| POST | /api/v1/video-studio/hardsub/remove | Detectar + mascarar |
| POST | /api/v1/video-studio/channel/analyze | Analisar um canal |
| POST | /api/v1/video-studio/pipeline/plan | Ver quais etapas o pipeline executará |
| POST | /api/v1/video-studio/pipeline/reup | Enfileirar o pipeline como uma tarefa do Codex |
💡 Exemplos
Usuário: "https://www.youtube.com/@abc sobre o que é este canal?"
{"action": "analyze_channel", "url": "https://www.youtube.com/@abc"}
Usuário: "republique este vídeo em vietnamita para mim https://v.douyin.com/xxx"
{"action": "reup_video", "url": "https://v.douyin.com/xxx"}
Usuário: "extraia as legendas deste vídeo" — mas subtitle_extractor não está instalado:
{"action": "video_capabilities"}
→ então repasse o resultado bruto para o usuário para que ele saiba o que instalar.