Telnyx AI icon

Telnyx AI

Interact with Telnyx AI API

Actions15

Overview

The node "Telnyx AI" provides integration with the Telnyx AI API, enabling various AI-powered functionalities. Specifically, for the Voice resource and Speech to Text operation, it transcribes audio files into text using advanced speech recognition models.

This node is beneficial in scenarios where automated transcription of audio content is needed, such as:

  • Transcribing customer support calls for analysis.
  • Converting meeting recordings into searchable text.
  • Generating subtitles or captions from audio/video content.

Practical example: You have an MP3 recording of a podcast episode and want to generate a transcript automatically. By providing the audio file or its URL and selecting a transcription model, this node returns the text transcription.

Properties

Name Meaning
File The audio input to transcribe. Can be provided as a local file or a URL pointing to the audio.
Model The transcription model to use. Options are:
- distil-whisper/distil-large-v2
- openai/whisper-large-v3-turbo
Additional Options Optional settings to customize the transcription output:
• Response Format: json or verbose_json
• Timestamp Granularities (boolean): When using verbose_json, whether to include timestamps for each word in the transcription

Output

The node outputs JSON data containing the transcription results. Depending on the selected response format:

  • json: A standard JSON object with the transcribed text.
  • verbose_json: A more detailed JSON including additional metadata such as word-level timestamps if enabled.

No binary data output is indicated for this operation.

Dependencies

  • Requires an active connection to the Telnyx AI API.
  • Needs an API key credential configured in n8n for authentication.
  • Internet access to send audio files or URLs to the Telnyx service.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Providing an unsupported audio file format or corrupted file may result in transcription failure.
    • Network connectivity problems can prevent reaching the Telnyx API endpoint.

  • Error messages:

    • Authentication errors: Verify that the API key credential is correctly set up.
    • File not found or inaccessible URL: Ensure the file path or URL is correct and accessible.
    • Unsupported model or invalid parameters: Confirm that the selected model and options are valid according to the property definitions.

Links and References

Discussion