bookoly n8n integrationAutomate bookoly with n8n.

Several audio files go in, one continuous track comes out, ready to sit under a video.

• Sound - Name: the name of the sound, required, and the label you will look for later, often {{ $json.name }} from the node before.
• Sound - Sounds (JSON): the public and downloadable URLs of the audio files to merge.
• Wait for Completion: on, the node pauses the workflow until the sound is finished and returns the full object; off, only the ID and the creation timestamp come back.

Reads back a sound that already exists in bookoly and returns its data, which is how a workflow picks up a file it created earlier.

• Sound ID: the ID of the sound, required; it comes from the combine step as {{ $json.id }}.

Text in, a synthesized voice out. The operation reads a script aloud and returns the audio.

• Speech Synthesis - Name: the name of the speech synthesis, required.
• Speech Synthesis - Text: the text to create the speech synthesis from, required, usually {{ $json.text }} from the row you just read.
• Speech Synthesis - Voice: the name of the voice, required, picked from the list in the node (Kore, Nova and the rest of the vendor_id values).

Fetches the data of one speech synthesis from the API, which is the step you add when the creation ran without waiting.

• Speech ID: the ID of the Speech, required, kept from the creation response as {{ $json.id }}.

Where the speech operation reads one script, this one stages a conversation between several AI voices from text.

• Speech Dialogue - Name: the name of the speech dialogue, required.
• Speech Dialogue - Segments (JSON): the dialogue segments in JSON, each one with its text and a voice carrying a vendor_id; the available values are listed under Voices at bookoly.com.
• Webhook URL: a valid URL that receives the Speech Dialogue ID and URL once generation ends.

Returns the data of a dialogue already generated, so the audio can be picked up long after the workflow that ordered it.

• Speech Dialogue ID: the ID of the Speech Dialogue, required.

Turns a video or audio URL into a subtitle file, with the typography and the placement decided in the node.

• Subtitle File - URL: the public and downloadable URL of the video file, required.
• Subtitle - Style and Subtitle - Language: both required, and both change how the captions read; the default style is Highlight Current Word, which follows the speaker word by word.
• Subtitle - Font Size and Subtitle - Outline Width: required numbers, 20 and 5 by default.
• Subtitle - Line Words: how many words show at a time, from 1 to 10.

Pulls one subtitle file back from the API using its identifier, and returns its data to the workflow.

• Subtitle File ID: the ID of the Subtitle File, required.

Written text with timestamps, out of a recording. This is the operation that makes a call or a webinar searchable.

• Transcript - Name: the name of the transcript, required.
• Transcript - URL: the public and downloadable URL of the audio or video file, required, mapped as {{ $json.src }} when it comes from a storage node.
• Transcript - Language: the primary language spoken in the file, required.
• Transcript - Translation Language: optional, translates the transcript into another language.

Asks the API for one transcript by its identifier and returns the transcript data as it stands.

• Transcript ID: the ID of the Transcript, required.

A soundtrack gets laid over an existing video file, and the operation returns a new video with that track in place.

• Video - URL: the public and downloadable URL of the video file, required.
• Audio - URL: the public and downloadable URL of the audio file that is added.
• Audio - Volume: audio volume from 0 to 100, where 100 keeps the original level and 0 is silent.
• Audio - Trim: trims the audio when the track runs longer than the picture.
• Video - Mute: mutes the original video audio.

Two jobs travel in one call: the audio track is added, then subtitles are generated from that audio and written onto the video.

• Audio - URL: the public and downloadable URL of the audio file that carries the voice.
• Subtitle - Source: the input source for subtitle generation, from speech synthesis or from audio.
• Subtitle - Style: required, from Simple to Highlight Current Word.
• Subtitle - Language: required, the language the subtitles are written in.
• Audio - Trim: trims the audio to match the video length when it is longer.

The sound already inside the video is read, and captions are generated and written onto the picture without any separate track.

• Subtitle - Font Family: required, Arial by default, with Roboto, Nunito, Lobster and the rest of the list waiting behind it.
• Subtitle - Font Size: required, 20 by default.
• Subtitle - Line Words: required, how many words show at a time, 1 minimum and 10 maximum.
• Subtitle - Position: required, from Top Left to Mid Bottom Center.
• Subtitle - Text Case: keeps the original casing, or forces lower case or upper case on every line.

Captions that already exist as a file are attached to the video, so nothing is generated and nothing is re-transcribed.

• Subtitle File - URL: required, the public and downloadable URL of the subtitle file.
• Subtitle File - Type: the format of the subtitle, Advanced SubStation Alpha (ASS) being selected by default.
• Wait for Completion: left off, only the ID and the creation timestamp come back.

An image is stamped onto the frame at coordinates you choose and stays there for the whole clip.

