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.

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.

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.

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.

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:

{"tool":"tempo","projectId":"mi-proyecto","assetId":"REEMPLAZAR_POR_SHA256_DEL_AUDIO","language":"es"}

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:

{"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"}

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. 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:

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:

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:

{"tool":"vox","projectId":"mi-proyecto","text":"Esta es la narración de mi video."}

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:

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

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.

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 y créditos.