audio.transcriptions

Create Transcription

Changed on

Create Transcription

post/v1/audio/transcriptions

Request

Request body multipart/form-data

modelstring required

ID of the model to be used.

filestring binary

The File object (not file name) to be uploaded. To upload a file and specify a custom file name you should format your request as such:

file=@path/to/your/file.jsonl;filename=custom_name.jsonl

Otherwise, you can just keep the original file name:

file=@path/to/your/file.jsonl
file_urlstring uri nullable

Url of a file to be transcribed

file_idstring nullable

ID of a file uploaded to /v1/files

languagestring nullable

Language of the audio, e.g. 'en'. Providing the language can boost accuracy.

temperaturenumber nullable
streamfalse
diarizeboolean
context_biasstring[]
timestamp_granularitiesTimestampGranularity[]

Granularities of timestamps to include in the response.

Example request

{
  "model": "voxtral-mini-latest"
}

Response

Successful Response

modelstring required
textstring required
languagestring nullable required

Changes

    • breaking

      response property segments/items/end list-of-types was widened by adding types null to media type application/json of response 200

    • breaking

      response property segments/items/start list-of-types was widened by adding types null to media type application/json of response 200

    • info

      added the optional property / to the response with the status