Intégration bookoly n8nAutomatiser bookoly avec n8n.

Plusieurs fichiers audio entrent, une piste continue en sort, prête à passer sous une vidéo.

• Sound - Name : le nom du son, requis, c'est l'étiquette que tu chercheras ensuite, souvent {{ $json.name }} venu du nœud précédent.
• Sound - Sounds (JSON) : les URL publiques et téléchargeables des fichiers audio à fusionner.
• Wait for Completion : activé, le nœud met le workflow en pause jusqu'à la fin et renvoie l'objet complet ; désactivé, seuls l'identifiant et l'horodatage de création reviennent.

Relit un son déjà présent dans bookoly et renvoie ses données : c'est ainsi qu'un workflow récupère un fichier créé plus tôt.

• Sound ID : l'identifiant du son, requis, repris de l'étape de fusion sous la forme {{ $json.id }}.

Un texte entre, une voix de synthèse sort. L'opération lit le script à voix haute et renvoie l'audio.

• Speech Synthesis - Name : le nom de la synthèse vocale, requis.
• Speech Synthesis - Text : le texte à vocaliser, requis, en général {{ $json.text }} issu de la ligne que tu viens de lire.
• Speech Synthesis - Voice : le nom de la voix, requis, à prendre dans la liste du nœud (Kore, Nova et les autres valeurs de vendor_id).

Va chercher les données d'une synthèse vocale dans l'API : l'étape à ajouter quand la création a tourné sans attendre.

• Speech ID : l'identifiant de la synthèse, requis, conservé depuis la réponse de création sous la forme {{ $json.id }}.

Là où la synthèse lit un seul script, cette opération met en scène une conversation entre plusieurs voix IA à partir d'un texte.

• Speech Dialogue - Name : le nom du dialogue, requis.
• Speech Dialogue - Segments (JSON) : les segments du dialogue en JSON, chacun avec son texte et une voix portant un vendor_id ; les valeurs disponibles sont listées sous Voices sur bookoly.com.
• Webhook URL : une URL valide qui reçoit l'identifiant et l'URL du dialogue une fois la génération finie.

Renvoie les données d'un dialogue déjà généré, pour récupérer l'audio bien après le workflow qui l'a commandé.

• Speech Dialogue ID : l'identifiant du dialogue, requis.

Transforme l'URL d'une vidéo ou d'un audio en fichier de sous-titres, avec la typographie et le placement décidés dans le nœud.

• Subtitle File - URL : l'URL publique et téléchargeable du fichier vidéo, requise.
• Subtitle - Style et Subtitle - Language : requis tous les deux, et tous les deux changent la lecture ; le style par défaut est Highlight Current Word, qui suit la voix mot après mot.
• Subtitle - Font Size et Subtitle - Outline Width : nombres requis, 20 et 5 par défaut.
• Subtitle - Line Words : le nombre de mots affichés à la fois, de 1 à 10.

Récupère un fichier de sous-titres auprès de l'API à partir de son identifiant et en renvoie les données au workflow.

• Subtitle File ID : l'identifiant du fichier de sous-titres, requis.

Du texte horodaté à partir d'un enregistrement. C'est l'opération qui rend un appel ou un webinaire cherchable.

• Transcript - Name : le nom de la transcription, requis.
• Transcript - URL : l'URL publique et téléchargeable du fichier audio ou vidéo, requise, mappée en {{ $json.src }} quand elle vient d'un nœud de stockage.
• Transcript - Language : la langue principale parlée dans le fichier, requise.
• Transcript - Translation Language : facultatif, traduit la transcription dans une autre langue.

Demande à l'API une transcription par son identifiant et renvoie ses données en l'état.

• Transcript ID : l'identifiant de la transcription, requis.

Une bande-son vient se poser sur une vidéo existante, et l'opération renvoie un nouveau fichier avec cette piste en place.

• Video - URL : l'URL publique et téléchargeable du fichier vidéo, requise.
• Audio - URL : l'URL publique et téléchargeable du fichier audio ajouté.
• Audio - Volume : volume de 0 à 100, 100 conservant le niveau d'origine et 0 donnant le silence.
• Audio - Trim : coupe l'audio quand la piste dépasse la durée de l'image.
• Video - Mute : coupe le son d'origine de la vidéo.

