Vocant AI icon

Vocant AI

Upload and process audio file with Vocant AI
Join our community

Actions3

Overview

This node integrates with Vocant AI to handle audio transcription workflows. It supports three main operations:

  • Upload File: Upload an audio file to Vocant AI for transcription processing.
  • Check Status: Check the current status of a transcription job using its Job ID.
  • Get Transcription: Retrieve the transcription result of a completed job by Job ID.

Typical use cases include automating transcription of audio files within workflows, monitoring transcription progress, and fetching transcription text for further processing or storage. For example, you can upload a recorded interview audio, periodically check if the transcription is ready, and then download the transcript automatically.

Properties

Name Meaning
Job ID The unique identifier of the transcription job to check status or retrieve the transcription result. This ID is returned after uploading a file.

Note: The "Job ID" property is required for both "Check Status" and "Get Transcription" operations.

Output

  • Check Status Operation: Outputs a JSON object representing the current status of the transcription job as returned by Vocant AI's API. This typically includes fields such as job state, progress, and timestamps.

  • Get Transcription Operation: Outputs a JSON object indicating success and the Job ID, along with a binary field containing the transcription text file encoded in base64. The binary data includes:

    • data: Base64-encoded transcription text content.
    • mimeType: Always "text/plain".
    • fileName: A filename in the format transcription_<jobId>.txt.

The node does not output binary data for the "Check Status" operation.

Dependencies

  • Requires an API key credential for authenticating requests to Vocant AI.
  • Makes HTTP requests to Vocant AI endpoints:
    • Presigned URL retrieval for uploads.
    • Status checking endpoint.
    • Transcription download endpoint.
  • Uses n8n helper methods for handling binary data and HTTP requests.

Troubleshooting

  • No binary data found error: When performing the "Upload File" operation, ensure that the specified binary input field contains valid audio data. The node expects binary data under the given field name; missing or incorrectly named binary inputs will cause this error.

  • Invalid or missing Job ID: For "Check Status" and "Get Transcription" operations, providing an incorrect or empty Job ID will result in API errors. Verify that the Job ID is correctly copied from the upload response.

  • API authentication errors: If the API key credential is invalid or missing, requests to Vocant AI will fail. Confirm that the API key is set up properly in n8n credentials.

  • Network or HTTP errors: Connectivity issues or unexpected API responses may cause failures. Review error messages and ensure Vocant AI service is reachable.

Links and References

Discussion