Vocant AI icon

Vocant AI

Upload and process audio file with Vocant AI
Join our community

Actions3

Overview

The Vocant AI node enables interaction with the Vocant AI transcription service. It supports uploading audio files for transcription, checking the status of transcription jobs, and retrieving the transcription results once available.

This node is beneficial in scenarios where automated speech-to-text conversion is needed within an n8n workflow, such as transcribing interviews, meetings, podcasts, or any audio content for further processing, analysis, or storage.

Practical examples:

  • Uploading an audio recording to Vocant AI and receiving a job ID to track progress.
  • Periodically checking the status of a transcription job to know when it completes.
  • Downloading the final transcription text file for use in reports or downstream automation.

Properties

Name Meaning
Job ID The unique identifier of the transcription job to check its status or retrieve the transcription result. This ID is returned by the upload operation.

Output

The output JSON structure varies depending on the operation:

  • Get Transcription:
    • success: Boolean indicating if the retrieval was successful.
    • jobId: The transcription job ID.
    • Additionally, the node outputs a binary field named data containing the transcription text file encoded in base64, with MIME type text/plain and filename formatted as transcription_<jobId>.txt.

The binary output represents the transcription result as a plain text file, which can be used directly in subsequent workflow steps that handle text data or file storage.

Dependencies

  • Requires an API key credential for authenticating requests to the Vocant AI service.
  • Network access to https://app.vocant.ai endpoints.
  • Proper configuration of the API key credential in n8n.

Troubleshooting

  • Missing Binary Data Error: When uploading, if the specified binary property does not exist or contains no data, the node throws an error stating no binary data found for the given property name. Ensure the input binary field name matches exactly and contains valid audio data.

  • Invalid Job ID: For status checks or transcription retrieval, providing an incorrect or expired job ID will likely result in errors or empty responses. Verify the job ID is correct and was obtained from a successful upload.

  • API Authentication Errors: If the API key is missing, invalid, or revoked, requests will fail. Confirm the API key credential is correctly set up and active.

  • Network Issues: Connectivity problems to the Vocant AI API endpoints will cause request failures. Check network settings and firewall rules.

Links and References

Discussion