Skip to navigation

Limits

The limits on audio, questions, context and request rate, and the error a request over each one returns.

A request takes one audio file of 5 seconds to 5 minutes and up to 25,000,000 bytes, up to 20 noul, choice and score questions and up to 5 span questions. Each organization can send 60 requests per minute. Each table below names the error a request outside that limit returns. See Errors for what each code means.

Audio

LimitValueOutside the limit
Duration5 seconds to 5 minutesaudio_too_short or audio_too_long
Request size25,000,000 bytes, the request and file parts togetherpayload_too_large
FormatMP3 or WAVaudio_format_unsupported
Files1 per requestmessage_invalid

To evaluate a recording longer than 5 minutes, split it into files of 5 minutes or less and send one request per file. Keep every part at least 5 seconds long.

Which limit a file reaches first

Uncompressed WAV usually reaches the size limit before 5 minutes. The request part adds little, so the size of the audio file decides which limit applies:

AudioSize of 5 minutesLongest file that fits
WAV, 16-bit, 48 kHz stereo57.6 MBAbout 2 min 10 s
WAV, 16-bit, 44.1 kHz stereo52.9 MBAbout 2 min 20 s
WAV, 16-bit, 48 kHz mono28.8 MBAbout 4 min 20 s
WAV, 16-bit, 44.1 kHz mono26.5 MBAbout 4 min 40 s
WAV, 16-bit, 24 kHz mono14.4 MB5 minutes
WAV, 16-bit, 16 kHz mono9.6 MB5 minutes
MP3, 128 kbps4.8 MB5 minutes

To fit a longer WAV file under the size limit, convert it to 16 kHz mono. The model hears audio as one channel at 16 kHz, so a higher sample rate or a second channel does not improve answers, and 5 minutes of 16 kHz mono WAV fits in 9.6 MB:

Shell
ffmpeg -i call.wav -ac 1 -ar 16000 -sample_fmt s16 call_mono.wav

Questions and context

LimitValueOutside the limit
Questions1 to 25 per request: up to 20 noul, choice and score questions together, and up to 5 span questionsmessage_invalid
Question ID1 to 256 charactersmessage_invalid
instructions1 to 500 charactersquestion_invalid
noul criteriatrue and false of 1 to 300 characters eachquestion_invalid
choice options2 to 20 per question, each with a unique name of 1 to 50 characters and an optional description of 1 to 100 charactersquestion_invalid
score levels2 to 10 per question, each unique and 1 to 150 charactersquestion_invalid
contextUp to 1,000 charactersmessage_invalid

Rate limits

LimitValueOutside the limit
Requests60 per minute per organization429 Too Many Requests

The limit counts requests to every Audio Decisions endpoint over a sliding 60-second window, and every API key in an organization shares it. A 429 carries a Retry-After header with the number of seconds to wait before retrying. See Handling errors.

Next steps