Skip to main content
POST
Transcribe Audio

Authorizations

Authorization
string
header
required

Bearer token authentication using Runchat API key. API keys can be created from the account menu

Body

multipart/form-data
file
file
required

The audio file to transcribe (flac, mp3, mp4, mpeg, mpga, m4a, ogg, wav, webm). Maximum size 25MB.

model
string
default:openai/whisper-large-v3-turbo

The Whisper model to use. Defaults to openai/whisper-large-v3-turbo (bare Groq-style names like whisper-large-v3-turbo are accepted as aliases).

language
string

Optional ISO-639-1 language code of the audio (e.g. en). Improves accuracy and latency when known.

response_format
enum<string>
default:verbose_json

The response format. Defaults to verbose_json, which includes the audio duration and timestamped segments. (text/srt/vtt are not supported.)

Available options:
json,
verbose_json
timestamp_granularities[]
enum<string>[]

Timestamp detail for verbose_json responses. Repeat the field to request both. Defaults to segment and word.

Available options:
segment,
word

Response

Successful transcription. The upstream response body is returned verbatim - an object for json/verbose_json formats, plain text for text.

Groq transcription response, returned verbatim. Shape follows the requested response_format — verbose_json (shown here) includes duration and timestamped segments.

text
string

The transcribed text.

language
string

Detected or supplied language of the audio.

duration
number

Duration of the audio in seconds. Used for credit billing.

segments
object[]

Timestamped segments (present when segment granularity is requested).

words
object[]

Word-level timestamps (present when word granularity is requested).