Integración bookoly n8nAutomatiza bookoly con n8n.

Entran varios archivos de audio y sale una pista continua, lista para acompañar un vídeo.

• Sound - Name: el nombre del sonido, requerido, la etiqueta por la que lo buscarás después, a menudo {{ $json.name }} del nodo anterior.
• Sound - Sounds (JSON): las URL públicas y descargables de los archivos de audio que se van a fusionar.
• Wait for Completion: activado, el nodo detiene el flujo hasta el final y devuelve el objeto completo; desactivado, solo vuelven el identificador y la marca de creación.

Relee un sonido que ya existe en bookoly y devuelve sus datos: así recupera un flujo el archivo que creó antes.

• Sound ID: el identificador del sonido, requerido, tomado del paso de fusión como {{ $json.id }}.

Entra un texto y sale una voz sintética. La operación lee el guion en voz alta y devuelve el audio.

• Speech Synthesis - Name: el nombre de la síntesis de voz, requerido.
• Speech Synthesis - Text: el texto que se va a convertir en voz, requerido, normalmente {{ $json.text }} de la fila que acabas de leer.
• Speech Synthesis - Voice: el nombre de la voz, requerido, elegido en la lista del nodo (Kore, Nova y los demás valores de vendor_id).

Busca en la API los datos de una síntesis de voz: el paso que añades cuando la creación se lanzó sin esperar.

• Speech ID: el identificador de la síntesis, requerido, conservado de la respuesta de creación como {{ $json.id }}.

Donde la síntesis lee un solo guion, esta operación monta una conversación entre varias voces de IA a partir de un texto.

• Speech Dialogue - Name: el nombre del diálogo, requerido.
• Speech Dialogue - Segments (JSON): los segmentos del diálogo en JSON, cada uno con su texto y una voz con su vendor_id; los valores disponibles están listados en Voices, en bookoly.com.
• Webhook URL: una URL válida que recibe el identificador y la URL del diálogo cuando termina la generación.

Devuelve los datos de un diálogo ya generado, para recoger el audio mucho después del flujo que lo encargó.

• Speech Dialogue ID: el identificador del diálogo, requerido.

Convierte la URL de un vídeo o un audio en un archivo de subtítulos, con la tipografía y la posición decididas en el nodo.

• Subtitle File - URL: la URL pública y descargable del archivo de vídeo, requerida.
• Subtitle - Style y Subtitle - Language: requeridos los dos, y los dos cambian la lectura; el estilo por defecto es Highlight Current Word, que sigue la voz palabra a palabra.
• Subtitle - Font Size y Subtitle - Outline Width: números requeridos, 20 y 5 por defecto.
• Subtitle - Line Words: cuántas palabras se muestran a la vez, de 1 a 10.

Recupera de la API un archivo de subtítulos a partir de su identificador y devuelve sus datos al flujo.

• Subtitle File ID: el identificador del archivo de subtítulos, requerido.

Texto con marcas de tiempo a partir de una grabación. Es la operación que vuelve buscable una llamada o un webinar.

• Transcript - Name: el nombre de la transcripción, requerido.
• Transcript - URL: la URL pública y descargable del archivo de audio o vídeo, requerida, mapeada como {{ $json.src }} cuando viene de un nodo de almacenamiento.
• Transcript - Language: el idioma principal hablado en el archivo, requerido.
• Transcript - Translation Language: opcional, traduce la transcripción a otro idioma.

Pide a la API una transcripción por su identificador y devuelve sus datos tal como están.

• Transcript ID: el identificador de la transcripción, requerido.

Una banda sonora se coloca sobre un vídeo existente y la operación devuelve un archivo nuevo con esa pista ya puesta.

• Video - URL: la URL pública y descargable del archivo de vídeo, requerida.
• Audio - URL: la URL pública y descargable del archivo de audio que se añade.
• Audio - Volume: volumen de 0 a 100, donde 100 mantiene el nivel original y 0 deja silencio.
• Audio - Trim: recorta el audio cuando la pista dura más que la imagen.
• Video - Mute: silencia el audio original del vídeo.

