bookoly icon

bookoly

Interact with the bookoly API

File → Generate a Subtitle File

AI-generated

Summary

Generate a subtitle file from a video URL using speech synthesis or audio input, with configurable styling, language, and formatting options.

Inputs

  • name (required) — The name of the subtitle file
  • url (required) — The public and downloadable URL of the video file
  • source — Select the input source for subtitle generation (None to skip, Speech Synthesis, or Audio from video)
  • type — Choose the format for your subtitle. ASS is selected by default.
  • style — Select a subtitle style. The default is Highlight Current Word.
  • language — Select the language for subtitles
  • font_family — The default subtitle font family is Arial
  • font_size — The default subtitle font size is 20
  • word_color — The subtitle word color given in HEX e.g. #FEEE15 = Yellow
  • line_color — The subtitle line color given in HEX e.g. #FFFFFF = White
  • line_words — Defines how many words are displayed at a time. Min. = 1, Max. = 10
  • outline_width — The default subtitle outline width is 5
  • position — Specifies where subtitles are displayed on the video
  • ltr — Choose the subtitle text orientation
  • punctuation — Whether the subtitles will include punctuation. If disabled, subtitles will be plain text without any punctuation.
  • text_case — Select how the subtitle text should be formatted
  • wait — If enabled, the node pauses the workflow and checks the server until the subtitle file generation is finished, then returns the full subtitle file object. If disabled, only the ID and creation timestamp are returned.
  • webhook_url — Enter a valid URL to receive webhook notifications. Subtitle File ID and URL will be included.

Output shape

object

If wait is enabled, returns the full subtitle file object including ID and URL. If wait is disabled, returns only the ID and creation timestamp.

Discussion