🎬 Video Studio
Añade tres cosas que el sistema aún no tiene: eliminación de subtítulos quemados, análisis de canales y un pipeline de republicación. Las etapas restantes (descargar video, extraer subtítulos, traducción, TTS) viven en otras extensiones; consulta las reglas a continuación.
🛑 REGLA IMPORTANTE: cuando falte una herramienta, GUÍA al usuario, no digas "no se puede hacer"
La mayoría de las etapas de video son manejadas por extensiones opcionales. Si el usuario solicita algo cuya extensión no está instalada:
- NO des una respuesta genérica como "No tengo esa capacidad".
- Emite
{"action": "video_capabilities"}para obtener la lista exacta. - Entrega el resultado textual al usuario; enumera exactamente qué extensión instalar, describe cada una y le recuerda que vaya al Mercado (
/market) y luego reinicie el servidor.
Trabajo → extensión necesaria:
| Trabajo | Extensión necesaria |
|---|---|
| Descargar video | video_downloader |
| Extraer subtítulos / traducir / grabar subtítulos | subtitle_extractor |
| Voz en off (TTS) | tts_vibevoice |
| Eliminar subtítulos originales · analizar canal · pipeline | video_studio (ya instalada) |
| Pipeline completo de republicación | las 4 anteriores |
📥 video_capabilities — ver qué se puede hacer
{"action": "video_capabilities"}
Úsalo ANTES de rechazar cualquier solicitud de video.
📥 analyze_channel — analizar un canal, sugerir contenido
{"action": "analyze_channel", "url": "https://www.youtube.com/@tenkenh"}
Devuelve: tema, audiencia, tono, la fórmula de títulos de los videos más exitosos y de 5 a 8 ideas de video nuevas con ganchos. Úsalo cuando el usuario pregunte "¿de qué trata este canal?", "¿qué video debería hacer a continuación?".
📥 remove_hardsub — eliminar subtítulos quemados
{"action": "remove_hardsub", "video_path": "C:/path/video.mp4", "mode": "delogo"}
mode: delogo (por defecto — interpola desde el borde circundante; en un fondo plano el texto desaparece sin dejar rastro), blur, pixel, fill.
📥 reup_video — ejecutar toda la cadena
{"action": "reup_video", "url": "https://v.douyin.com/xxxx"}
Descargar → extraer subtítulos → traducir → enmascarar los subtítulos originales → voz en off → grabar nuevos subtítulos. Crea una tarea de Codex pendiente de aprobación: informa al usuario el número de tarea y recuérdale approve <n>. No digas que ha terminado de ejecutarse; solo se ha puesto en cola.
🌐 API HTTP
| Método | Endpoint | Trabajo |
|---|---|---|
| GET | /api/v1/video-studio/capabilities | Qué se puede hacer / qué falta |
| GET | /api/v1/video-studio/capabilities/{job} | Detalles de un trabajo |
| POST | /api/v1/video-studio/hardsub/detect | Solo detectar la región de subtítulos, no modificar el video |
| POST | /api/v1/video-studio/hardsub/remove | Detectar + enmascarar |
| POST | /api/v1/video-studio/channel/analyze | Analizar un canal |
| POST | /api/v1/video-studio/pipeline/plan | Ver qué pasos ejecutará el pipeline |
| POST | /api/v1/video-studio/pipeline/reup | Poner en cola el pipeline como tarea de Codex |
💡 Ejemplos
Usuario: "https://www.youtube.com/@abc ¿de qué trata este canal?"
{"action": "analyze_channel", "url": "https://www.youtube.com/@abc"}
Usuario: "republica este video al vietnamita para mí https://v.douyin.com/xxx"
{"action": "reup_video", "url": "https://v.douyin.com/xxx"}
Usuario: "extrae los subtítulos de este video" — pero subtitle_extractor no está instalado:
{"action": "video_capabilities"}
→ luego entrega el resultado sin procesar al usuario para que sepa qué instalar.