Skip to main content

Endpoint

POST /v3/universal-ai/async (async) Model string pattern: audio/speech_to_text_async/{provider}[/{model}]

Input

FieldTypeRequiredDescription
filefile_inputYesAudio file ID from /v3/upload or direct file URL
languagestringNoLanguage code in ISO format (e.g., ‘en’, ‘fr’, ‘es’)
speakersintNoNumber of speakers present in the audio
profanity_filterboolNoWhether to filter profanity and replace inappropriate words with a series of asterisks
vocabularyarray[string]NoList of words or composed words to be detected by the speech to text engine

Output

FieldTypeRequiredDescription
textstringYes
diarizationobjectYes
    total_speakersintYes
    entriesarray[object]No
        segmentstringYes
        start_timestringYes
        end_timestringYes
        speakerintYes
        confidencefloatYes
    error_messagestringNo

Available Providers

ProviderModel StringPrice
amazonaudio/speech_to_text_async/amazon$0.024 per 60 secondes
assemblyaudio/speech_to_text_async/assembly$0.011 per 60 secondes
deepgram (base)audio/speech_to_text_async/deepgram/base$0.0169 per 60 secondes
deepgramaudio/speech_to_text_async/deepgram$0.0189 per 60 secondes
deepgram (enhanced)audio/speech_to_text_async/deepgram/enhanced$0.0189 per 60 secondes
deepgram (nova-3)audio/speech_to_text_async/deepgram/nova-3$0.0052 per 60 secondes
gladiaaudio/speech_to_text_async/gladia$0.0102 per 60 secondes
googleaudio/speech_to_text_async/google$0.024 per 60 secondes
microsoftaudio/speech_to_text_async/microsoft$0.0168 per 60 secondes
openaiaudio/speech_to_text_async/openai$0.006 per 60 secondes

Quick Start

This is an async feature. The initial response returns a job ID. Poll GET /v3/universal-ai/async/{job_id} until the job completes.
import requests

url = "https://api.edenai.run/v3/universal-ai/async"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}

payload = {
    "model": "audio/speech_to_text_async/amazon",
    "input": {
        "file": "YOUR_FILE_UUID_OR_URL",
        "language": "en"
    }
}

response = requests.post(url, headers=headers, json=payload)
print(response.json())