Dos tareas viajan en la misma llamada: se añade la pista de audio y después se generan los subtítulos a partir de ese audio y se escriben sobre la imagen.

• Audio - URL: la URL pública y descargable del archivo de audio que lleva la voz.
• Subtitle - Source: la fuente de entrada de los subtítulos, la síntesis de voz o el audio.
• Subtitle - Style: requerido, desde Simple hasta Highlight Current Word.
• Subtitle - Language: requerido, el idioma en el que se escriben los subtítulos.
• Audio - Trim: recorta el audio a la duración del vídeo si resulta más largo.

Se lee el sonido que ya contiene el vídeo y los subtítulos se generan y se escriben sobre la imagen, sin ninguna pista aparte.

• Subtitle - Font Family: requerido, Arial por defecto, con Roboto, Nunito, Lobster y el resto de la lista.
• Subtitle - Font Size: requerido, 20 por defecto.
• Subtitle - Line Words: requerido, cuántas palabras se muestran a la vez, 1 como mínimo y 10 como máximo.
• Subtitle - Position: requerido, dónde se colocan los subtítulos, de Top Left a Mid Bottom Center.
• Subtitle - Text Case: mantiene las mayúsculas originales, o las fuerza a minúscula o a mayúscula.

Unos subtítulos que ya existen como archivo se adjuntan al vídeo: no se genera nada ni se vuelve a transcribir.

• Subtitle File - URL: requerido, la URL pública y descargable del archivo de subtítulos.
• Subtitle File - Type: el formato del subtítulo, con Advanced SubStation Alpha (ASS) seleccionado por defecto.
• Wait for Completion: desactivado, solo vuelven el identificador y la marca de creación.

Una imagen queda estampada sobre el fotograma en las coordenadas que elijas y permanece durante todo el plano.

• Watermark - URL: requerido, la URL pública y descargable del archivo de imagen, PNG o JPG.
• Watermark - X Coordinate: requerido, distancia en píxeles desde el borde izquierdo del vídeo.
• Watermark - Y Coordinate: requerido, distancia en píxeles desde el borde superior del vídeo.
• Video - Mute: silencia de paso el audio original del vídeo.

Se difumina un rectángulo del fotograma, la forma habitual de ocultar una cara, una matrícula o una pantalla.

• X Coordinate y Y Coordinate: requeridos, posición horizontal y vertical de la esquina superior izquierda del área difuminada.
• Box Width y Box Height: requeridos, en píxeles, sin superar el ancho ni el alto del vídeo.
• Power: requerido, intensidad del desenfoque, con un rango recomendado de 10 a 25.

Se recorta un extracto más corto dentro de un archivo largo, definido por el segundo en el que empieza.

• Clip - Start Time: requerido, el inicio del clip en segundos desde el comienzo del vídeo.
• Clip - End Time: el final del clip en segundos desde el comienzo del vídeo, vacío para llegar hasta el final.
• Video - Mute: quita el audio original del extracto.

Imágenes, vídeos o una mezcla de ambos se ensamblan en un solo archivo, escena tras escena.

• Video - Resolution: requerido, horizontal, vertical o cuadrado, del Full HD (1920x1080) al 4K.
• Video - Scenes (JSON): las escenas de la presentación, en formato JSON.
• Webhook URL: una URL válida que recibe el aviso, con el identificador y la URL del vídeo.

El fotograma se reduce a un rectángulo y todo lo que queda fuera de esa caja desaparece del archivo de salida.

• Crop - X Coordinate y Crop - Y Coordinate: requeridos, posición de la esquina superior izquierda del recorte.
• Crop - Width y Crop - Height: requeridos, en píxeles, limitados por el ancho y el alto del vídeo.
• Video - Mute: silencia el audio original del vídeo.

La pista de audio se separa del archivo de vídeo y se guarda aparte, lista para un paso al que solo le interesa el sonido.