Deux travaux voyagent dans le même appel : la piste audio est ajoutée, puis les sous-titres sont générés depuis cet audio et inscrits sur l'image.

• Audio - URL : l'URL publique et téléchargeable du fichier audio qui porte la voix.
• Subtitle - Source : la source d'entrée des sous-titres, la synthèse vocale ou l'audio.
• Subtitle - Style : requis, de Simple à Highlight Current Word.
• Subtitle - Language : requis, la langue dans laquelle les sous-titres sont écrits.
• Audio - Trim : coupe l'audio à la longueur de la vidéo s'il est plus long.

Le son déjà présent dans la vidéo est lu, et les sous-titres sont générés puis inscrits à l'image, sans piste séparée.

• Subtitle - Font Family : requis, Arial par défaut, avec Roboto, Nunito, Lobster et le reste de la liste.
• Subtitle - Font Size : requis, 20 par défaut.
• Subtitle - Line Words : requis, le nombre de mots affichés à la fois, 1 au minimum et 10 au maximum.
• Subtitle - Position : requis, la place des sous-titres, de Top Left à Mid Bottom Center.
• Subtitle - Text Case : garde la casse d'origine, ou force les minuscules ou les majuscules.

Des sous-titres qui existent déjà sous forme de fichier sont rattachés à la vidéo : rien n'est généré, rien n'est retranscrit.

• Subtitle File - URL : requis, l'URL publique et téléchargeable du fichier de sous-titres.
• Subtitle File - Type : le format du sous-titre, Advanced SubStation Alpha (ASS) étant sélectionné par défaut.
• Wait for Completion : laissé désactivé, seuls l'identifiant et l'horodatage de création reviennent.

Une image est apposée sur la vidéo aux coordonnées choisies et y reste pendant tout le plan.

• Watermark - URL : requis, l'URL publique et téléchargeable du fichier image, PNG ou JPG.
• Watermark - X Coordinate : requis, la distance en pixels depuis le bord gauche.
• Watermark - Y Coordinate : requis, la distance en pixels depuis le bord haut de la vidéo, ce qui fixe la hauteur du logo dans le cadre.
• Video - Mute : coupe au passage le son d'origine.

Un rectangle de l'image est flouté, la manière habituelle de cacher un visage, une plaque ou un écran.

• X Coordinate et Y Coordinate : requis, position horizontale et verticale du coin supérieur gauche de la zone floutée.
• Box Width et Box Height : requis, en pixels, sans dépasser la largeur ni la hauteur de la vidéo.
• Power : requis, intensité du flou, avec une plage recommandée de 10 à 25.

Un extrait plus court est découpé dans un fichier plus long, défini par la seconde où il commence.

• Clip - Start Time : requis, le début du clip en secondes depuis le début de la vidéo.
• Clip - End Time : la fin du clip en secondes depuis le début de la vidéo, laissée vide pour aller jusqu'au bout.
• Video - Mute : retire le son d'origine de l'extrait.

Des images, des vidéos ou un mélange des deux sont assemblés en un seul fichier, scène après scène.

• Video - Resolution : requis, horizontal, vertical ou carré, du Full HD (1920x1080) à la 4K.
• Video - Scenes (JSON) : les scènes du diaporama, fournies en JSON.
• Webhook URL : une URL valide qui reçoit la notification, identifiant et URL de la vidéo compris.

L'image est ramenée à un rectangle, et tout ce qui se trouve hors de cette boîte disparaît du fichier de sortie.

• Crop - X Coordinate et Crop - Y Coordinate : requis, position du coin supérieur gauche du recadrage.
• Crop - Width et Crop - Height : requis, en pixels, plafonnés par la largeur et la hauteur de la vidéo.
• Video - Mute : coupe le son d'origine de la vidéo.

La piste audio est séparée du fichier vidéo et enregistrée seule, prête pour une étape qui ne s'intéresse qu'au son.

