# Herramientas IA e integraciones Puedes usar las herramientas de EditorBrain o herramientas que tengas conectadas a tu agente. Son rutas de acceso y facturación diferentes. | Herramienta | Resultado | Entrada habitual | | --- | --- | --- | | Tempo | Transcripción y tiempos por palabra | Audio preparado de tu video | | Prism | Imagen para una escena | Descripción, calidad y formato | | Vox | Narración | Texto e idioma compatibles | | Aura | Música instrumental | Intención musical y duración objetivo | La web configura cómo quieres que las use el agente. Que aparezcan en la interfaz no significa que todas estén activas. **Consulta `studio catalog` antes de cotizar.** ```sh editorbrain studio catalog editorbrain integrations list editorbrain billing status ``` ## Tus integraciones personales Activar una integración guarda preferencias y el método de acceso; no guarda automáticamente las credenciales de esa aplicación. El agente comprueba que realmente existe una herramienta, CLI, MCP o sesión utilizable en su entorno. Un saldo de EditorBrain insuficiente no implica que tu proveedor externo no tenga saldo. El agente debe explicar la ruta que va a usar y su costo; nunca cambiar a otra ruta de pago silenciosamente. Las restricciones de tu proyecto siguen aplicándose. ## Tempo: de MP4 a transcripción ### Elegir cómo transcribir En **Herramientas IA → Transcripción**, guarda la opción para tu marca. El agente respeta primero lo que pidas para la edición, después tu preferencia guardada. Si no has elegido, propone Tempo; puedes usar otra opción. | Opción | Ventaja | Qué necesitas | | --- | --- | --- | | Tempo de EditorBrain | Integrado, sin gestionar otra clave | Disponibilidad y créditos de EditorBrain para el encargo autorizado | | Tu cuenta de AssemblyAI | Aprovecha tu acceso y saldo propios | Conexión utilizable por tu agente y presupuesto del proveedor | | Whisper online | Procesa en el servicio que elijas | Identificar ese servicio y comprobar su acceso, formatos y costo | | Whisper local | Transcribe en el equipo del agente, sin créditos de EditorBrain | Motor y modelo instalados; tiempo, memoria y espacio disponibles | **Puedes editar en Gratis o con cero créditos de EditorBrain usando una ruta propia o una transcripción existente.** Los servicios externos pueden tener sus propios costos. La selección no conecta cuentas, instala modelos ni autoriza gasto. Configura el acceso personal en Integraciones; no pegues claves en las preferencias. En un agente cloud, «local» significa su entorno de ejecución. Las cuatro rutas sirven al mismo flujo de edición. El agente conserva la fuente y los tiempos reales de la transcripción y los adapta a los cortes. Para karaoke necesita tiempos por palabra; una transcripción por frases sigue sirviendo para planificar y crear subtítulos por frases. No atribuye Whisper a Tempo ni cambia de proveedor sin una elección o autorización previa. Los permisos de biblioteca premium, búsqueda, almacenamiento y render siguen siendo independientes. Estas opciones guardadas requieren CLI/API y web 0.44.0 o posterior. Las rutas propias se ejecutan mediante las herramientas disponibles de tu agente; no son adaptadores de transcripción alojados por EditorBrain. ```sh editorbrain studio prepare --file ./grabacion.mp4 --out .editorbrain-local/studio/audio.wav editorbrain assets upload .editorbrain-local/studio/audio.wav --project mi-proyecto --mime audio/wav --purpose temporary ``` La preparación es local y requiere FFmpeg/FFprobe. Extrae WAV PCM de 16 bits; si hay varias pistas, elige la correcta. Usa el hash devuelto por la subida como `assetId` en `tempo.json`: ```json {"tool":"tempo","projectId":"mi-proyecto","assetId":"REEMPLAZAR_POR_SHA256_DEL_AUDIO","language":"es"} ``` ```sh editorbrain studio quote --file tempo.json ``` El marcador no es un hash válido: reemplázalo antes de enviar. Tempo admite hasta 30 minutos por encargo. Si divides un audio, conserva el offset de cada segmento para relacionar palabras con el video original. `tempo` es el nombre de solicitud recomendado; respuestas antiguas pueden conservar `scribe` por compatibilidad. ## Prism: ejemplo de solicitud Guarda en `imagen.json`: ```json {"tool":"prism","projectId":"mi-proyecto","prompt":"Una ilustración clara de un calendario con tareas organizadas, sin texto","quality":"essential","resolution":"1K","aspectRatio":"9:16"} ``` ```sh editorbrain studio quote --file imagen.json ``` Omitir parámetros compatibles permite heredar preferencias guardadas. Un parámetro explícito que contradiga esas preferencias puede necesitar una excepción justificada; no inventes un motivo para saltarte una restricción. Aura usa `tool: "music"`, `prompt` y `durationSeconds` (30, 60 o 120). Los esquemas completos están en la [referencia MCP](https://editorbrain.com/docs/mcp-tools). La duración pedida a Aura es un objetivo de generación, no una promesa de que el audio entregado mida exactamente eso. ## Vox: elegir una voz para la marca o el video Consulta el catálogo y filtra por idioma, acento, género o texto. Los resultados incluyen alias públicos, características y una muestra cuando esté disponible: ```sh editorbrain studio voices --language es editorbrain studio voices --accent american --gender female --query cálida editorbrain studio voice --brand mi-marca editorbrain studio voice --project mi-proyecto ``` Los idiomas del catálogo indican en qué idiomas puede sintetizar la voz; la muestra tiene su propio `preview.language`. El acento describe la voz original en inglés y no garantiza un acento regional al hablar español. Escucha la muestra y revisa la narración generada antes de dar por confirmado ese resultado. La lectura de selección devuelve `path`, `revision`, la voz guardada y la voz efectiva, incluida su herencia. Para guardar, usa un alias del catálogo y la revisión que acabas de leer. Por ejemplo, si devolvió revisión `2`: ```sh editorbrain studio voice narrator --project mi-proyecto --expected-revision 2 ``` Elige un solo alcance: `--brand` cambia la voz predeterminada de esa marca; `--project` la voz de ese video. Una revisión `0` indica que aún no existe su documento de audio. Si otra sesión lo modificó, vuelve a leerlo antes de guardar. Se conserva el resto de `audio.json`, incluida música, SFX y loudness. El comando guarda en la nube. Antes de editar o subir tu copia local, revisa `editorbrain pull --project mi-proyecto --dry-run`, reconcilia cualquier cambio local y después haz pull del proyecto. No descartes trabajo local para forzar esa actualización. En MCP usa `list_vox_voices`, `get_vox_voice_selection` y `set_vox_voice_selection`. Las muestras necesitan acceso autenticado; consultar su enlace no significa haberlas escuchado. Elegir una voz o escuchar una muestra no genera una narración ni gasta créditos. Tampoco cambia la decisión del proyecto de conservar voz original o no usar narración. Guarda una solicitud en `vox.json` con el texto exacto: ```json {"tool":"vox","projectId":"mi-proyecto","text":"Esta es la narración de mi video."} ``` ```sh editorbrain studio quote --file vox.json ``` Al omitir `voice`, la cotización hereda la voz efectiva de EditorBrain guardada. Puedes indicar un alias explícito compatible con las preferencias; un alias desconocido produce un error, sin reemplazarlo por otra voz. Revisa la voz y el idioma resueltos de la cotización. Las restricciones de narración y la aprobación del gasto siguen aplicándose antes de ejecutar. ## Referencias para Prism Premium Disponible con API 0.43.0 o posterior. Antes de usarlo, comprueba que `studio catalog` anuncia `capabilities.referenceImages` para Prism; la existencia de un ejemplo en la documentación no activa un proveedor. Sube las imágenes seleccionadas con `assets upload` y añade `"referenceAssetIds":["SHA256_REAL_DE_LA_IMAGEN"]` a la solicitud. Se aceptan hasta cuatro PNG, JPEG o WebP del workspace, en el orden indicado, con un máximo de 8 MiB por imagen y 20 MiB en total. Selecciona `"quality":"premium"`; no se cambia a un modelo más caro automáticamente. Las preferencias guardadas siguen aplicando. Cotizar no envía las imágenes al proveedor. Al autorizar la ejecución se transfieren esas referencias; revisa el importe y las imágenes antes de confirmar. Conservar el parecido con un logo o personaje requiere inspeccionar el resultado. No uses enlaces externos ni imágenes de otro workspace. ## Cotizar, autorizar y ejecutar La cotización devuelve `quoteId`, créditos y vencimiento. No inicia la generación. Después de que el usuario autorice ese encargo o un presupuesto que lo cubra: ```sh editorbrain studio run QUOTE_ID --max-credits LIMITE_AUTORIZADO --user-confirmed editorbrain studio get JOB_ID ``` Los marcadores se sustituyen por valores reales. `--user-confirmed` registra una autorización existente; no la crea. El servidor comprueba permisos, contexto y saldo y reserva los créditos antes de enviar el trabajo. ## Colas, polling y errores | Estado | Qué hacer | | --- | --- | | `queued`, `submitting`, `running` | Consultar el mismo ID con espera; no crear otra cotización para duplicarlo | | `completed` | Leer los archivos del resultado, descargarlos e inspeccionarlos | | `failed` | Leer el error y la recuperación; comprobar saldo antes de un nuevo intento | | `needs_attention` | Resultado incierto o retrasado; revisar el historial y pedir ayuda si persiste | Para una automatización, usa esperas crecientes y acotadas (por ejemplo 2, 5, 10 y 20 segundos), respeta `Retry-After` y detén el polling en estados finales o de atención. Es una pauta de cliente, no una garantía de tiempo del proveedor. ```sh editorbrain studio jobs editorbrain assets download SHA256 --out ./resultado.png ``` Un fallo confirmado puede liberar la reserva; un resultado incierto necesita conciliación para evitar cobros o generaciones duplicadas. Repetir un comando a ciegas no es recuperación. Ver [errores](https://editorbrain.com/docs/errores) y [créditos](https://editorbrain.com/docs/creditos).