The File Upload API allows you to submit audio files for transcription. Files are processed asynchronously, and you can check the status using the Get File Status endpoint.
Endpoint POST https://infer.voice.intron.io/file/v1/upload
Authentication All requests require a Bearer token in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Basic request and response sample cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="myfile"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"'
cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="myfile"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"' \ --form 'use_language_asr_input="sw"'
Format Extensions WAV .wav MP3 .mp3 MP4 .mp4 M4A .m4a OGG .ogg WebM .webm FLAC .flac
Header Value Required AuthorizationBearer YOUR_API_KEYYes Content-Typemultipart/form-dataYes
Request Body form-data Field Type Description Required Options Default audio_file_nameString non-unique file name yes audio_file_blobString url to a readable file yes Post processing options use_diarizationString get the transcript text as a diarized response no TRUE | FALSEuse_template_idString use a custom prompt id for the transcript post-processing no use_categoryString set the category of post-processing to use on the file no file_category_telehealth use_language_asr_inputString set the input language code no en
Supported Languages All languages
African languages
Language Code Afrikaans af Akan ak Amharic am Arabic ar Bemba bem Bulgarian bg Czech cs Danish da German de Greek el English en Spanish es Estonian et Finnish fi French fr Fulani ff Ga gaa Hausa ha Croatian hr Hungarian hu Igbo ig Italian it Lithuanian lt Latvian lv Luganda lg Maltese mt Dutch nl Northern Sotho nso Nyankole nyn Oromo om Pidgin pcm Polish pl Portuguese pt Romanian ro Russian ru Kinyarwanda rw Slovak sk Slovenian sl Shona sn Sotho st Swedish sv Swahili sw Tswana tn Twi tw Ukrainian uk Wolof wo Xhosa xh Yoruba yo Zulu zu
Language Code Afrikaans af Akan ak Amharic am Arabic ar Bemba bem Fulani ff Ga gaa Hausa ha Igbo ig Luganda lg Northern Sotho nso Nyankole nyn Oromo om Pidgin pcm Kinyarwanda rw Shona sn Sotho st Swahili sw Tswana tn Twi tw Wolof wo Xhosa xh Yoruba yo Zulu zu
Post processing options for the file categories
file_category_general
file_category_telehealth
file_category_procedure
file_category_call_center
file_category_legal
file_category_meeting_notes
The post processing options only apply to English transcriptions
General
Telehealth
Procedure
Call center
Legal
Meeting notes
Field Type Description Required Options Default get_summaryString get a summary of the transcript no TRUE | FALSEFALSE
Sample request using this option cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="my_file_2"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"' \ --form 'use_category="file_category_general"' \ --form 'get_summary="TRUE"'
Field Type Description Required Options Default get_summaryString get a summary of the transcript no TRUE | FALSEFALSE get_entity_listString get extracted entities from the transcript no TRUE | FALSEFALSE get_treatment_planString get extracted treatment plan from the transcript no TRUE | FALSEFALSE get_soap_noteString get extracted SOAP note from the transcript no TRUE | FALSEFALSE get_clerkingString get extracted clerking from the transcript no TRUE | FALSEFALSE get_icd_codesString get the extracted icd/billing codes no TRUE | FALSEFALSE get_suggestionsString get suggestions of important questions to ask or instructions to give patient no TRUE | FALSEFALSE get_differential_diagnosisString get the differential diagnosis of the patient no TRUE | FALSEFALSE get_followup_instructionsString get follow up instructions for the patient no TRUE | FALSEFALSE get_practice_guidelinesString get practice guidelines for the patient no TRUE | FALSEFALSE
Sample request using this option cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="my_file_2"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"' \ --form 'use_category="file_category_telehealth"' \ --form 'get_summary="TRUE"' \ --form 'get_entity_list="TRUE"' \ --form 'get_treatment_plan="TRUE"' \ --form 'get_soap_note="TRUE"' \ --form 'get_clerking="TRUE"' \ --form 'get_icd_codes="TRUE"' \ --form 'get_suggestions="TRUE"' \ --form 'get_differential_diagnosis="TRUE"' \ --form 'get_followup_instructions="TRUE"' \ --form 'get_practice_guidelines="TRUE"' \
Field Type Description Required Options Default get_summaryString get a summary of the transcript no TRUE | FALSEFALSE get_entity_listString get extracted entities from the transcript no TRUE | FALSEFALSE get_treatment_planString get extracted treatment plan from the transcript no TRUE | FALSEFALSE get_op_noteString get the extracted operation note no TRUE | FALSEFALSE get_icd_codesString get the extracted icd/billing codes no TRUE | FALSEFALSE get_suggestionsString get suggestions of important questions to ask or instructions to give patient no TRUE | FALSEFALSE
Sample request using this option cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="my_file_2"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"' \ --form 'use_category="file_category_procedure"' \ --form 'get_summary="TRUE"' \ --form 'get_entity_list="TRUE"' \ --form 'get_treatment_plan="TRUE"' \ --form 'get_op_note="TRUE"' \ --form 'get_icd_codes="TRUE"' \ --form 'get_suggestions="TRUE"' \
Field Type Description Required Options Default get_summaryString get a summary of the transcript no TRUE | FALSEFALSE get_call_center_resultsString get the resolution of a call no TRUE | FALSEFALSE get_call_center_agent_scoreString get the performance score for the agent in a call no TRUE | FALSEFALSE get_call_center_agent_score_categoryString get the performance assessment no TRUE | FALSEFALSE get_call_center_product_infoString get the product information discussed in the call no TRUE | FALSEFALSE get_call_center_product_insightsString get ideas to improve the product based on customer feedback in the call no TRUE | FALSEFALSE get_call_center_complianceString get the compliance check of the call no TRUE | FALSEFALSE get_call_center_feedbackString get the feedback of the call no TRUE | FALSEFALSE get_call_center_sentimentString get caller sentiment analysis no TRUE | FALSEFALSE
Sample request using this option cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="my_file_2"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"' \ --form 'use_category="file_category_call_center"' \ --form 'get_summary="TRUE"' \ --form 'get_call_center_results="TRUE"' \ --form 'get_call_center_agent_score="TRUE"' \ --form 'get_call_center_agent_score_category="TRUE"' \ --form 'get_call_center_product_info="TRUE"' \ --form 'get_call_center_product_insights="TRUE"' \ --form 'get_call_center_compliance="TRUE"' \ --form 'get_call_center_feedback="TRUE"' \ --form 'get_call_center_sentiment="TRUE"' \
Field Type Description Required Options Default get_legal_court_hearingString get the transcript in court hearing format no TRUE | FALSEFALSE
Sample request using this option cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="my_file_2"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"' \ --form 'use_category="file_category_legal"' \ --form 'get_legal_court_hearing="TRUE"' \
Field Type Description Required Options Default get_summaryString get a comprehensive summary of the meeting no TRUE | FALSEFALSE get_meeting_notes_participantsString get the list of meeting participants and their roles no TRUE | FALSEFALSE get_meeting_notes_decisionsString get the key decisions made during the meeting no TRUE | FALSEFALSE get_meeting_notes_action_itemsString get list of action items and their assigned owners no TRUE | FALSEFALSE get_meeting_notes_key_topicsString get the main topics discussed during the meeting no TRUE | FALSEFALSE get_meeting_notes_next_stepsString get follow-up steps and next meeting plans no TRUE | FALSEFALSE
Sample request using this option cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="my_file_2"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"' \ --form 'use_category="file_category_meeting_notes"' \ --form 'get_summary="TRUE"' \ --form 'get_meeting_notes_participants="TRUE"' \ --form 'get_meeting_notes_decisions="TRUE"' \ --form 'get_meeting_notes_action_items="TRUE"' \ --form 'get_meeting_notes_key_topics="TRUE"' \ --form 'get_meeting_notes_next_steps="TRUE"' \
Request and response with custom template id cURL
Python
JavaScript
Response on upload
Response when file processsing completed
curl --location 'https://infer.voice.intron.io/file/v1/upload' \ --header 'Authorization: Bearer api-key' \ --form 'audio_file_name="my_file_2"' \ --form 'use_template_id="a3f32e46-afa4-42cb-9155-522dcf9xyxyxd"' \ --form 'audio_file_blob=@"/C:/Users/aaaa/file.wav"'
Rate Limits Next Steps After uploading a file, use the Get File Status endpoint to check the transcription progress and retrieve results.