• Video - URL: requerido, la URL pública y descargable del archivo de vídeo.
• Webhook URL: una URL válida que recibe el aviso, con el identificador y la URL del vídeo.

Se captura un fotograma en el momento elegido y se guarda como imagen, lo que da una miniatura sin abrir ningún editor.

• Video - Timestamp (Seconds): el momento del que se captura el fotograma, 5.2 significa 5.2 segundos desde el inicio.
• Video - Name: requerido, el nombre del vídeo, la etiqueta con la que se guarda la imagen.

La operación más amplia del nodo construye un vídeo a partir de imágenes y clips, añade una voz en off generada con subtítulos automáticos e integra música de fondo.

• Video - Duration: requerido, la duración final sigue al audio, a la síntesis de voz o al conjunto de escenas.
• Video - Scenes (JSON): las escenas que componen la imagen, en formato JSON.
• Speech Synthesis - Text y Speech Synthesis - Voice: el texto que se lee y la voz que lo lee.
• Video - Resolution: requerido, hasta 4K (3840x2160).

Recupera los datos del vídeo desde la API a partir de su identificador, que es como la rama siguiente sabe dónde está el archivo terminado y con qué nombre quedó guardado.

• Video ID: requerido, el identificador del vídeo, normalmente {{ $json.id }} guardado del paso que lo creó.

El volumen baja a cero y vuelve el mismo vídeo, con la imagen intacta y el sonido fuera.

• Video - Name: requerido, el nombre del vídeo.
• Video - URL: requerido, la URL pública y descargable del archivo de vídeo.
• Wait for Completion: activado, el nodo detiene el flujo hasta que el servidor termina y devuelve el objeto de vídeo completo.

Un segundo vídeo se apoya sobre el primero en un anclaje elegido, la incrustación que se espera de cualquier tutorial.

• Overlay Video - URL: requerido, la URL pública y descargable del vídeo superpuesto.
• Overlay Video - Mute: requerido, indica si la superposición conserva su propio audio.
• Position: requerido, de Top Left a Center Bottom.
• Scale: porcentaje de escala del vídeo superpuesto, de 1 a 100.
• X Offset y Y Offset: desplazamiento en píxeles desde el anclaje de posición.

La imagen gira un cuarto, media vuelta o tres cuartos, y el archivo regresa con su nueva orientación.

• Video - Rotation (Degrees): 90, 180 o 270, los valores positivos giran en sentido horario y los negativos al contrario.
• Video - Mute: indica si el audio original del vídeo se descarta por el camino.

Las dimensiones cambian según el modo que elijas, desde un objetivo de ancho sencillo hasta un tamaño exacto que puede deformar la imagen.

• Scale Mode: requerido, Scale to Width, Scale to Height, Scale to Fit, Scale to Fill, Scale Exact o Scale Keep Aspect Ratio.
• Width y Height: en píxeles, en números pares, 2 como mínimo.
• Video - Mute: silencia el audio original del vídeo.

Entra un archivo y salen varios segmentos, cortados donde cambia la imagen o con un ritmo fijo.

• Split - Mode: requerido, detección automática de escenas, intervalo fijo o número de segmentos.
• Split - Segment Length: requerido, la duración en segundos de cada segmento igual.
• Split - Min Scene Duration (Sec) y Split - Max Scene Duration (Sec): requeridos, los límites de duración que puede tener una escena detectada de forma automática por el servicio.
• Split - Scene Change Threshold: requerido, de 0.1 a 1, y los valores bajos detectan más cambios.

Dos archivos se colocan uno al lado del otro o uno encima del otro dentro de un mismo fotograma.

• Secondary Video - URL: requerido, la URL pública y descargable del segundo archivo de vídeo que se acopla.
• Secondary Video - Mute: requerido, indica si se conserva el audio del segundo vídeo.
• Layout: requerido, Horizontal uno junto a otro, Vertical uno sobre otro.
• Video - Mute: quita el audio del primer vídeo.