Speech-to-Text API

The audio file to transcribe. You can either upload a file object to the API or provide a public URL to download the audio file. The upload size is limited to 100MB. When providing the audio file via URL the maximum file size is 500MB.

Supported audio and video file formats: mp3, wav, flac, aac, opus, ogg, m4a, mp4, mpeg, mov, webm, and more.

Set this parameter to true to enable speaker diarization. This will add speaker labels to the transcript.

When using speaker diarization you may also add the parameters min_speakers and max_speakers to your API call to improve the accuracy of the speaker labels. The min_speakers and max_speakers parameters specify the minimum and maximum number of speakers in the audio file.

Important: Make sure to set the response_format parameter to verbose_json to be able to access the speaker labels. You can find an example response above.

Note: As OpenAI doesn't support speaker diarization, you can't use the speaker_labels parameter with the OpenAI Python or Javascript library.

The language of the input audio. If no language is provided we detect the language automatically. Supplying the input language can improve accuracy and latency.

Supported languages: english, chinese, german, spanish, russian, korean, french, japanese, portuguese, turkish, polish, catalan, dutch, arabic, swedish, italian, indonesian, hindi, finnish, vietnamese, hebrew, ukrainian, greek, malay, czech, romanian, danish, hungarian, tamil, norwegian, thai, urdu, croatian, bulgarian, lithuanian, latin, maori, malayalam, welsh, slovak, telugu, persian, latvian, bengali, serbian, azerbaijani, slovenian, kannada, estonian, macedonian, breton, basque, icelandic, armenian, nepali, mongolian, bosnian, kazakh, albanian, swahili, galician, marathi, punjabi, sinhala, khmer, shona, yoruba, somali, afrikaans, occitan, georgian, belarusian, tajik, sindhi, gujarati, amharic, yiddish, lao, uzbek, faroese, haitian creole, pashto, turkmen, nynorsk, maltese, sanskrit, luxembourgish, myanmar, tibetan, tagalog, malagasy, assamese, tatar, hawaiian, lingala, hausa, bashkir, javanese, sundanese, cantonese, burmese, valencian, flemish, haitian, letzeburgesch, pushto, panjabi, moldavian, moldovan, sinhalese, castilian, mandarin

The format in which the generated transcript is returned. See example API responses above. Must be one of the following: json, text, srt, verbose_json, or vtt.

vtt and srt are file formats that can be used to add subtitles to videos. verbose_json contains additional information such as the duration of the audio and timestamps for each audio segment.