Actions25
- Sound Actions
- Speech Actions
- File Actions
- Transcription Actions
- Video Actions
- Add Audio to a Video
- Add Audio with Subtitles to a Video
- Add Subtitles to a Video
- Add Subtitles to a Video From a File
- Add Watermark to a Video
- Blur a Video
- Clip a Video
- Create a Slideshow
- Crop a Video
- Extract Audio From a Video
- Frame a Video
- Generate a Video
- Get a Specific Video
- Mute a Video
- Rotate a Video
- Split a Video Into Scenes
Overview
This node integrates with the Bookoly API to transcribe audio or video files into text. It is designed to convert spoken content from media files into written transcripts, optionally translating them into another language. This functionality is useful for creating subtitles, generating meeting notes, or archiving spoken content in a searchable text format.
Typical use cases include:
- Automatically transcribing podcasts or interviews.
- Generating captions for videos in multiple languages.
- Creating searchable archives of recorded meetings or lectures.
The node supports both synchronous transcription (waiting until the transcript is ready) and asynchronous transcription (returning immediately with an ID and letting you handle completion via webhook).
Properties
| Name | Meaning |
|---|---|
| Name | The name to assign to the generated transcript. |
| URL | The publicly accessible and downloadable URL of the audio or video file to be transcribed. |
| Language | The primary language spoken in the audio or video file. Supported languages include Afrikaans, Arabic, Armenian, Azerbaijani, Belarusian, Bosnian, Bulgarian, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Finnish, French, Galician, German, Greek, Hebrew, Hindi, Hungarian, Icelandic, Indonesian, Italian, Japanese, Kannada, Kazakh, Korean, Latvian, Lithuanian, Macedonian, Malay, Marathi, Maori, Nepali, Norwegian, Persian, Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovenian, Spanish, Swahili, Swedish, Tagalog, Tamil, Thai, Turkish, Ukrainian, Urdu, Vietnamese, Welsh. |
| Translation Language | Optionally translate the transcript into a different language. If no translation is needed, select "No Translation". Supported translation languages include Arabic, Bengali, Catalan, Chinese (Simplified and Traditional), Danish, Dutch, English, Finnish, French, German, Greek, Hindi (and Latin script), Indonesian, Italian, Japanese, Korean, Malay, Mandarin Chinese, Portuguese (including Brazilian), Russian, Spanish (including Latin America), Swedish, Thai, Turkish, Ukrainian, Vietnamese. |
| Wait for Completion | If enabled, the node waits and polls the server until the transcript generation is complete, then returns the full transcript object. If disabled, it returns only the transcript ID and creation timestamp immediately. |
| Webhook URL | A valid URL to receive webhook notifications when the transcript is ready. The notification includes the transcript ID and URL. |
Output
The node outputs JSON data representing the transcript information:
- If Wait for Completion is enabled, the output contains the full transcript object including the transcribed text, metadata, timestamps, and possibly translation if requested.
- If Wait for Completion is disabled, the output contains minimal information such as the transcript ID and creation timestamp, allowing the user to track progress externally or via webhook.
The node does not output binary data.
Dependencies
- Requires an active connection to the Bookoly API service.
- Needs an API key credential configured in n8n for authentication with the Bookoly API.
- Internet access to reach the public URLs of audio/video files and the Bookoly API endpoints.
Troubleshooting
- Invalid URL or inaccessible media file: Ensure the provided URL is publicly accessible and points directly to a downloadable audio or video file.
- Unsupported language code: Verify that the selected language codes for transcription and translation are supported by the node.
- API authentication errors: Confirm that the API key credential is correctly set up and has sufficient permissions.
- Timeouts or long processing times: For large files or complex transcriptions, enabling "Wait for Completion" may cause delays; consider using webhooks to handle asynchronous completion.
- Webhook failures: Make sure the webhook URL is reachable and can accept POST requests from the Bookoly service.
Common error messages:
"No handler found for Transcription.Transcribe Audio or Video": Indicates a misconfiguration or missing implementation for the specified resource-operation pair."Failed to execute createTranscript: <error message>": General failure during transcription request; check network connectivity, API limits, and input parameters.
Links and References
- Bookoly Official Website
- Bookoly API Documentation (assumed based on base URL)
- n8n Documentation on Creating Custom Nodes