Audio

Transcribe Audio

Changed on

Transcribes an audio file with Whisper (served via OpenRouter's Groq provider). The audio is forwarded upstream and the transcription response is returned verbatim. Usage is billed to your Runchat credits based on the audio duration ($0.04 per hour of audio for whisper-large-v3-turbo, before credit markup).

post/transcribe

Request

  • Base URL
    https://runchat.com/api/v1
  • URL
    https://runchat.com/api/v1/transcribe
  • Auth
    HTTP bearer

Request body multipart/form-data

filestring binary required

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

modelstring

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).

languagestring

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

response_format'json' | 'verbose_json'

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

timestamp_granularities[]string[]

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

Response

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

textstring

The transcribed text.

languagestring

Detected or supplied language of the audio.

durationnumber

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

segmentsobject[]

Timestamped segments (present when segment granularity is requested).

wordsobject[]

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

Changes