Create transcription

Changed on Sep 6, 2026

Transcribes audio into text (speech-to-text) with word-level timestamps. The request body is multipart/form-data carrying the audio file (or a URL to it).

post/v1/audio/transcriptions

Request

Base URL
https://api.llmgateway.io
Auth
HTTP bearer

Request body multipart/form-data

modelstring required

ID of the transcription (speech-to-text) model to use.

filestring binary

The audio file to transcribe. Required unless url is provided.

urlstring

URL of an audio file to download and transcribe upstream. Required unless file is provided.

languagestring

Language code (e.g. 'en'). When set, enables inverse text normalization so numbers and currencies are formatted in their written form.

diarizestring

When 'true', enables speaker diarization; each word in the response includes a speaker field.

filler_wordsstring

When 'true', filler words (e.g. 'uh', 'um') are kept in the transcript instead of being removed.

keytermstring

A key term to bias transcription toward (e.g. product names). Repeat the field for multiple terms.

Example request

{
  "model": "grok-stt-1-0",
  "language": "en"
}

Response

Transcription response.

textstring

languagestring

durationnumber

channelsobject[]

Changes

Sep 6, 20263ab255a22d1b Revision changes
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- breaking
  the response property / became nullable for the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history