• Watermark - URL: required, the public and downloadable URL of the image file, PNG or JPG.
• Watermark - X Coordinate: required, distance in pixels from the left edge of the video.
• Watermark - Y Coordinate: required, distance in pixels from the top edge of the video.
• Video - Mute: drops the original video audio at the same time.

A rectangle of the frame is blurred, which is the usual way to hide a face, a plate or a screen.

• X Coordinate and Y Coordinate: required, horizontal and vertical position of the top-left corner of the blur area.
• Box Width and Box Height: required, in pixels, and neither may exceed the video width or height.
• Power: required, intensity of the blur, with a recommended range of 10 to 25.

A shorter extract is cut out of a longer file, defined by the second where it begins.

• Clip - Start Time: required, the clip start time in seconds from the start of the video.
• Clip - End Time: the clip end time in seconds from the start of the video, left empty to run to the end.
• Video - Mute: removes the original audio from the extract.

Images, videos or a mix of both are assembled into a single file, scene after scene, in the order you hand them over to the node.

• Video - Resolution: required, horizontal, vertical or square, from Full HD (1920x1080) up to 4K.
• Video - Scenes (JSON): the scenes, as JSON.
• Webhook URL: a valid URL that receives the notification once the render is finished, with the video ID and the video URL included in the payload.

The frame shrinks to a rectangle. Everything outside that box disappears from the output file.

• Crop - X Coordinate and Crop - Y Coordinate: required, position of the top-left corner of the crop.
• Crop - Width and Crop - Height: required, in pixels, capped by the width and the height of the video.
• Video - Mute: mutes the original video audio.

The audio track is separated from the video file and saved on its own, ready for a step that only cares about sound.

• Video - URL: required, the public and downloadable URL of the video file.
• Webhook URL: a valid URL that receives the notification, with the video ID and URL included.

One frame is captured at a chosen moment and saved as an image, which gives a thumbnail without opening an editor.

• Video - Timestamp (Seconds): the point in time the frame is captured from, 5.2 meaning 5.2 seconds into the video.
• Video - Name: required, the name of the video, the label the image is filed under.

The widest operation of the node builds a video from images and clips, adds a generated voice-over with automated subtitles, and mixes in background music.

• Video - Duration: required, whether the final length follows the audio, the speech synthesis or all scenes.
• Video - Scenes (JSON): the scenes that make up the picture, given as JSON.
• Speech Synthesis - Text and Speech Synthesis - Voice: the script read aloud and the voice reading it.
• Video - Resolution: required, up to 4K (3840x2160).

Fetches video data from the API using the video ID, which is how a later branch learns where the finished file sits and under which name it was stored.

• Video ID: required, the ID of the video, usually {{ $json.id }} kept from the step that created it.

Volume is reduced to zero and the same video comes back, picture untouched, sound gone.

• Video - Name: required, the name of the video.
• Video - URL: required, the public and downloadable URL of the video file.
• Wait for Completion: on, the node pauses the workflow until the server is done and returns the full video object.

A second video sits on top of the first at a chosen anchor, the picture in picture arrangement people expect from a tutorial.

• Overlay Video - URL: required, the public and downloadable URL of the overlay video file.
• Overlay Video - Mute: required, whether the overlay keeps its own audio.
• Position: required, from Top Left to Center Bottom.
• Scale: scale percentage of the overlay video, 1 to 100.
• X Offset and Y Offset: pixels away from the position anchor.

The picture turns a quarter, a half or three quarters of a turn, and the file comes back in its new orientation.

• Video - Rotation (Degrees): 90, 180 or 270, positive values rotating clockwise and negative ones counter-clockwise.
• Video - Mute: whether the original video audio is dropped along the way.

Dimensions change according to the mode you pick, from a simple width target to an exact size that may distort the picture.

• Scale Mode: required, Scale to Width, Scale to Height, Scale to Fit, Scale to Fill, Scale Exact or Scale Keep Aspect Ratio.
• Width and Height: in pixels, even numbers, 2 at minimum.
• Video - Mute: mutes the original video audio.

One file goes in and several segments come out, cut where the picture changes or on a fixed rhythm.

• Split - Mode: required, automatic scene detection, a fixed interval or a number of segments.
• Split - Segment Length: required, the duration in seconds of each equal segment.
• Split - Min Scene Duration (Sec) and Split - Max Scene Duration (Sec): required, the bounds of a scene found automatically.
• Split - Scene Change Threshold: required, in a range of 0.1 to 1, lower values detecting more changes.

Two files are placed next to each other or one above the other inside a single frame.

• Secondary Video - URL: required, the public and downloadable URL of the secondary video file to stack.
• Secondary Video - Mute: required, whether the audio of the secondary video is kept.
• Layout: required, Horizontal side by side, Vertical one above the other.
• Video - Mute: drops the audio of the first video.