Skip to main content
post/audio-to-text
Request example
Response
post/audio-to-text

Authorization

Authorizationstringheaderrequired#

Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).

Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).

Body

multipart/form-data
filefilerequired#
Audio file to transcribe. Accepted MIME types: audio/mp3, audio/m4a (also accepted as audio/x-m4a), audio/wav, audio/amr, audio/mpga. Other types, including the common audio/mpeg, are rejected with unsupported_audio_type. Maximum size 30 MB.
userstring#
End-user identifier, defined by your app and unique within it. See End User Identity.

Responses

application/json
Successfully converted audio to text.
textstring#
Output text from speech recognition.