• Video - URL : requis, l'URL publique et téléchargeable du fichier vidéo.
• Webhook URL : une URL valide qui reçoit la notification, avec l'identifiant et l'URL de la vidéo.

Une image est capturée à un instant choisi et enregistrée comme fichier image, ce qui donne une vignette sans ouvrir de logiciel de montage.

• Video - Timestamp (Seconds) : l'instant d'où la frame est capturée, 5.2 signifiant 5.2 secondes après le début.
• Video - Name : requis, le nom de la vidéo, l'étiquette sous laquelle l'image est rangée.

L'opération la plus large du nœud construit une vidéo à partir d'images et de clips, ajoute une voix off générée avec des sous-titres automatiques, et y intègre une musique de fond.

• Video - Duration : requis, la durée finale suit l'audio, la synthèse vocale ou l'ensemble des scènes.
• Video - Scenes (JSON) : les scènes qui composent l'image, fournies en JSON.
• Speech Synthesis - Text et Speech Synthesis - Voice : le texte lu et la voix qui le lit.
• Video - Resolution : requis, jusqu'à la 4K (3840x2160).

Récupère les données de la vidéo auprès de l'API à partir de son identifiant, de quoi indiquer à la branche suivante où se trouve le fichier fini et sous quel nom il a été rangé.

• Video ID : requis, l'identifiant de la vidéo, généralement {{ $json.id }} conservé depuis l'étape qui l'a créée.

Le volume est ramené à zéro et la même vidéo revient, image intacte, son disparu.

• Video - Name : requis, le nom de la vidéo.
• Video - URL : requis, l'URL publique et téléchargeable du fichier vidéo.
• Wait for Completion : activé, le nœud met le workflow en pause jusqu'à la fin du traitement et renvoie l'objet vidéo complet.

Une seconde vidéo se pose sur la première à un ancrage choisi, l'incrustation que tout le monde attend d'un tutoriel.

• Overlay Video - URL : requis, l'URL publique et téléchargeable du fichier vidéo incrusté.
• Overlay Video - Mute : requis, indique si l'incrustation garde son propre son.
• Position : requis, de Top Left à Center Bottom.
• Scale : pourcentage d'échelle de la vidéo incrustée, de 1 à 100.
• X Offset et Y Offset : décalage en pixels depuis l'ancrage de position.

L'image pivote d'un quart, d'un demi ou de trois quarts de tour, et le fichier revient dans sa nouvelle orientation.

• Video - Rotation (Degrees) : 90, 180 ou 270, les valeurs positives tournant dans le sens horaire et les négatives dans le sens inverse.
• Video - Mute : indique si le son d'origine de la vidéo est retiré au passage.

Les dimensions changent selon le mode retenu, d'une simple cible de largeur à une taille exacte qui peut déformer l'image.

• Scale Mode : requis, Scale to Width, Scale to Height, Scale to Fit, Scale to Fill, Scale Exact ou Scale Keep Aspect Ratio.
• Width et Height : en pixels, en nombres pairs, 2 au minimum.
• Video - Mute : coupe le son d'origine de la vidéo.

Un fichier entre, plusieurs segments sortent, coupés là où l'image change ou sur un rythme fixe.

• Split - Mode : requis, détection automatique des scènes, intervalle fixe ou nombre de segments.
• Split - Segment Length : requis, la durée en secondes de chaque segment égal.
• Split - Min Scene Duration (Sec) et Split - Max Scene Duration (Sec) : requis, les bornes d'une scène détectée automatiquement.
• Split - Scene Change Threshold : requis, dans une plage de 0.1 à 1, les valeurs basses détectant plus de changements.

Deux fichiers sont placés côte à côte ou l'un au-dessus de l'autre dans une seule image.

• Secondary Video - URL : requis, l'URL publique et téléchargeable du second fichier vidéo à accoler.
• Secondary Video - Mute : requis, indique si le son de la seconde vidéo est conservé.
• Layout : requis, Horizontal les met côte à côte, Vertical l'un sur l'autre.
• Video - Mute : coupe le son de la vidéo principale.