Agent docs
Guías para que un agente (o un humano) opere Video Studio: subir media, lanzar presets de automatización y descargar el pack de export.
Agentes (Cursor, Claude, Codex): usa el MCP. n8n / curl: HTTP + token.
Cómo empezar
- Studio + worker locales:
pnpm devypnpm worker(ver README del monorepo). - Configura
STUDIO_API_TOKEN(y el mismo valor enNEXT_PUBLIC_STUDIO_PUBLISHABLE_KEYpara la UI). - Agentes: conecta MCP (
pnpm mcp). Máquinas: lee Auth. - Ejecuta el playbook Talking Head → Short o Maestros — vía MCP tools o HTTP.
- Usa la referencia API cuando necesites otros endpoints (n8n).
Índice
| Doc | Uso |
|---|---|
| MCP | Tools / prompts para agentes (preferido) |
| Auth | Bearer / ?token=, 401, 503 |
| Playbook: Talking Head → Short | Flujo feliz API-first |
| Playbook: Maestros (1 clip) | Clip → plantilla canal |
| Playbook: Maestros batch | Carpeta MP4 → varios proyectos |
| API overview | Tabla de endpoints |
| Projects | CRUD + from-prompt |
| Assets | Upload multipart |
| Jobs | Pipeline / poll / retry |
| Exports | Descargar artefactos |
| Presets | Listar pipelines |
| Media | Stream de archivos |
Reglas
- Preferir MCP (agentes) o API HTTP (n8n); no automatizar la UI del editor.
- El browser / el agente no inventan comandos FFmpeg: solo mutan proyecto y encolan jobs.
- El worker local (
pnpm worker) debe estar corriendo o los jobs se quedan enqueued.