STT Gateway icon

STT Gateway

Synchronous transcription via STT Gateway microservice

STT Gateway

AI-generated

Overview

This node provides synchronous speech-to-text transcription by sending audio URLs to an STT Gateway microservice. It is useful for converting audio files accessible via public URLs into text, supporting multiple providers and options like language specification, punctuation restoration, and text formatting. For example, it can be used to transcribe podcasts, interviews, or voice notes automatically within an n8n workflow.

Use Case Examples

  1. Transcribing a podcast episode by providing its public audio URL to get a text transcript.
  2. Automatically converting customer support call recordings into text for analysis.
  3. Using AssemblyAI as the provider with specific language and formatting options for accurate transcription.

Properties

Name Meaning
Base Path API base path appended to the Gateway URL, ignoring leading/trailing slashes.
Audio URL Public HTTP(S) URL to the audio file to be transcribed.
Provider Speech-to-text provider to use; can be default or AssemblyAI.
Language Explicit language code for the audio (e.g., 'en', 'ru', 'en-US'). Leave empty for auto-detect when supported.
Restore Punctuation Whether to request the provider to restore punctuation in the transcription.
Format Text Whether to format the text output with punctuation and capitalization.
Provider API Key Optional direct API key for the selected provider, if allowed by service policy.

Output

JSON

  • json - The transcription result returned from the STT Gateway microservice, including the transcribed text and related metadata.

Dependencies

  • An API key credential for the STT Gateway microservice (bozonxMicroservicesApi)

Troubleshooting

  • Ensure the Gateway URL in credentials includes the protocol (http:// or https://).
  • Verify the Gateway URL is correctly set and accessible.
  • Make sure the Audio URL is a valid public HTTP(S) URL and is not empty.
  • If using a specific provider like AssemblyAI, provide the API key if required by the service policy.
  • Handle errors gracefully by enabling 'Continue On Fail' to capture errors per item.

Links

Discussion