This troubleshooting guide is designed to help you resolve the most common issues users face when working with pyannoteAI.

​
‘Could not load audio’ Error

Description: This error occurs when pyannoteAI is unable to access an audio file. This issue usually stems from an incorrect or inaccessible file URL.

​
Possible Causes and Solutions

  • Invalid or Indirect URL: Ensure that the audio file URL is a direct link and publicly accessible. Some cloud storage services provide indirect URLs that require authentication or a confirmation page before downloading. Make sure the URL points directly to the file itself without requiring any additional steps.

  • URL Permissions: The URL should not require login credentials or any kind of permissions that prevent pyannoteAI from accessing the audio file. Double-check that the file is publicly available, and test the link in an incognito browser window to confirm accessibility.

  • URL Expiry: If you’re using temporary URLs (e.g., generated by cloud storage providers), ensure that the URL is valid for the entire duration of the processing job. Expired links will cause this error.

  • File Size Limit: While the “Could not load audio” error is usually related to accessibility, it can also occur if the file size is too large. Ensure the file size is within the recommended limits to avoid any loading issues.

​
Errors creating the job

  • Invalid request: Check the body for missing or incorrect parameters. Ensure the request body is correctly formatted and all required fields are included.
  • file_not_audio: The provided file is not in an accepted audio format. Ensure the URL points to an audio file and not a cloud storage provider like Dropbox, Box, Google Drive, or similar services. Direct link is required. For files stored in object storage (e.g., S3), make sure the URL is signed with an expiration to grant temporary access.
  • file_too_large: The file size exceeds the allowed limit. The maximum size is 1GiB for identify and diarization jobs, and 100MiB for voiceprint jobs. Please reduce the file size before uploading.
  • http_error: The URL returned a non-2xx status code. Verify the URL is correct and accessible.
  • ssl_error: The SSL certificate for the URL is invalid. Check the certificate validity or use an HTTPS-compliant URL.
  • too_many_redirects: The URL is redirecting more than 2 times. Simplify the URL or reduce the number of redirects.
  • connection_failed: The server hosting the file is not accessible. Confirm that the URL is correct, and the server is online and reachable.
  • http_timeout: The URL took more than 10 seconds to respond. Please ensure the server hosting the file is properly configured and responds within the allowed time.
  • empty_response: The URL returned an empty response. Ensure the file is properly uploaded and accessible via the URL.
  • unknown_error: An unknown error occurred downloading the audio. Please contact support for assistance.

​
Possible errors running the job

Once a job is created, there are a few possible errors that can occur during processing:

  • no_speech_detected: No speech was detected in the audio file.
  • invalid_voiceprint: The provided voiceprint is invalid (only applicable to identify jobs).