/v1/audio/transcriptionsTranscribe audio
Speech to text. Send a multipart file (up to 25 MiB and 4 hours). JSON also works: {"model", "input_audio": {"data": "<base64>", "format": "wav"}}. response_format: text returns plain text; json and verbose_json return the provider's JSON, including its usage.
Refused: stream, srt and vtt formats, and diarization fields.
Authentication: Bearer API key in the Authorization header
Request body
modelstringrequiredA speech-to-text model slug.
filestringrequiredThe audio: flac, m4a, mp3, mp4, mpeg, ogg, opus, wav or webm.
languagestringISO language hint, for example
en.promptstringVocabulary or context hint.
response_formatenumtemperaturenumbertimestamp_granularities[]array<enum>Requires
verbose_json.
Responses
200The transcript.
Response
textstringusageobjectThe provider's usage:
{type: duration, seconds}or token counts.
400Invalid request. param names the field; code says why (invalid_parameter, unsupported_parameter, unsupported_capability, refusal, previous_response_not_found). Not charged.
Response
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
401The key is missing, malformed, expired or revoked.
Response
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
402The organization must act first: card_required, email_unverified, org_under_review, free_tier_requires_payment or promotion_ended. The message names the step; retrying does not help.
Response
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
429insufficient_quota (out of credits, over a spend limit, or the model needs a purchase) and promo_credits_now (a free promotion is used up): add credits, the message names the step. rate_limit_exceeded, free_limit_reached, admission_capacity_exceeded: wait Retry-After seconds and retry.
Response
errorobjecterror
messagestringWhat went wrong and how to fix it.
typestringFor example
invalid_request_error,authentication_error,permission_error,rate_limit_error,insufficient_quota,api_error.codestringThe stable error code.
paramstring | nullThe request field at fault, when there is one.
refusal_reasonenumPresent only on
code: refusal.
Request
curl https://api.experientiallabs.ai/v1/audio/transcriptions \
-H "Authorization: Bearer YOUR_API_KEY" \
-F model=whisper-1 \
-F file=@standup.m4a
Response
{
"text": "Yesterday I shipped the retry fix. Today I am on the docs.",
"usage": {
"type": "duration",
"seconds": 6
}
}https://api.experientiallabs.ai/v1/audio/transcriptions