Transcribe — From audio file asynchronously

POST 
/transcribe-async

Generate a transcript from an audio file. Only audio/* mime types are supported. The maximum duration is 60 minutes. The result of the request is posted to the callback URL once available.

Request

application/json

Body

required

speech_localespeech_locale (string)required
The spoken or written locale of the transcript, representing both the language and its specific regional variant.
Possible values: [ENGLISH_US, ENGLISH_UK, SPANISH_ES, SPANISH_MX, FRENCH_FR, ARABIC_EG, ARABIC_LB, ARABIC_MA, ARABIC_SA, ARMENIAN_AM, BENGALI_IN, CANTONESE_CN, CROATIAN_HR, FILIPINO_PH, GERMAN_DE, GREEK_GR, GUJARATI_IN, HEBREW_IL, HINDI_IN, ITALIAN_IT, JAPANESE_JP, KHMER_KH, KOREAN_KR, MANDARIN_CN, PERSIAN_IR, POLISH_PL, PORTUGUESE_PT, PUNJABI_IN, RUSSIAN_RU, SERBIAN_RS, TAMIL_IN, TELUGU_IN, THAI_TH, URDU_IN, VIETNAMESE_VN]
Example: ENGLISH_US
file_urlstringrequired

The URL of the audio file to download & listen to.

split_by_sentenceboolean
Indicates whether to segment transcription results at sentence boundaries. Default is false, meaning that a single transcript item may encompass multiple sentences, provided they are not delineated by pauses (silence) in the audio.
Default value: false
client_request_idcopilot_client_request_id (string)

An optional unique client-made id for this request. When specified, this id is included in the Json payload that will be sent asynchronously. This can help clients both guarantee idempotency and correlate asynchronous responses with their requests.

Note: this id must be different for every request. It is recommended to use a randomly generated UUID.

Possible values: <= 128 characters

Responses

200

Request received and processing started.

application/json

Schema

Schema

oneOf

async_request_ongoing

iduuidrequired

The id of the asynchronous request.

Example: 98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6

client_request_idcopilot_client_request_id (string)

An optional unique client-made id for this request. When specified, this id is included in the Json payload that will be sent asynchronously. This can help clients both guarantee idempotency and correlate asynchronous responses with their requests.

Note: this id must be different for every request. It is recommended to use a randomly generated UUID.

Possible values: <= 128 characters

statusasync_request_status (string)required

Possible values: [ongoing, failed, succeeded]

async_request_failed

iduuidrequired

The id of the asynchronous request.

Example: 98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6

client_request_idcopilot_client_request_id (string)

An optional unique client-made id for this request. When specified, this id is included in the Json payload that will be sent asynchronously. This can help clients both guarantee idempotency and correlate asynchronous responses with their requests.

Note: this id must be different for every request. It is recommended to use a randomly generated UUID.

Possible values: <= 128 characters

statusasync_request_status (string)required

Possible values: [ongoing, failed, succeeded]

payload

object

required

error_codeintegerrequired

Example: 422

error_messagestring

Example: We can't generate the note when the transcript is too short.

async_transcription_succeeded

iduuidrequired

The id of the asynchronous request.

Example: 98FCE1EF-DBCA-41EF-8BC7-4D1621AC07C6

client_request_idcopilot_client_request_id (string)

An optional unique client-made id for this request. When specified, this id is included in the Json payload that will be sent asynchronously. This can help clients both guarantee idempotency and correlate asynchronous responses with their requests.

Note: this id must be different for every request. It is recommended to use a randomly generated UUID.

Possible values: <= 128 characters

statusasync_request_status (string)required

Possible values: [ongoing, failed, succeeded]

payload

object

The generated transcript.

transcript

object[]

required

Array [

textstringrequired

The transcribed text.

Example: Also, I’m allergic to peanuts.

speakercopilot_speaker (string)required

Who said the text in this transcript item.

Possible values: [doctor, patient, unspecified]

Example: doctor

start_offset_msintegerrequired

Start time of this transcription item as the offset, in milliseconds, from the start of the audio file.

Example: 65100

end_offset_msintegerrequired

End time of this transcription item as the offset, in milliseconds, from the start of the audio file. Equals the start_time_ms plus the duration of the related transcribed audio portion.

Example: 69300

]

Example (from schema)

{}