import os
from assemblyai.prerecorded.v2 import Transcriber
transcriber = Transcriber(api_key=os.environ["ASSEMBLYAI_API_KEY"])
# `submit` queues the job and returns right away; `transcribe` submits and polls.
transcript = transcriber.submit("https://assembly.ai/wildfires.mp3")
print(transcript.id, transcript.status)
{
"error": "Authentication error, API token missing/invalid"
}
{
"error": "Cannot access uploaded file"
}
{
"error": "Not found"
}
{
"error": "Too Many Requests"
}
{
"error": "Internal server error. Please retry your request. If the error persists, please contact support@assemblyai.com for more information."
}
API reference
Transcribe audio
To use our EU server for transcription, replace api.assemblyai.com with api.eu.assemblyai.com.
Create a transcript from a media file that is accessible via a URL.
POST
/
v2
/
transcript
import os
from assemblyai.prerecorded.v2 import Transcriber
transcriber = Transcriber(api_key=os.environ["ASSEMBLYAI_API_KEY"])
# `submit` queues the job and returns right away; `transcribe` submits and polls.
transcript = transcriber.submit("https://assembly.ai/wildfires.mp3")
print(transcript.id, transcript.status)
Enable Auto Chapters, can be true or false. Requires punctuate to be true, and cannot be enabled together with summarization. Deprecated - use LLM Gateway instead for more flexible chapter summaries. See the updated Auto Chapters page for details.
Note: This parameter is only supported for the Universal-2 model.
The confidence threshold for the Content Moderation model. Values must be between 25 and 100. Requires content_safety to be enabled; otherwise it's ignored.
Required range: 25 <= x <= 100
custom_spelling
object[]
Customize how words are spelled and formatted using to and from values. Each to value must be a single word, and each from phrase can contain at most 5 words. See Custom Spelling for more details.
Show child attributes
disfluencies
boolean
Transcribe Filler Words, like "umm", in your media file; can be true or false. Supported on AssemblyAI-STT-3.7 and Universal-2. Defaults to true when speech_models includes assemblyai-stt-3-7 in any position, or is omitted and the request uses assemblyai-stt-3-7 by default, and to false otherwise.
domain
enum<string> | null
Enable domain-specific transcription models to improve accuracy for specialized terminology. Set to "medical-v1" to enable Medical Mode for improved accuracy of medication names, both generic and brand-name. Set to "veterinary-v1" to enable Veterinary Mode (beta) for improved accuracy of veterinary terminology.
Medical Mode supported languages: English (en), Spanish (es), German (de), French (fr). If medical-v1 is used with an unsupported language, the parameter is ignored and a warning is returned.
Improve accuracy with up to 200 (for Universal-2) or 1000 (for AssemblyAI-STT-3.7) domain-specific words or phrases (maximum 6 words per phrase). See Keyterms Prompting for more details.
language_code
enum<string>string
The language of your audio file. Possible values are found in Supported Languages.
If you don't specify a language, it's detected automatically. Can be used with language_detection set to false, but not with language_detection set to true.
Available options:
en,
en_au,
en_uk,
en_us,
es,
fr,
de,
it,
pt,
nl,
af,
sq,
am,
ar,
hy,
as,
az,
ba,
eu,
be,
bn,
bs,
br,
bg,
my,
ca,
zh,
yue,
hr,
cs,
da,
et,
fo,
fi,
gl,
ka,
el,
gu,
ht,
ha,
haw,
he,
hi,
hu,
is,
id,
ja,
jw,
kn,
kk,
km,
ko,
lo,
la,
lv,
ln,
lt,
lb,
mk,
mg,
ms,
ml,
mt,
mi,
mr,
mn,
ne,
no,
nn,
oc,
pa,
ps,
fa,
pl,
ro,
ru,
sa,
sr,
sn,
sd,
si,
sk,
sl,
so,
su,
sw,
sv,
tl,
tg,
ta,
tt,
te,
th,
bo,
tr,
tk,
uk,
ur,
uz,
vi,
cy,
yi,
yo,
xh,
zu
language_codes
enum<string>[] | null
The language codes of your audio file. Used for Code switching. On AssemblyAI-STT-3.7, accepts any number of supported languages, and English isn't required. On Universal-2, accepts at most two languages, and one of them must be en. Can't be used together with language_code or language_detection.
The language of your audio file. Possible values are found in Supported Languages.
Available options:
en,
en_au,
en_uk,
en_us,
es,
fr,
de,
it,
pt,
nl,
af,
sq,
am,
ar,
hy,
as,
az,
ba,
eu,
be,
bn,
bs,
br,
bg,
my,
ca,
zh,
yue,
hr,
cs,
da,
et,
fo,
fi,
gl,
ka,
el,
gu,
ht,
ha,
haw,
he,
hi,
hu,
is,
id,
ja,
jw,
kn,
kk,
km,
ko,
lo,
la,
lv,
ln,
lt,
lb,
mk,
mg,
ms,
ml,
mt,
mi,
mr,
mn,
ne,
no,
nn,
oc,
pa,
ps,
fa,
pl,
ro,
ru,
sa,
sr,
sn,
sd,
si,
sk,
sl,
so,
su,
sw,
sv,
tl,
tg,
ta,
tt,
te,
th,
bo,
tr,
tk,
uk,
ur,
uz,
vi,
cy,
yi,
yo,
xh,
zu
language_confidence_threshold
number<float>
default:0
The confidence threshold for the automatically detected language.
An error will be returned if the language confidence is below this threshold.
Defaults to 0. Can only be set when language_detection is enabled. See Automatic Language Detection for more details.
Required range: 0 <= x <= 1
language_detection
boolean
Automatic language detection identifies the spoken language. See Model selection for how requests are routed to a speech model. It's applied automatically when you don't specify a language_code. Set to false only together with a language_code; disabling it without specifying a language returns an error.
Redact PII from the transcribed text using the Redact PII model, can be true or false. Requires format_text to be true. See PII Redaction for more details.
redact_pii_audio
boolean
default:false
Generate a copy of the original media file with spoken PII "beeped" out, can be true or false. Requires redact_pii to be true. See PII redaction for more details.
Controls the filetype of the audio created by redact_pii_audio. Currently supports mp3 (default) and wav. See PII redaction for more details.
Available options:
mp3,
wav
Example:
"mp3"
redact_pii_policies
enum<string>[]
The list of PII Redaction policies to enable. See PII redaction for more details.
The type of PII to redact
Available options:
account_number,
banking_information,
blood_type,
credit_card_cvv,
credit_card_expiration,
credit_card_number,
date,
date_interval,
date_of_birth,
drivers_license,
drug,
duration,
email_address,
event,
filename,
gender,
gender_sexuality,
healthcare_number,
injury,
ip_address,
language,
location,
location_address,
location_address_street,
location_city,
location_coordinate,
location_country,
location_state,
location_zip,
marital_status,
medical_condition,
medical_process,
money_amount,
nationality,
number_sequence,
occupation,
organization,
organization_medical_facility,
passport_number,
password,
person_age,
person_name,
phone_number,
physical_attribute,
political_affiliation,
religion,
sexuality,
statistics,
time,
url,
us_social_security_number,
username,
vehicle_id,
zodiac_sign
redact_pii_sub
enum<string> | null
default:hash
The replacement logic for detected PII, can be entity_name or hash. See PII redaction for more details.
Available options:
entity_name,
hash
redact_pii_return_unredacted
boolean
default:false
When set to true, returns the original unredacted transcript alongside the redacted one in the same response. Requires redact_pii to be true, otherwise a 400 error is returned.
When enabled, the response includes the additional fields unredacted_text, unredacted_words, and unredacted_utterances. The existing text, words, and utterances fields remain fully redacted. When disabled (default), the response is unchanged and contains only the redacted transcript. See PII redaction for more details.
redact_static_entities
object
A map of user-defined terms to redact, where each key is a redaction label and each value is a list of exact terms to match (e.g. { "INTERNAL_TOOL": ["Bearclaw", "Cubclaw"] }). Each matching term in the transcript is redacted using the redact_pii_sub substitution, on top of standard PII Redaction. Useful for redacting specific, predefined terms (proprietary names, internal codenames) that aren't general PII categories.
This is a literal find-and-replace (tolerant of casing, surrounding punctuation, and minor spacing/hyphenation), not a model — it does not generalize beyond the terms you provide. Requires redact_pii to be true, otherwise a 400 error is returned. When redact_pii_audio is enabled, matched terms are also redacted in the audio output. You can provide up to 100 labels, each with up to 200 terms of at most 200 characters; a label may contain only letters, numbers, spaces, underscores, and hyphens (max 80 characters). See Static Entity Redaction for more details.
Show child attributes
sentiment_analysis
boolean
default:false
Enable Sentiment Analysis, can be true or false. Requires punctuate to be true.
speaker_labels
boolean
default:false
Enable Speaker diarization, can be true or false. Requires punctuate to be true.
speaker_options
object
Specify options for Speaker diarization. Use this to set a range of possible speakers. Requires speaker_labels to be true, and cannot be used together with speakers_expected. When both bounds are set, min_speakers_expected must be less than or equal to max_speakers_expected.
Show child attributes
speakers_expected
integer | null
Tells the speaker label model how many speakers it should attempt to identify. Requires speaker_labels to be true and must be a positive integer; cannot be used together with speaker_options. See Set number of speakers expected for more details.
speech_models
enum<string>[]
Optional. List one or more speech models. For new accounts created on or after November 17, 2026, if omitted, defaults to ["assemblyai-stt-3-7"]. See Model Selection for available models and routing behavior.
Available options:
assemblyai-stt-3-7,
universal-2
speech_threshold
number<float> | null
default:0
Reject audio files that contain less than this fraction of speech.
Valid values are in the range [0, 1] inclusive. See Speech Threshold for more details.
Enable Summarization, can be true or false. Requires both punctuate and format_text to be true, and cannot be enabled together with auto_chapters. Deprecated - use LLM Gateway instead for more flexible summaries. See the updated Summarization page for details.
Note: This parameter is only supported for the Universal-2 model.
summary_model
enum<string>
default:informative
deprecated
The model to summarize the transcript. Must be set together with summary_type. Compatibility - catchy supports gist and headline; informative and conversational support headline, paragraph, bullets, and bullets_verbose. Deprecated - use LLM Gateway instead for more flexible summaries. See the updated Summarization page for details.
Available options:
informative,
conversational,
catchy
summary_type
enum<string>
default:bullets
deprecated
The type of summary. Must be set together with summary_model; see summary_model for the supported model and type combinations. Deprecated - use LLM Gateway instead for more flexible summaries. See the updated Summarization page for details.
Available options:
bullets,
bullets_verbose,
gist,
headline,
paragraph
remove_audio_tags
enum<string> | null
default:all
AssemblyAI-STT-3.7 generates rich transcripts that can include inline annotations such as audio event markers and speaker cues. Set to "all" to remove all inline annotations, or "speaker" to remove only speaker cues while keeping other annotations. By default, all inline annotations are removed.
Note: This parameter is only supported for the AssemblyAI-STT-3.7 model.
Available options:
all,
speaker
temperature
number
default:0
Control the amount of randomness injected into the model's response. See the Prompting Guide for more details.
Note: This parameter only takes effect on the AssemblyAI-STT-3.7 model.
Required range: 0 <= x <= 1
webhook_auth_header_name
string | null
The header name to be sent with the transcript completed or failed webhook requests. Must be 1-1000 characters and contain only ASCII letters, numbers, hyphens, and underscores. Requires webhook_auth_header_value and webhook_url to also be set.
webhook_auth_header_value
string | null
The header value to send back with the transcript completed or failed webhook requests for added security. Must be 1-1000 characters and must not contain carriage returns or newlines. Requires webhook_auth_header_name and webhook_url to also be set.
The notification when the transcript status is completed or error.
transcript_id
string<uuid>
required
The ID of the transcript
status
enum<string>
required
The status of the transcript. Either completed or error.
Available options:
completed,
error
Response
Successfully received the notification
POST
{$request.body#/webhook_url}redactedAudioWebhook
Body
application/json
The notification when the redacted audio is ready.
status
enum<string>
required
The status of the redacted audio
Available options:
redacted_audio_ready
redacted_audio_url
string<url>
required
The URL of the redacted audio file
Response
Successfully received the notification
Response
Transcript created and queued for processing
A transcript object
audio_url
string<url>
required
The URL of the media that was transcribed
auto_highlights
boolean
required
Whether Key Phrases is enabled, either true or false
id
string<uuid>
required
The unique identifier of your transcript
language_confidence
number<double> | null
required
The confidence score for the detected language, between 0.0 (low confidence) and 1.0 (high confidence). See Automatic Language Detection for more details.
Required range: 0 <= x <= 1
language_confidence_threshold
number<float> | null
required
The confidence threshold for the automatically detected language.
An error will be returned if the language confidence is below this threshold.
See Automatic Language Detection for more details.
Required range: 0 <= x <= 1
redact_pii
boolean
required
Whether PII Redaction is enabled, either true or false
status
enum<string>
required
The status of your transcript. Possible values are queued, processing, completed, or error.
An array of results for the Content Moderation model, if it is enabled.
See Content moderation for more information.
Show child attributes
Example:
{
"status": "success",
"results": [
{
"text": "Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning.",
"labels": [
{
"label": "disasters",
"confidence": 0.8142836093902588,
"severity": 0.4093044400215149
}
],
"sentences_idx_start": 0,
"sentences_idx_end": 5,
"timestamp": { "start": 250, "end": 28840 }
}
],
"summary": {
"disasters": 0.9940800441842205,
"health_issues": 0.9216489289040967
},
"severity_score_summary": {
"disasters": {
"low": 0.5733263024656846,
"medium": 0.42667369753431533,
"high": 0
},
"health_issues": {
"low": 0.22863814977924785,
"medium": 0.45014154926938227,
"high": 0.32122030095136983
}
}
}
custom_spelling
object[] | null
Customize how words are spelled and formatted using to and from values. Each to value must be a single word, and each from phrase can contain at most 5 words. See Custom Spelling for more details.
Show child attributes
disfluencies
boolean | null
Whether Filler Words, like "umm", are transcribed; either true or false. This is the value that was applied to the transcript, which is the value from the request or, when the request did not set it, the request's default (true when speech_models includes assemblyai-stt-3-7, false otherwise).
domain
string | null
The domain-specific model applied to the transcript. When set to "medical-v1", Medical Mode was used to improve accuracy for medication names. When set to "veterinary-v1", Veterinary Mode was used to improve accuracy for veterinary terminology.
entities
object[] | null
An array of results for the Entity Detection model, if it is enabled.
See Entity detection for more information.
The result of the Topic Detection model, if it is enabled.
See Topic Detection for more information.
Show child attributes
Example:
{
"status": "success",
"results": [
{
"text": "Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning.",
"labels": [
{
"relevance": 0.988274097442627,
"label": "Home&Garden>IndoorEnvironmentalQuality"
},
{
"relevance": 0.5821335911750793,
"label": "NewsAndPolitics>Weather"
},
{
"relevance": 0.0042327106930315495,
"label": "MedicalHealth>DiseasesAndConditions>LungAndRespiratoryHealth"
},
{
"relevance": 0.0033971222583204508,
"label": "NewsAndPolitics>Disasters"
},
{
"relevance": 0.002469958271831274,
"label": "BusinessAndFinance>Business>GreenSolutions"
},
{
"relevance": 0.0014376690378412604,
"label": "MedicalHealth>DiseasesAndConditions>Cancer"
},
{
"relevance": 0.0014294233405962586,
"label": "Science>Environment"
},
{
"relevance": 0.001234519761055708,
"label": "Travel>TravelLocations>PolarTravel"
},
{
"relevance": 0.0010231725173071027,
"label": "MedicalHealth>DiseasesAndConditions>ColdAndFlu"
},
{
"relevance": 0.0007445293595083058,
"label": "BusinessAndFinance>Industries>PowerAndEnergyIndustry"
}
],
"timestamp": { "start": 250, "end": 28840 }
}
],
"summary": {
"NewsAndPolitics>Weather": 1,
"Home&Garden>IndoorEnvironmentalQuality": 0.9043831825256348,
"Science>Environment": 0.16117265820503235,
"BusinessAndFinance>Industries>EnvironmentalServicesIndustry": 0.14393523335456848,
"MedicalHealth>DiseasesAndConditions>LungAndRespiratoryHealth": 0.11401086300611496,
"BusinessAndFinance>Business>GreenSolutions": 0.06348437070846558,
"NewsAndPolitics>Disasters": 0.05041387677192688,
"Travel>TravelLocations>PolarTravel": 0.01308488193899393,
"HealthyLiving": 0.008222488686442375,
"MedicalHealth>DiseasesAndConditions>ColdAndFlu": 0.0022315620444715023,
"MedicalHealth>DiseasesAndConditions>HeartAndCardiovascularDiseases": 0.00213034451007843,
"HealthyLiving>Wellness>SmokingCessation": 0.001540527562610805,
"MedicalHealth>DiseasesAndConditions>Injuries": 0.0013950627762824297,
"BusinessAndFinance>Industries>PowerAndEnergyIndustry": 0.0012570273829624057,
"MedicalHealth>DiseasesAndConditions>Cancer": 0.001097781932912767,
"MedicalHealth>DiseasesAndConditions>Allergies": 0.0010148967849090695,
"MedicalHealth>DiseasesAndConditions>MentalHealth": 0.000717321818228811,
"Style&Fashion>PersonalCare>DeodorantAndAntiperspirant": 0.0006022014422342181,
"Technology&Computing>Computing>ComputerNetworking": 0.0005461975233629346,
"MedicalHealth>DiseasesAndConditions>Injuries>FirstAid": 0.0004885646631009877
}
}
keyterms_prompt
string[]
Improve accuracy with up to 200 (for Universal-2) or 1000 (for AssemblyAI-STT-3.7) domain-specific words or phrases (maximum 6 words per phrase). See Keyterms Prompting for more details.
language_code
enum<string>string
The language of your audio file.
Possible values are found in Supported Languages.
Available options:
en,
en_au,
en_uk,
en_us,
es,
fr,
de,
it,
pt,
nl,
af,
sq,
am,
ar,
hy,
as,
az,
ba,
eu,
be,
bn,
bs,
br,
bg,
my,
ca,
zh,
yue,
hr,
cs,
da,
et,
fo,
fi,
gl,
ka,
el,
gu,
ht,
ha,
haw,
he,
hi,
hu,
is,
id,
ja,
jw,
kn,
kk,
km,
ko,
lo,
la,
lv,
ln,
lt,
lb,
mk,
mg,
ms,
ml,
mt,
mi,
mr,
mn,
ne,
no,
nn,
oc,
pa,
ps,
fa,
pl,
ro,
ru,
sa,
sr,
sn,
sd,
si,
sk,
sl,
so,
su,
sw,
sv,
tl,
tg,
ta,
tt,
te,
th,
bo,
tr,
tk,
uk,
ur,
uz,
vi,
cy,
yi,
yo,
xh,
zu
language_codes
enum<string>[] | null
The language codes of your audio file. Used for Code switching. On AssemblyAI-STT-3.7, accepts any number of supported languages, and English isn't required. On Universal-2, accepts at most two languages, and one of them must be en. Can't be used together with language_code or language_detection.
The language of your audio file. Possible values are found in Supported Languages.
Whether a redacted version of the audio file was generated,
either true or false. See PII redaction for more information.
redact_pii_audio_options
object
The options for PII-redacted audio, if redact_pii_audio is enabled.
See PII redaction for more information.
Show child attributes
redact_pii_audio_quality
enum<string> | null
The audio quality of the PII-redacted audio file, if redact_pii_audio is enabled.
See PII redaction for more information.
Available options:
mp3,
wav
Example:
"mp3"
redact_pii_policies
enum<string>[] | null
The list of PII Redaction policies that were enabled, if PII Redaction is enabled.
See PII redaction for more information.
The type of PII to redact
Available options:
account_number,
banking_information,
blood_type,
credit_card_cvv,
credit_card_expiration,
credit_card_number,
date,
date_interval,
date_of_birth,
drivers_license,
drug,
duration,
email_address,
event,
filename,
gender,
gender_sexuality,
healthcare_number,
injury,
ip_address,
language,
location,
location_address,
location_address_street,
location_city,
location_coordinate,
location_country,
location_state,
location_zip,
marital_status,
medical_condition,
medical_process,
money_amount,
nationality,
number_sequence,
occupation,
organization,
organization_medical_facility,
passport_number,
password,
person_age,
person_name,
phone_number,
physical_attribute,
political_affiliation,
religion,
sexuality,
statistics,
time,
url,
us_social_security_number,
username,
vehicle_id,
zodiac_sign
redact_pii_sub
enum<string>
The replacement logic for detected PII, can be entity_name or hash. See PII redaction for more details.
Available options:
entity_name,
hash
redact_pii_return_unredacted
boolean | null
Whether the original unredacted transcript was also returned alongside the redacted one. When true, the response includes unredacted_text, unredacted_words, and unredacted_utterances. See PII redaction for more information.
Tell the speaker label model how many speakers it should attempt to identify. See Set number of speakers expected for more details.
speech_model_used
enum<string>
The speech model that was actually used for the transcription. See Model Selection for available models.
Available options:
assemblyai-stt-3-7,
universal-2
speech_models
enum<string>[] | null
List of speech models from the request that were considered to transcribe the audio. For new accounts created on or after November 17, 2026, if not specified in the request, this defaults to ["assemblyai-stt-3-7"]. See Model Selection for available models and routing behavior.
Available options:
assemblyai-stt-3-7,
universal-2
speech_threshold
number<float> | null
Defaults to null. Reject audio files that contain less than this fraction of speech.
Valid values are in the range [0, 1] inclusive. See Speech Threshold for more details.
AssemblyAI-STT-3.7 generates rich transcripts that can include inline annotations such as audio event markers and speaker cues. Set to "all" to remove all inline annotations, or "speaker" to remove only speaker cues while keeping other annotations. By default, all inline annotations are removed.
Note: This parameter is only supported for the AssemblyAI-STT-3.7 model.
Available options:
all,
speaker
temperature
number | null
The temperature that was used for the model's response. See the Prompting Guide for more details.
Note: This parameter only takes effect on the AssemblyAI-STT-3.7 model.
Required range: 0 <= x <= 1
text
string | null
The textual transcript of your media file
unredacted_text
string | null
The original textual transcript of your media file before PII redaction was applied. Only returned when redact_pii_return_unredacted was set to true on the transcription request, otherwise this field is omitted and the text field remains fully redacted. See PII redaction for more information.
throttled
boolean | null
True while a request is throttled and false when a request is no longer throttled
The original turn-by-turn utterance objects before PII redaction was applied. Same shape as utterances. Only returned when redact_pii_return_unredacted was set to true on the transcription request, otherwise this field is omitted and the utterances field remains fully redacted. See PII redaction for more information.
Show child attributes
webhook_auth_header_name
string | null
The header name to be sent with the transcript completed or failed webhook requests. Must be 1-1000 characters and contain only ASCII letters, numbers, hyphens, and underscores. Requires webhook_auth_header_value and webhook_url to also be set.
webhook_status_code
integer | null
The status code we received from your server when delivering the transcript completed or failed webhook request, if a webhook URL was provided
An array of temporally-sequential word objects, one for each word in the transcript.
Show child attributes
unredacted_words
object[] | null
The original temporally-sequential word objects before PII redaction was applied. Same shape as words. Only returned when redact_pii_return_unredacted was set to true on the transcription request, otherwise this field is omitted and the words field remains fully redacted. See PII redaction for more information.
Show child attributes
custom_topics
boolean | null
deprecated
This parameter does not currently have any functionality attached to it.
speed_boost
boolean | null
deprecated
This parameter does not currently have any functionality attached to it.
topics
string[]
deprecated
This parameter does not currently have any functionality attached to it.
translated_texts
object
Translated text keyed by language code. See Translation for more details.
Show child attributes
Was this page helpful?
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"AssemblyAI","description":"AssemblyAI provides production-ready Voice AI models for speech-to-text, speaker detection, sentiment analysis, and more. Build with pre-recorded or streaming audio using REST APIs and WebSockets.","colors":{"primary":"#614fd2","light":"#887bdd","dark":"#614fd2"},"logo":{"light":"https://mintcdn.com/assemblyai-fff14a6f/vMuNaI_PbWUbVeV0/assets/assemblyai-lockup-primary.svg?fit=max\u0026auto=format\u0026n=vMuNaI_PbWUbVeV0\u0026q=85\u0026s=808d2a677e2536423045d44b3f330ac2","dark":"https://mintcdn.com/assemblyai-fff14a6f/vMuNaI_PbWUbVeV0/assets/assemblyai-lockup-secondary.svg?fit=max\u0026auto=format\u0026n=vMuNaI_PbWUbVeV0\u0026q=85\u0026s=065ec1618693f8650241242ec62ed0ad","href":"https://www.assemblyai.com"},"favicon":"https://mintcdn.com/assemblyai-fff14a6f/6OQYF4QMRVQRoCb1/assets/favicon.png?fit=max\u0026auto=format\u0026n=6OQYF4QMRVQRoCb1\u0026q=85\u0026s=74b6b6a7321938bd113d4a271e06068d","api":{"openapi":["openapi.yaml","api-reference/specs/llm-gateway.yaml","api-reference/specs/streaming-token.yaml"],"asyncapi":["api-reference/specs/streaming.yaml","api-reference/specs/streaming-tts.yaml"]},"background":{"color":{"light":"#fdfcf8","dark":"#1d1b16"}},"navbar":{"links":[{"href":"https://www.assemblyai.com/playground","label":"Playground"},{"href":"https://www.assemblyai.com/changelog","label":"Changelog"}],"primary":{"type":"button","label":"Sign In","href":"https://www.assemblyai.com/dashboard/login"}},"footer":{"socials":{"x":"https://x.com/AssemblyAI","github":"https://github.com/AssemblyAI","linkedin":"https://www.linkedin.com/company/assemblyai"},"links":[{"header":"Legal","items":[{"label":"Terms of Service","href":"https://www.assemblyai.com/legal/terms-of-service"},{"label":"Privacy Policy","href":"https://www.assemblyai.com/legal/privacy-policy"},{"label":"Trust Center","href":"https://app.vanta.com/assemblyai/trust/7n80syl8zln1bn1qm3x8eg"},{"label":"Subprocessors","href":"https://app.vanta.com/assemblyai/trust/7n80syl8zln1bn1qm3x8eg/subprocessors"},{"label":"Do not sell my Personal Information","href":"#privacy-choices"}]}]},"seo":{"metatags":{"canonical":"https://www.assemblyai.com/docs"}},"fonts":{"heading":{"family":"GT Standard","weight":600,"source":"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Semibold.woff2","format":"woff2"},"body":{"family":"GT Standard","weight":400,"source":"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Regular.woff2","format":"woff2"}},"icons":{"library":"fontawesome"},"banner":{"content":"**New** AssemblyAI-TTS-1: Text-to-speech for voice agents. [Learn more](https://www.assemblyai.com/docs/tts/getting-started/quickstart)","dismissible":true},"contextual":{"options":["copy","view","chatgpt","claude","download-spec"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"assemblyai-fff14a6f","hasAudioNarration":false,"actualSubdomain":"assemblyai-fff14a6f","customDomains":["assemblyai.com"],"gitSource":{"type":"github","owner":"assemblyai","repo":"assemblyai-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afdf7669308bfb4d36f7cb3","clientVersion":"0.0.4205","searchFilterCounts":[{"language":"default","tag":"Overview","count":119},{"language":"default","tag":"FAQ","count":96},{"language":"default","tag":"Pre-recorded STT","count":71},{"language":"default","tag":"Guides","count":60},{"language":"default","tag":"Real-time STT","count":50},{"language":"default","tag":"Tutorials","count":48},{"language":"default","tag":"Pre-recorded audio","count":47},{"language":"default","tag":"LLM Gateway","count":45},{"language":"default","tag":"Features","count":39},{"language":"default","tag":"API reference","count":35}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true,"attachments":{"status":"DISABLED"}},"basePath":"/docs","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@font-face{font-family:\"GT Standard\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Regular.woff2\")\n format(\"woff2\"),\n url(\"https://www.assemblyai.com/docs/assets/GT-Standard-M-Regular.woff2\")\n format(\"woff2\"),\n url(\"/assets/GT-Standard-M-Regular.woff2\") format(\"woff2\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"GT Standard\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Medium.woff2\")\n format(\"woff2\"),\n url(\"https://www.assemblyai.com/docs/assets/GT-Standard-M-Medium.woff2\")\n format(\"woff2\"),\n url(\"/assets/GT-Standard-M-Medium.woff2\") format(\"woff2\");font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:\"GT Standard\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/GT-Standard-M-Semibold.woff2\")\n format(\"woff2\"),\n url(\"https://www.assemblyai.com/docs/assets/GT-Standard-M-Semibold.woff2\")\n format(\"woff2\"),\n url(\"/assets/GT-Standard-M-Semibold.woff2\") format(\"woff2\");font-weight:600;font-style:normal;font-display:swap}@font-face{font-family:\"Modern Gothic Mono\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/ModernGothicMono-Light.woff2\")\n format(\"woff2\");font-weight:300;font-style:normal;font-display:swap}@font-face{font-family:\"Modern Gothic Mono\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/ModernGothicMono-Regular.woff2\")\n format(\"woff2\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"Modern Gothic Mono\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/ModernGothicMono-Medium.woff2\")\n format(\"woff2\");font-weight:500;font-style:normal;font-display:swap}@font-face{font-family:\"Modern Gothic Mono\";src:url(\"https://www.assemblyai.com/_aai/fonts/rebrand/ModernGothicMono-Italic.woff2\")\n format(\"woff2\");font-weight:400;font-style:italic;font-display:swap}html:root{--font-family-body-custom: \"GT Standard\", -apple-system, BlinkMacSystemFont,\n \"Segoe UI\", sans-serif;--font-family-headings-custom: \"GT Standard\", -apple-system, BlinkMacSystemFont,\n \"Segoe UI\", sans-serif}code,kbd,samp,pre,pre code,pre code span{font-family:\"Modern Gothic Mono\", \"JetBrains Mono\", ui-monospace, SFMono-Regular,\n Menlo, Consolas, monospace!important}html{overflow-y:scroll;scrollbar-gutter:stable}pre,pre code,pre code span{font-size:0.75rem!important;line-height:1.5!important}:not(pre)>code{font-size:0.75rem!important;line-height:inherit!important}[data-nav-tag=\"WSS\"]{color:#614fd2!important;background-color:rgba(136, 123, 221, 0.14)!important;font-size:0.55rem!important}:is(.dark) [data-nav-tag=\"WSS\"]{color:#887bdd!important}div:has(>.nav-tag-pill>[data-nav-tag=\"WSS\"]){order:-1}.nav-tag-pill:has(>[data-nav-tag=\"WSS\"]){width:2.375rem;justify-content:flex-start}.ws-endpoint{display:flex;align-items:center;gap:0.625rem;margin:1rem 0 1.75rem;padding:0.5rem 0.75rem;border:1px solid rgba(0, 0, 0, 0.08);border-radius:0.5rem;background:rgba(0, 0, 0, 0.02);font-size:0.875rem;overflow-x:auto}:is(.dark) .ws-endpoint{border-color:rgba(255, 255, 255, 0.1);background:rgba(255, 255, 255, 0.03)}.ws-endpoint-badge{flex:none;font-weight:700;font-size:0.75rem;letter-spacing:0.02em;color:#614fd2;background:rgba(136, 123, 221, 0.14);padding:0.1875rem 0.5rem;border-radius:0.375rem}:is(.dark) .ws-endpoint-badge{color:#887bdd}.ws-endpoint-url{font-family:ui-monospace, SFMono-Regular, \"SF Mono\", Menlo, Consolas, monospace;white-space:nowrap}#assistant-entry,:is(.dark) #assistant-entry{background-color:#614fd2!important;filter:none!important}#assistant-entry:hover,:is(.dark) #assistant-entry:hover{background-color:#614fd2!important;opacity:0.9;filter:none!important}#assistant-entry span,#assistant-entry svg,:is(.dark) #assistant-entry span,:is(.dark) #assistant-entry svg{color:#ffffff!important}.callout strong{font-weight:700}*{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale;-o-font-smoothing:antialiased}.katex-display{overflow-x:visible!important;overflow-y:visible!important}.katex-display>.katex{display:flex!important;justify-content:center;width:100%!important;overflow-x:visible!important;overflow-y:visible!important}.katex-display>.katex>.katex-html{display:inline-block!important;width:auto!important;max-width:100%;overflow-x:visible!important;overflow-y:visible!important}.card-logo-icon{display:block;width:1.5rem!important;height:1.5rem!important;min-width:1.5rem;max-width:1.5rem;max-height:1.5rem;margin:0!important;object-fit:contain;object-position:center;vertical-align:middle}.card-logo-icon-livekit{transform:scale(0.9)}.card-logo-icon-pipecat{transform:scale(1.12)}.card-logo-icon-livekit,.card-logo-icon-pipecat,.card-logo-icon-vercel{color:#614fd2}:is(.dark) .card-logo-icon-livekit,:is(.dark) .card-logo-icon-pipecat,:is(.dark) .card-logo-icon-vercel{color:#887bdd}.recommended-pill{background:#614fd2;color:#fff;padding:2px 8px;border-radius:9999px;font-size:0.7rem;font-weight:600;margin-left:6px;vertical-align:middle;white-space:nowrap}:is(.dark) .recommended-pill{background:#614fd2}.preview-pill{background:#b45309;color:#fff;padding:2px 8px;border-radius:9999px;font-size:0.7rem;font-weight:600;margin-left:6px;vertical-align:middle;white-space:nowrap}:is(.dark) .preview-pill{background:#b45309}table code{white-space:nowrap}"}],"page":{"pagePath":"pre-recorded-audio/api-reference/transcripts/submit","slug":"/pre-recorded-audio/api-reference/transcripts/submit","pageMetadata":{"title":"Transcribe audio","og.description":"Create a transcription request.","openapi":"openapi.yaml POST /v2/transcript","description":"\u003cNote>To use our EU server for transcription, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\nCreate a transcript from a media file that is accessible via a URL.\n","href":"/pre-recorded-audio/api-reference/transcripts/submit"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n }, {Note} = _components;\n if (!Note) _missingMdxReference(\"Note\", true);\n return _jsxs(_components.p, {\n children: [_jsxs(Note, {\n children: [\"To use our EU server for transcription, replace \", _jsx(_components.code, {\n children: \"api.assemblyai.com\"\n }), \" with \", _jsx(_components.code, {\n children: \"api.eu.assemblyai.com\"\n }), \".\"]\n }), \"\\nCreate a transcript from a media file that is accessible via a URL.\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\nfunction _missingMdxReference(id, component) {\n throw new Error(\"Expected \" + (component ? \"component\" : \"object\") + \" `\" + id + \"` to be defined: you likely forgot to import, pass, or provide it.\");\n}\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Transcribe audio","og.description":"Create a transcription request.","openapi":"openapi.yaml POST /v2/transcript","description":"\u003cNote>To use our EU server for transcription, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\nCreate a transcript from a media file that is accessible via a URL.\n","href":"/pre-recorded-audio/api-reference/transcripts/submit"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/docs/_mintlify/custom/assemblyai-fff14a6f/c705301dcef66bf6/rudderstack.js","/docs/_mintlify/custom/assemblyai-fff14a6f/700d2574de973df9/chat-widget.js","/docs/_mintlify/custom/assemblyai-fff14a6f/33c4022d4e30e01c/ketch.js"],"openApiReferenceData":{"operation":{"tags":["transcript"],"summary":"Transcribe audio","description":"\u003cNote>To use our EU server for transcription, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\nCreate a transcript from a media file that is accessible via a URL.\n","operationId":"createTranscript","x-fern-sdk-group-name":"transcripts","x-fern-sdk-method-name":"submit","x-fern-request-name":"TranscriptParams","requestBody":"813127f6-55bb-4e54-999e-7ccc1902aa78","x-codeSamples":[{"lang":"python","label":"Python SDK","source":"import os\n\nfrom assemblyai.prerecorded.v2 import Transcriber\n\ntranscriber = Transcriber(api_key=os.environ[\"ASSEMBLYAI_API_KEY\"])\n\n# `submit` queues the job and returns right away; `transcribe` submits and polls.\ntranscript = transcriber.submit(\"https://assembly.ai/wildfires.mp3\")\nprint(transcript.id, transcript.status)\n"},{"lang":"javascript","label":"JavaScript SDK","source":"import { AssemblyAI } from \"assemblyai\";\n\nconst client = new AssemblyAI({ apiKey: process.env.ASSEMBLYAI_API_KEY });\n\n// `submit` queues the job and returns right away; `transcribe` submits and polls.\nconst transcript = await client.transcripts.submit({\n audio_url: \"https://assembly.ai/wildfires.mp3\",\n});\nconsole.log(transcript.id, transcript.status);\n"},{"lang":"bash","label":"cURL","source":"curl -s -X POST https://api.assemblyai.com/v2/transcript \\\n -H \"authorization: $ASSEMBLYAI_API_KEY\" \\\n -H \"content-type: application/json\" \\\n -d '{\"audio_url\": \"https://assembly.ai/wildfires.mp3\"}' | jq -r .id\n"},{"lang":"python","label":"Python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n \"https://api.assemblyai.com/v2/transcript\",\n headers={\"authorization\": os.environ[\"ASSEMBLYAI_API_KEY\"]},\n json={\"audio_url\": \"https://assembly.ai/wildfires.mp3\"},\n)\n\nresponse.raise_for_status()\nprint(response.json()[\"id\"])\n"},{"lang":"javascript","label":"JavaScript","source":"const response = await fetch(\"https://api.assemblyai.com/v2/transcript\", {\n method: \"POST\",\n headers: {\n authorization: process.env.ASSEMBLYAI_API_KEY,\n \"content-type\": \"application/json\",\n },\n body: JSON.stringify({ audio_url: \"https://assembly.ai/wildfires.mp3\" }),\n});\n\nconst transcript = await response.json();\nconsole.log(transcript.id, transcript.status);\n"}],"responses":{"200":"9554c71c-df8c-4df5-a716-41e6a68f3032","400":"904ee1af-0461-4048-8eed-49c41554fce9","401":"f0cdadc1-b860-4b41-94f5-1a21cacf37e5","403":"099458c9-8783-4bc4-8280-dace01486743","404":"1ed97bd0-4264-485b-adf2-1a7cba20b9dd","429":"3446cb21-8d77-4b02-b8b9-2da5a78df547","500":"fa00b4b4-551d-4276-a9a5-5870f476f38a","503":"1e28bfe0-b824-4b14-891a-f9f2a9bfd30d","504":"e5f26380-6f9a-49ed-94c8-5e335a250193"},"callbacks":{"transcriptReadyWebhook":"f1cf5934-5106-469d-a8ff-a7c2a87811ba","redactedAudioWebhook":"6fcdb25c-6022-460a-9507-079d267afa8a"},"method":"post","type":"path","servers":["90f40eae-7250-4ea8-a01b-fc04eabb210e"],"security":["da0aa2b4-d1f8-45b5-8ba0-ae4397fdd565"],"path":"/v2/transcript","baseUrlOptions":["https://api.assemblyai.com"],"title":"Transcribe audio","codeSamples":[{"label":"Python SDK","lang":"python","source":"import os\n\nfrom assemblyai.prerecorded.v2 import Transcriber\n\ntranscriber = Transcriber(api_key=os.environ[\"ASSEMBLYAI_API_KEY\"])\n\n# `submit` queues the job and returns right away; `transcribe` submits and polls.\ntranscript = transcriber.submit(\"https://assembly.ai/wildfires.mp3\")\nprint(transcript.id, transcript.status)\n"},{"label":"JavaScript SDK","lang":"javascript","source":"import { AssemblyAI } from \"assemblyai\";\n\nconst client = new AssemblyAI({ apiKey: process.env.ASSEMBLYAI_API_KEY });\n\n// `submit` queues the job and returns right away; `transcribe` submits and polls.\nconst transcript = await client.transcripts.submit({\n audio_url: \"https://assembly.ai/wildfires.mp3\",\n});\nconsole.log(transcript.id, transcript.status);\n"},{"label":"cURL","lang":"bash","source":"curl -s -X POST https://api.assemblyai.com/v2/transcript \\\n -H \"authorization: $ASSEMBLYAI_API_KEY\" \\\n -H \"content-type: application/json\" \\\n -d '{\"audio_url\": \"https://assembly.ai/wildfires.mp3\"}' | jq -r .id\n"},{"label":"Python","lang":"python","source":"import os\n\nimport requests\n\nresponse = requests.post(\n \"https://api.assemblyai.com/v2/transcript\",\n headers={\"authorization\": os.environ[\"ASSEMBLYAI_API_KEY\"]},\n json={\"audio_url\": \"https://assembly.ai/wildfires.mp3\"},\n)\n\nresponse.raise_for_status()\nprint(response.json()[\"id\"])\n"},{"label":"JavaScript","lang":"javascript","source":"const response = await fetch(\"https://api.assemblyai.com/v2/transcript\", {\n method: \"POST\",\n headers: {\n authorization: process.env.ASSEMBLYAI_API_KEY,\n \"content-type\": \"application/json\",\n },\n body: JSON.stringify({ audio_url: \"https://assembly.ai/wildfires.mp3\" }),\n});\n\nconst transcript = await response.json();\nconsole.log(transcript.id, transcript.status);\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"Params to create a transcript","required":true,"content":{"application/json":{"schema":{"type":"object","description":"The parameters for creating a transcript","required":["audio_url"],"x-label":"Transcript parameters","x-fern-sdk-group-name":"transcripts","example":{"speech_model":null,"language_detection":true,"language_confidence_threshold":0.7,"punctuate":true,"format_text":true,"multichannel":true,"webhook_url":"https://your-webhook-url/path","webhook_auth_header_name":"webhook-secret","webhook_auth_header_value":"webhook-secret-value","auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"speakers_expected":2,"content_safety":true,"iab_categories":true,"custom_spelling":[],"disfluencies":false,"sentiment_analysis":true,"auto_chapters":false,"entity_detection":true,"speech_threshold":0.5,"summarization":false,"summary_model":null,"summary_type":null,"custom_topics":true,"topics":[],"remove_audio_tags":null,"domain":null,"speech_understanding":{"request":{"translation":{"target_languages":["es","de"],"formal":true,"match_original_utterance":true}}},"audio_url":"https://assembly.ai/wildfires.mp3"},"properties":{"audio_url":{"x-label":"Audio URL","description":"The URL of the audio or video file to transcribe.","type":"string","format":"url","isRequired":true,"uniqueKey":"audio_url","typeLabel":"string\u003curl>"},"audio_end_at":{"x-label":"Audio end at","description":"The point in time, in milliseconds, to stop transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer","uniqueKey":"audio_end_at","typeLabel":"integer"},"audio_start_from":{"x-label":"Audio start from","description":"The point in time, in milliseconds, to begin transcribing in your media file. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer","uniqueKey":"audio_start_from","typeLabel":"integer"},"auto_chapters":{"x-label":"Auto chapters","description":"Enable [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters), can be true or false. Requires `punctuate` to be `true`, and cannot be enabled together with `summarization`. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible chapter summaries. See the [updated Auto Chapters page](https://www.assemblyai.com/docs/speech-understanding/auto-chapters) for details.\n\nNote: This parameter is only supported for the Universal-2 model.\n","type":"boolean","default":false,"deprecated":true,"uniqueKey":"auto_chapters","typeLabel":"boolean"},"auto_highlights":{"x-label":"Key phrases","description":"Enable [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases), either true or false","type":"boolean","default":false,"uniqueKey":"auto_highlights","typeLabel":"boolean"},"content_safety":{"x-label":"Content Moderation","description":"Enable [Content Moderation](https://www.assemblyai.com/docs/content-moderation), can be true or false","type":"boolean","default":false,"uniqueKey":"content_safety","typeLabel":"boolean"},"content_safety_confidence":{"x-label":"Content Moderation confidence","description":"The confidence threshold for the [Content Moderation](https://www.assemblyai.com/docs/content-moderation) model. Values must be between 25 and 100. Requires `content_safety` to be enabled; otherwise it's ignored.","type":"integer","default":50,"minimum":25,"maximum":100,"uniqueKey":"content_safety_confidence","typeLabel":"integer"},"custom_spelling":{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. Each `to` value must be a single word, and each `from` phrase can contain at most 5 words. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/correct-spelling-of-terms) for more details.","type":"array","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string","uniqueKey":"custom_spelling.items.[INDEX].from.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"custom_spelling.items.[INDEX].from","typeLabel":"string[]"},"to":{"x-label":"To","description":"Word to replace with","type":"string","isRequired":true,"uniqueKey":"custom_spelling.items.[INDEX].to","typeLabel":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"},"uniqueKey":"custom_spelling.items.[INDEX]","typeLabel":"object"},"uniqueKey":"custom_spelling","typeLabel":"object[]"},"disfluencies":{"x-label":"Disfluencies","description":"Transcribe [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/include-filler-words), like \"umm\", in your media file; can be true or false. Supported on AssemblyAI-STT-3.7 and Universal-2. Defaults to true when `speech_models` includes `assemblyai-stt-3-7` in any position, or is omitted and the request uses `assemblyai-stt-3-7` by default, and to false otherwise.","type":"boolean","uniqueKey":"disfluencies","typeLabel":"boolean"},"domain":{"oneOf":[{"x-label":"Domain","description":"Enable domain-specific transcription models to improve accuracy for specialized terminology. Set to `\"medical-v1\"` to enable [Medical Mode](https://www.assemblyai.com/docs/pre-recorded-audio/medical-mode) for improved accuracy of medication names, both generic and brand-name. Set to `\"veterinary-v1\"` to enable [Veterinary Mode](https://www.assemblyai.com/docs/pre-recorded-audio/veterinary-mode) (beta) for improved accuracy of veterinary terminology.\n\nMedical Mode supported languages: English (`en`), Spanish (`es`), German (`de`), French (`fr`). If `medical-v1` is used with an unsupported language, the parameter is ignored and a warning is returned.\n","type":"string","enum":["medical-v1","veterinary-v1",null],"default":null,"uniqueKey":"domain.oneOf.0","typeLabel":"enum\u003cstring>"},{"x-label":"Domain","description":"Enable domain-specific transcription models to improve accuracy for specialized terminology. Set to `\"medical-v1\"` to enable [Medical Mode](https://www.assemblyai.com/docs/pre-recorded-audio/medical-mode) for improved accuracy of medication names, both generic and brand-name. Set to `\"veterinary-v1\"` to enable [Veterinary Mode](https://www.assemblyai.com/docs/pre-recorded-audio/veterinary-mode) (beta) for improved accuracy of veterinary terminology.\n\nMedical Mode supported languages: English (`en`), Spanish (`es`), German (`de`), French (`fr`). If `medical-v1` is used with an unsupported language, the parameter is ignored and a warning is returned.\n","type":"null","enum":["medical-v1","veterinary-v1",null],"default":null,"uniqueKey":"domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"domain","typeLabel":"enum\u003cstring> | null"},"entity_detection":{"x-label":"Entity Detection","description":"Enable [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection), can be true or false","type":"boolean","default":false,"uniqueKey":"entity_detection","typeLabel":"boolean"},"filter_profanity":{"x-label":"Filter profanity","description":"Filter profanity from the transcribed text, can be true or false. See [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) for more details.","type":"boolean","default":false,"uniqueKey":"filter_profanity","typeLabel":"boolean"},"format_text":{"x-label":"Format text","description":"Enable [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio/formatting), can be true or false","type":"boolean","default":true,"uniqueKey":"format_text","typeLabel":"boolean"},"iab_categories":{"x-label":"Topic Detection","description":"Enable [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection), can be true or false","type":"boolean","default":false,"uniqueKey":"iab_categories","typeLabel":"boolean"},"keyterms_prompt":{"x-label":"Keyterms prompt","description":"Improve accuracy with up to 200 (for Universal-2) or 1000 (for AssemblyAI-STT-3.7) domain-specific words or phrases (maximum 6 words per phrase). See [Keyterms Prompting](https://www.assemblyai.com/docs/pre-recorded-audio/prompting#keyterms-prompting) for more details.\n","type":"array","items":{"x-label":"Keyterm","type":"string","uniqueKey":"keyterms_prompt.items.[INDEX]","typeLabel":"string"},"uniqueKey":"keyterms_prompt","typeLabel":"string[]"},"language_code":{"oneOf":[{"type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nIf you don't specify a language, it's detected automatically. Can be used with `language_detection` set to `false`, but not with `language_detection` set to `true`.\n","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","yue","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","xh","zu"],"x-label":"Language code","x-fern-sdk-group-name":"transcripts","x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"},"yue":{"label":"Cantonese"},"xh":{"label":"Xhosa"},"zu":{"label":"Zulu"}},"x-ts-type":"LiteralUnion\u003cTranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode","uniqueKey":"language_code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nIf you don't specify a language, it's detected automatically. Can be used with `language_detection` set to `false`, but not with `language_detection` set to `true`.\n","x-label":"Language code","x-ts-type":"LiteralUnion\u003cTranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode","uniqueKey":"language_code.oneOf.1","typeLabel":"string"},{"type":"null","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\nIf you don't specify a language, it's detected automatically. Can be used with `language_detection` set to `false`, but not with `language_detection` set to `true`.\n","x-label":"Language code","x-ts-type":"LiteralUnion\u003cTranscriptLanguageCode, string> | null","x-go-type":"TranscriptLanguageCode","uniqueKey":"language_code.oneOf.2","typeLabel":"null"}],"uniqueKey":"language_code","typeLabel":"enum\u003cstring> | string | null"},"language_codes":{"oneOf":[{"description":"The language codes of your audio file. Used for [Code switching](https://www.assemblyai.com/docs/pre-recorded-audio/code-switching). On AssemblyAI-STT-3.7, accepts any number of supported languages, and English isn't required. On Universal-2, accepts at most two languages, and one of them must be `en`. Can't be used together with `language_code` or `language_detection`.\n","type":"array","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","yue","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","xh","zu"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"},"yue":{"label":"Cantonese"},"xh":{"label":"Xhosa"},"zu":{"label":"Zulu"}},"uniqueKey":"language_codes.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"language_codes.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"description":"The language codes of your audio file. Used for [Code switching](https://www.assemblyai.com/docs/pre-recorded-audio/code-switching). On AssemblyAI-STT-3.7, accepts any number of supported languages, and English isn't required. On Universal-2, accepts at most two languages, and one of them must be `en`. Can't be used together with `language_code` or `language_detection`.\n","type":"null","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","yue","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","xh","zu"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"},"yue":{"label":"Cantonese"},"xh":{"label":"Xhosa"},"zu":{"label":"Zulu"}}},"uniqueKey":"language_codes.oneOf.1","typeLabel":"null"}],"uniqueKey":"language_codes","typeLabel":"enum\u003cstring>[] | null"},"language_confidence_threshold":{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nDefaults to 0. Can only be set when `language_detection` is enabled. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0,"uniqueKey":"language_confidence_threshold","typeLabel":"number\u003cfloat>"},"language_detection":{"x-label":"Language detection","description":"[Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) identifies the spoken language. See [Model selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model#transcribe-all-99-languages-by-combining-speech-models) for how requests are routed to a speech model. It's applied automatically when you don't specify a `language_code`. Set to `false` only together with a `language_code`; disabling it without specifying a language returns an error.\n","type":"boolean","uniqueKey":"language_detection","typeLabel":"boolean"},"language_detection_options":{"x-label":"Specify options for Automatic Language Detection.","description":"Specify options for [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection).","type":"object","additionalProperties":false,"properties":{"expected_languages":{"x-label":"Expected languages","description":"List of languages expected in the audio file. Defaults to `[\"all\"]` when unspecified. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"array","items":{"x-label":"language","type":"string","uniqueKey":"language_detection_options.expected_languages.items.[INDEX]","typeLabel":"string"},"uniqueKey":"language_detection_options.expected_languages","typeLabel":"string[]"},"fallback_language":{"x-label":"Fallback language","description":"If the detected language of the audio file is not in the list of expected languages, the `fallback_language` is used. Specify `\"auto\"` to let our model choose the fallback language from `expected_languages` with the highest confidence score. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","default":"auto","uniqueKey":"language_detection_options.fallback_language","typeLabel":"string"},"code_switching":{"x-label":"Code switching","description":"Whether [code switching](https://www.assemblyai.com/docs/pre-recorded-audio/code-switching) should be detected. Only supported on Universal-2. AssemblyAI-STT-3.7 code-switches natively, so this option doesn't apply to it.\n","type":"boolean","default":false,"uniqueKey":"language_detection_options.code_switching","typeLabel":"boolean"},"code_switching_confidence_threshold":{"x-label":"Code switching confidence threshold","description":"The confidence threshold for [code switching](https://www.assemblyai.com/docs/pre-recorded-audio/code-switching) detection. If the code switching confidence is below this threshold, the transcript will be processed in the language with the highest `language_detection_confidence` score.\n","type":"number","minimum":0,"maximum":1,"default":0.3,"uniqueKey":"language_detection_options.code_switching_confidence_threshold","typeLabel":"number"},"localization":{"x-label":"Localization","description":"Render the transcript in a regional variant of the detected language. Supported values are `en_au` (Australian English) and `en_uk` (British English) — only English is supported today, and you can specify at most one locale per base language. Base or default-region codes such as `en` and `en_us` are not localization variants and return a `400`.\n\nWhen the detected language matches the requested locale's base language, the transcript uses that locale's spelling and `language_code` returns the region-aware code (for example `en_au`) instead of the base `en`. Otherwise, when the detected language isn't available as a locale, the option is ignored. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"array","items":{"x-label":"locale","type":"string","uniqueKey":"language_detection_options.localization.items.[INDEX]","typeLabel":"string"},"uniqueKey":"language_detection_options.localization","typeLabel":"string[]"},"on_no_speech_detected":{"x-label":"On no speech detected","description":"Controls what happens when no speech is detected in the audio. With `error` (the default), the transcript fails and the reason is returned in `error`. With `fallback`, the transcript completes with an empty `text`, `language_code` is set to the `fallback_language`, and an explanatory warning is returned in `metadata.warnings`.\n\n`fallback` requires `fallback_language` to be set to a specific language code; `auto` returns a `400`. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","enum":["error","fallback"],"default":"error","uniqueKey":"language_detection_options.on_no_speech_detected","typeLabel":"enum\u003cstring>"}},"uniqueKey":"language_detection_options","typeLabel":"object"},"multichannel":{"x-label":"Multichannel","description":"Enable [Multichannel](https://www.assemblyai.com/docs/pre-recorded-audio/transcribe-multiple-audio-channels) transcription, can be true or false.","type":"boolean","default":false,"uniqueKey":"multichannel","typeLabel":"boolean"},"prompt":{"x-label":"Prompt","description":"Provide natural language prompting of up to 1,500 words of contextual information to the model. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for best practices.\n\nNote: This parameter is only supported for the AssemblyAI-STT-3.7 model.\n","type":"string","uniqueKey":"prompt","typeLabel":"string"},"punctuate":{"x-label":"Punctuate","description":"Enable [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio/formatting), can be true or false","type":"boolean","default":true,"uniqueKey":"punctuate","typeLabel":"boolean"},"redact_pii":{"x-label":"Redact PII","description":"Redact PII from the transcribed text using the Redact PII model, can be true or false. Requires `format_text` to be `true`. See [PII Redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"boolean","default":false,"uniqueKey":"redact_pii","typeLabel":"boolean"},"redact_pii_audio":{"x-label":"Redact PII audio","description":"Generate a copy of the original media file with spoken PII \"beeped\" out, can be true or false. Requires `redact_pii` to be `true`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","type":"boolean","default":false,"uniqueKey":"redact_pii_audio","typeLabel":"boolean"},"redact_pii_audio_options":{"x-label":"Specify options for PII redacted audio files.","description":"Specify options for [PII redacted audio](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) files.","type":"object","additionalProperties":false,"properties":{"return_redacted_no_speech_audio":{"x-label":"Return redacted no speech audio","description":"By default, audio redaction provides redacted audio URLs only when speech is detected. However, if your use-case specifically requires redacted audio files even for silent audio files without any dialogue, you can opt to receive these URLs by setting this parameter to `true`. Requires `redact_pii_audio` to be `true`.","type":"boolean","default":false,"uniqueKey":"redact_pii_audio_options.return_redacted_no_speech_audio","typeLabel":"boolean"},"override_audio_redaction_method":{"x-label":"Override audio redaction method","description":"Specify the method used to redact audio. By default, redacted audio uses a beep sound. Set to `silence` to replace PII with silence instead of a beep.","type":"string","enum":["silence"],"uniqueKey":"redact_pii_audio_options.override_audio_redaction_method","typeLabel":"enum\u003cstring>"}},"uniqueKey":"redact_pii_audio_options","typeLabel":"object"},"redact_pii_audio_quality":{"x-label":"Redact PII audio quality","type":"string","description":"Controls the filetype of the audio created by redact_pii_audio. Currently supports mp3 (default) and wav. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more details.","x-fern-sdk-group-name":"transcripts","enum":["mp3","wav"],"x-fern-enum":{"mp3":{"description":"MP3 audio format is lower quality and lower size than WAV.","casing":{"camel":"mp3","snake":"mp3","pascal":"Mp3","screamingSnake":"MP3"}},"wav":{"description":"WAV audio format is the highest quality (no compression) and larger size than MP3."}},"x-aai-enum":{"mp3":{"label":"MP3"},"wav":{"label":"WAV"}},"example":"mp3","default":"mp3","uniqueKey":"redact_pii_audio_quality","typeLabel":"enum\u003cstring>"},"redact_pii_policies":{"x-label":"Redact PII policies","description":"The list of PII Redaction policies to enable. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","type":"array","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender","gender_sexuality","healthcare_number","injury","ip_address","language","location","location_address","location_address_street","location_city","location_coordinate","location_country","location_state","location_zip","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","organization_medical_facility","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","sexuality","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Measurements of time expressed as a numerical value plus a unit (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender":{"description":"Terms indicating gender identity (e.g., female, male, non-binary)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"location_address":{"description":"A complete mailing address (e.g., 145 Windsor St., Toronto, ON M5A 2P5)"},"location_address_street":{"description":"Street-level component of an address (e.g., 145 Windsor St.)"},"location_city":{"description":"City name (e.g., Toronto, San Francisco)"},"location_coordinate":{"description":"Geographic coordinates (e.g., 40.7128° N, 74.0060° W)"},"location_country":{"description":"Country name (e.g., Canada, United States)"},"location_state":{"description":"State, province, or region name (e.g., Ontario, California)"},"location_zip":{"description":"Postal or ZIP code (e.g., M5A 2P5, 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"organization_medical_facility":{"description":"Name of a medical facility (e.g., Mayo Clinic, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"sexuality":{"description":"Terms indicating sexual orientation (e.g., heterosexual, bisexual, gay)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender":{"label":"Gender"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"location_address":{"label":"Location address"},"location_address_street":{"label":"Location address street"},"location_city":{"label":"Location city"},"location_coordinate":{"label":"Location coordinate"},"location_country":{"label":"Location country"},"location_state":{"label":"Location state"},"location_zip":{"label":"Location ZIP"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"organization_medical_facility":{"label":"Organization medical facility"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"sexuality":{"label":"Sexuality"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}},"uniqueKey":"redact_pii_policies.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"redact_pii_policies","typeLabel":"enum\u003cstring>[]"},"redact_pii_sub":{"oneOf":[{"type":"string","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","default":"hash","enum":["entity_name","hash"],"x-label":"Redact PII substitution","x-fern-sdk-group-name":"transcripts","x-aai-enum":{"entity_name":{"label":"Entity name"},"hash":{"label":"Hash"}},"uniqueKey":"redact_pii_sub.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","default":"hash","x-label":"Redact PII substitution","uniqueKey":"redact_pii_sub.oneOf.1","typeLabel":"null"}],"uniqueKey":"redact_pii_sub","typeLabel":"enum\u003cstring> | null"},"redact_pii_return_unredacted":{"x-label":"Return unredacted transcript","description":"When set to `true`, returns the original unredacted transcript alongside the redacted one in the same response. Requires `redact_pii` to be `true`, otherwise a 400 error is returned.\n\nWhen enabled, the response includes the additional fields `unredacted_text`, `unredacted_words`, and `unredacted_utterances`. The existing `text`, `words`, and `utterances` fields remain fully redacted. When disabled (default), the response is unchanged and contains only the redacted transcript. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.\n","type":"boolean","default":false,"uniqueKey":"redact_pii_return_unredacted","typeLabel":"boolean"},"redact_static_entities":{"x-label":"Redact static entities","description":"A map of user-defined terms to redact, where each key is a redaction label and each value is a list of exact terms to match (e.g. `{ \"INTERNAL_TOOL\": [\"Bearclaw\", \"Cubclaw\"] }`). Each matching term in the transcript is redacted using the `redact_pii_sub` substitution, on top of standard PII Redaction. Useful for redacting specific, predefined terms (proprietary names, internal codenames) that aren't general PII categories.\n\nThis is a literal find-and-replace (tolerant of casing, surrounding punctuation, and minor spacing/hyphenation), not a model — it does not generalize beyond the terms you provide. Requires `redact_pii` to be `true`, otherwise a 400 error is returned. When `redact_pii_audio` is enabled, matched terms are also redacted in the audio output. You can provide up to 100 labels, each with up to 200 terms of at most 200 characters; a label may contain only letters, numbers, spaces, underscores, and hyphens (max 80 characters). See [Static Entity Redaction](https://www.assemblyai.com/docs/guardrails/redact-pii-from-transcripts#static-entity-redaction) for more details.\n","type":"object","additionalProperties":{"type":"array","items":{"type":"string","uniqueKey":"redact_static_entities.additionalProperties.items.[INDEX]","typeLabel":"string"},"uniqueKey":"redact_static_entities.additionalProperties","typeLabel":"string[]"},"uniqueKey":"redact_static_entities","typeLabel":"object"},"sentiment_analysis":{"x-label":"Sentiment Analysis","description":"Enable [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis), can be true or false. Requires `punctuate` to be `true`.","type":"boolean","default":false,"uniqueKey":"sentiment_analysis","typeLabel":"boolean"},"speaker_labels":{"x-label":"Speaker labels","description":"Enable [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers), can be true or false. Requires `punctuate` to be `true`.","type":"boolean","default":false,"uniqueKey":"speaker_labels","typeLabel":"boolean"},"speaker_options":{"x-label":"Specify options for speaker diarization.","description":"Specify options for [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers#set-a-range-of-possible-speakers). Use this to set a range of possible speakers. Requires `speaker_labels` to be `true`, and cannot be used together with `speakers_expected`. When both bounds are set, `min_speakers_expected` must be less than or equal to `max_speakers_expected`.","type":"object","additionalProperties":false,"properties":{"min_speakers_expected":{"x-label":"Minimum speakers expected","description":"A hard lower limit on the number of speaker labels — the model won't return fewer speakers than this. See [Set a range of possible speakers](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers#set-a-range-of-possible-speakers) for more details.","type":"integer","uniqueKey":"speaker_options.min_speakers_expected","typeLabel":"integer"},"max_speakers_expected":{"x-label":"Maximum speakers expected","description":"\u003cWarning>Setting this parameter too high may hurt model accuracy\u003c/Warning>\nA hard upper limit on the number of speaker labels. If more people speak than this value, the additional speakers are merged into existing labels. Setting it higher than the true number of speakers can cause the model to over-split and return more speakers than are actually present.\n","type":"integer","uniqueKey":"speaker_options.max_speakers_expected","typeLabel":"integer"},"include_speaker_confidence":{"x-label":"Include speaker confidence","description":"When `true`, includes a `speaker_confidence` field per word and per utterance in the response. See [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers#configuration) for more details.","type":"boolean","default":false,"uniqueKey":"speaker_options.include_speaker_confidence","typeLabel":"boolean"}},"uniqueKey":"speaker_options","typeLabel":"object"},"speakers_expected":{"oneOf":[{"x-label":"Speakers expected","description":"Tells the speaker label model how many speakers it should attempt to identify. Requires `speaker_labels` to be `true` and must be a positive integer; cannot be used together with `speaker_options`. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers#set-number-of-speakers-expected) for more details.","type":"integer","default":null,"uniqueKey":"speakers_expected.oneOf.0","typeLabel":"integer"},{"x-label":"Speakers expected","description":"Tells the speaker label model how many speakers it should attempt to identify. Requires `speaker_labels` to be `true` and must be a positive integer; cannot be used together with `speaker_options`. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers#set-number-of-speakers-expected) for more details.","type":"null","default":null,"uniqueKey":"speakers_expected.oneOf.1","typeLabel":"null"}],"uniqueKey":"speakers_expected","typeLabel":"integer | null"},"speech_models":{"x-label":"Speech models","description":"Optional. List one or more speech models. For new accounts created on or after November 17, 2026, if omitted, defaults to `[\"assemblyai-stt-3-7\"]`. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"array","items":{"x-label":"Speech model","type":"string","enum":["assemblyai-stt-3-7","universal-2"],"x-fern-sdk-group-name":"transcripts","uniqueKey":"speech_models.items.[INDEX]","typeLabel":"enum\u003cstring>"},"default":["assemblyai-stt-3-7"],"uniqueKey":"speech_models","typeLabel":"enum\u003cstring>[]"},"speech_threshold":{"oneOf":[{"x-label":"Speech threshold","description":"Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"default":0,"uniqueKey":"speech_threshold.oneOf.0","typeLabel":"number\u003cfloat>"},{"x-label":"Speech threshold","description":"Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"null","format":"float","minimum":0,"maximum":1,"default":0,"uniqueKey":"speech_threshold.oneOf.1","typeLabel":"null"}],"uniqueKey":"speech_threshold","typeLabel":"number\u003cfloat> | null"},"speech_understanding":{"x-label":"Speech Understanding","description":"Enable speech understanding tasks like [Translation](https://www.assemblyai.com/docs/speech-understanding/translation), [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification), and [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting). See the task-specific docs for available options and configuration.\n","type":"object","properties":{"request":{"oneOf":[{"type":"object","description":"Request body for [Translation](https://www.assemblyai.com/docs/speech-understanding/translation).","required":["translation"],"x-label":"Translation request body","properties":{"translation":{"type":"object","properties":{"target_languages":{"type":"array","items":{"type":"string","uniqueKey":"speech_understanding.request.oneOf.0.translation.target_languages.items.[INDEX]","typeLabel":"string"},"description":"List of target language codes (e.g., `[\"es\", \"de\"]`). See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for supported languages.","isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.0.translation.target_languages","typeLabel":"string[]"},"formal":{"type":"boolean","description":"Use formal language style. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","default":true,"uniqueKey":"speech_understanding.request.oneOf.0.translation.formal","typeLabel":"boolean"},"match_original_utterance":{"type":"boolean","description":"When enabled with Speaker Labels, returns translated text in the utterances array. Each utterance will include a `translated_texts` key containing translations for each target language.","default":false,"uniqueKey":"speech_understanding.request.oneOf.0.translation.match_original_utterance","typeLabel":"boolean"}},"required":["target_languages"],"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.0.translation","typeLabel":"object"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.0","typeLabel":"object"},{"type":"object","description":"Request body for [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification).","required":["speaker_identification"],"properties":{"speaker_identification":{"type":"object","properties":{"speaker_type":{"type":"string","enum":["role","name"],"description":"Type of speaker identification. See [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification) for details on each type.","isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speaker_type","typeLabel":"enum\u003cstring>"},"known_values":{"type":"array","items":{"type":"string","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.known_values.items.[INDEX]","typeLabel":"string"},"description":"Required if speaker_type is \"role\". Each value must be 35 characters or less.","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.known_values","typeLabel":"string[]"},"speakers":{"type":"array","description":"An array of speaker objects with metadata to improve identification accuracy. Each object should include a `role` or `name` (depending on `speaker_type`) and an optional `description` to help the model identify the speaker. You can also include any additional custom properties (e.g., `company`, `title`) to provide more context. Use this as an alternative to `known_values` when you want to provide additional context about each speaker.","items":{"type":"object","properties":{"role":{"type":"string","description":"The role of the speaker. Required when `speaker_type` is \"role\".","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers.items.[INDEX].role","typeLabel":"string"},"name":{"type":"string","description":"The name of the speaker. Required when `speaker_type` is \"name\".","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","description":"A description of the speaker to help the model identify them based on conversational context.","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers.items.[INDEX].description","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers","typeLabel":"object[]"}},"required":["speaker_type"],"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification","typeLabel":"object"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.1","typeLabel":"object"},{"type":"object","description":"Request body for [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting).","required":["custom_formatting"],"properties":{"custom_formatting":{"type":"object","properties":{"date":{"type":"string","description":"Date format pattern (e.g., `\"mm/dd/yyyy\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details.","uniqueKey":"speech_understanding.request.oneOf.2.custom_formatting.date","typeLabel":"string"},"phone_number":{"type":"string","description":"Phone number format pattern (e.g., `\"(xxx)xxx-xxxx\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details.","uniqueKey":"speech_understanding.request.oneOf.2.custom_formatting.phone_number","typeLabel":"string"},"email":{"type":"string","description":"Email format pattern (e.g., `\"username@domain.com\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details.","uniqueKey":"speech_understanding.request.oneOf.2.custom_formatting.email","typeLabel":"string"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.2.custom_formatting","typeLabel":"object"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.2","typeLabel":"object"},{"type":"object","description":"Request body for [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization).","required":["summarization"],"properties":{"summarization":{"type":"object","properties":{"summary_type":{"type":"string","enum":["paragraph","bullets"],"description":"Type of summary. Bullets returns short bullet point style summaries, paragraph is generally more verbose and detailed.","isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.3.summarization.summary_type","typeLabel":"enum\u003cstring>"},"effort":{"type":"string","enum":["low","medium"],"uniqueKey":"speech_understanding.request.oneOf.3.summarization.effort","typeLabel":"enum\u003cstring>"}},"required":["summary_type"],"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.3.summarization","typeLabel":"object"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.3","typeLabel":"object"},{"type":"object","description":"Request body for [Action Items](https://www.assemblyai.com/docs/speech-understanding/action-items).","required":["action_items"],"properties":{"action_items":{"type":"object","properties":{"include_decisions":{"type":"bool","description":"Option to include decision making in action items.","uniqueKey":"speech_understanding.request.oneOf.4.action_items.include_decisions","typeLabel":"bool"},"effort":{"type":"string","enum":["low","medium"],"uniqueKey":"speech_understanding.request.oneOf.4.action_items.effort","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.4.action_items","typeLabel":"object"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.4","typeLabel":"object"}],"isRequired":true,"uniqueKey":"speech_understanding.request","typeLabel":"object"}},"required":["request"],"uniqueKey":"speech_understanding","typeLabel":"object"},"summarization":{"x-label":"Enable Summarization","description":"Enable [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization), can be true or false. Requires both `punctuate` and `format_text` to be `true`, and cannot be enabled together with `auto_chapters`. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.\n\nNote: This parameter is only supported for the Universal-2 model.\n","type":"boolean","default":false,"deprecated":true,"uniqueKey":"summarization","typeLabel":"boolean"},"summary_model":{"type":"string","x-label":"Summary model","description":"The model to summarize the transcript. Must be set together with `summary_type`. Compatibility - `catchy` supports `gist` and `headline`; `informative` and `conversational` support `headline`, `paragraph`, `bullets`, and `bullets_verbose`. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.","x-fern-sdk-group-name":"transcripts","enum":["informative","conversational","catchy"],"x-aai-enum":{"informative":{"label":"Informative"},"conversational":{"label":"Conversational"},"catchy":{"label":"Catchy"}},"default":"informative","deprecated":true,"uniqueKey":"summary_model","typeLabel":"enum\u003cstring>"},"summary_type":{"type":"string","x-label":"Summary type","description":"The type of summary. Must be set together with `summary_model`; see `summary_model` for the supported model and type combinations. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.","x-fern-sdk-group-name":"transcripts","enum":["bullets","bullets_verbose","gist","headline","paragraph"],"x-aai-enum":{"bullets":{"label":"Bullets"},"bullets_verbose":{"label":"Bullets verbose"},"gist":{"label":"Gist"},"headline":{"label":"Headline"},"paragraph":{"label":"Paragraph"}},"default":"bullets","deprecated":true,"uniqueKey":"summary_type","typeLabel":"enum\u003cstring>"},"remove_audio_tags":{"oneOf":[{"type":"string","description":"AssemblyAI-STT-3.7 generates rich transcripts that can include inline annotations such as audio event markers and speaker cues. Set to `\"all\"` to remove all inline annotations, or `\"speaker\"` to remove only speaker cues while keeping other annotations. By default, all inline annotations are removed.\n\nNote: This parameter is only supported for the AssemblyAI-STT-3.7 model.\n","default":"all","enum":["all","speaker"],"x-label":"Remove audio tags","uniqueKey":"remove_audio_tags.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"AssemblyAI-STT-3.7 generates rich transcripts that can include inline annotations such as audio event markers and speaker cues. Set to `\"all\"` to remove all inline annotations, or `\"speaker\"` to remove only speaker cues while keeping other annotations. By default, all inline annotations are removed.\n\nNote: This parameter is only supported for the AssemblyAI-STT-3.7 model.\n","default":"all","x-label":"Remove audio tags","uniqueKey":"remove_audio_tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"remove_audio_tags","typeLabel":"enum\u003cstring> | null"},"temperature":{"x-label":"Temperature","description":"Control the amount of randomness injected into the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter only takes effect on the AssemblyAI-STT-3.7 model.\n","type":"number","minimum":0,"maximum":1,"default":0,"uniqueKey":"temperature","typeLabel":"number"},"webhook_auth_header_name":{"oneOf":[{"x-label":"Webhook auth header name","description":"The header name to be sent with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests. Must be 1-1000 characters and contain only ASCII letters, numbers, hyphens, and underscores. Requires `webhook_auth_header_value` and `webhook_url` to also be set.","type":"string","default":null,"uniqueKey":"webhook_auth_header_name.oneOf.0","typeLabel":"string"},{"x-label":"Webhook auth header name","description":"The header name to be sent with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests. Must be 1-1000 characters and contain only ASCII letters, numbers, hyphens, and underscores. Requires `webhook_auth_header_value` and `webhook_url` to also be set.","type":"null","default":null,"uniqueKey":"webhook_auth_header_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_auth_header_name","typeLabel":"string | null"},"webhook_auth_header_value":{"oneOf":[{"x-label":"Webhook auth header value","description":"The header value to send back with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests for added security. Must be 1-1000 characters and must not contain carriage returns or newlines. Requires `webhook_auth_header_name` and `webhook_url` to also be set.","type":"string","default":null,"uniqueKey":"webhook_auth_header_value.oneOf.0","typeLabel":"string"},{"x-label":"Webhook auth header value","description":"The header value to send back with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests for added security. Must be 1-1000 characters and must not contain carriage returns or newlines. Requires `webhook_auth_header_name` and `webhook_url` to also be set.","type":"null","default":null,"uniqueKey":"webhook_auth_header_value.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_auth_header_value","typeLabel":"string | null"},"webhook_url":{"x-label":"Webhook URL","description":"The URL to which we send [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests.\n","type":"string","format":"url","uniqueKey":"webhook_url","typeLabel":"string\u003curl>"},"custom_topics":{"x-label":"Enable custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","default":false,"deprecated":true,"uniqueKey":"custom_topics","typeLabel":"boolean"},"speech_model":{"oneOf":[{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","type":"string","deprecated":true,"uniqueKey":"speech_model.oneOf.0","typeLabel":"string"},{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","type":"null","deprecated":true,"uniqueKey":"speech_model.oneOf.1","typeLabel":"null"}],"uniqueKey":"speech_model","typeLabel":"string | null"},"topics":{"x-label":"Custom topics","description":"This parameter does not currently have any functionality attached to it.","type":"array","items":{"x-label":"Topic","type":"string","uniqueKey":"topics.items.[INDEX]","typeLabel":"string"},"deprecated":true,"uniqueKey":"topics","typeLabel":"string[]"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"speech_model":null,"language_detection":true,"language_confidence_threshold":0.7,"punctuate":true,"format_text":true,"multichannel":true,"webhook_url":"https://your-webhook-url/path","webhook_auth_header_name":"webhook-secret","webhook_auth_header_value":"webhook-secret-value","auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"speakers_expected":2,"content_safety":true,"iab_categories":true,"custom_spelling":[],"disfluencies":false,"sentiment_analysis":true,"auto_chapters":false,"entity_detection":true,"speech_threshold":0.5,"summarization":false,"summary_model":null,"summary_type":null,"custom_topics":true,"topics":[],"remove_audio_tags":null,"domain":null,"speech_understanding":{"request":{"translation":{"target_languages":["es","de"],"formal":true,"match_original_utterance":true}}},"audio_url":"https://assembly.ai/wildfires.mp3"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"9554c71c-df8c-4df5-a716-41e6a68f3032":{"x-label":"Transcript created","description":"Transcript created and queued for processing","content":{"application/json":{"schema":{"x-label":"Transcript","description":"A transcript object","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"properties":{"audio_url":{"x-label":"Audio URL","description":"The URL of the media that was transcribed","type":"string","format":"url","isRequired":true,"uniqueKey":"audio_url","typeLabel":"string\u003curl>"},"auto_highlights":{"x-label":"Key Phrases","description":"Whether [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases) is enabled, either true or false","type":"boolean","isRequired":true,"uniqueKey":"auto_highlights","typeLabel":"boolean"},"id":{"x-label":"ID","description":"The unique identifier of your transcript","type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"language_confidence":{"oneOf":[{"x-label":"Language confidence","description":"The confidence score for the detected language, between 0.0 (low confidence) and 1.0 (high confidence). See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"language_confidence.oneOf.0","typeLabel":"number\u003cdouble>"},{"x-label":"Language confidence","description":"The confidence score for the detected language, between 0.0 (low confidence) and 1.0 (high confidence). See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"null","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"language_confidence.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"language_confidence","typeLabel":"number\u003cdouble> | null"},"language_confidence_threshold":{"oneOf":[{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nSee [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"number","format":"float","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"language_confidence_threshold.oneOf.0","typeLabel":"number\u003cfloat>"},{"x-label":"Language confidence threshold","description":"The confidence threshold for the automatically detected language.\nAn error will be returned if the language confidence is below this threshold.\nSee [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"null","format":"float","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"language_confidence_threshold.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"language_confidence_threshold","typeLabel":"number\u003cfloat> | null"},"redact_pii":{"x-label":"Redact PII","description":"Whether [PII Redaction](https://www.assemblyai.com/docs/pii-redaction) is enabled, either true or false","type":"boolean","isRequired":true,"uniqueKey":"redact_pii","typeLabel":"boolean"},"status":{"x-label":"Status","type":"string","description":"The status of your transcript. Possible values are queued, processing, completed, or error.","x-fern-sdk-group-name":"transcripts","enum":["queued","processing","completed","error"],"x-fern-enum":{"queued":{"description":"The audio file is in the queue to be processed by the API."},"processing":{"description":"The audio file is being processed by the API."},"completed":{"description":"The transcript job has been completed successfully."},"error":{"description":"An error occurred while processing the audio file."}},"x-aai-enum":{"queued":{"label":"Queued"},"processing":{"label":"Processing"},"completed":{"label":"Completed"},"error":{"label":"Error"}},"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"summarization":{"x-label":"Summarization enabled","description":"Whether [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization) is enabled, either true or false. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.\n\nNote: This parameter is only supported for the Universal-2 model.\n","type":"boolean","deprecated":true,"isRequired":true,"uniqueKey":"summarization","typeLabel":"boolean"},"webhook_auth":{"x-label":"Webhook auth enabled","description":"Whether [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) authentication details were provided","type":"boolean","isRequired":true,"uniqueKey":"webhook_auth","typeLabel":"boolean"},"acoustic_model":{"x-label":"Acoustic model","description":"This parameter does not currently have any functionality attached to it.","type":"string","deprecated":true,"isRequired":true,"uniqueKey":"acoustic_model","typeLabel":"string"},"language_model":{"x-label":"Language model","description":"This parameter does not currently have any functionality attached to it.","type":"string","deprecated":true,"isRequired":true,"uniqueKey":"language_model","typeLabel":"string"},"speech_model":{"oneOf":[{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","type":"string","deprecated":true,"isRequired":true,"uniqueKey":"speech_model.oneOf.0","typeLabel":"string"},{"x-label":"Speech model","description":"This parameter has been replaced with the `speech_models` parameter, learn more about the `speech_models` parameter [here](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model).\n","type":"null","deprecated":true,"isRequired":true,"uniqueKey":"speech_model.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"speech_model","typeLabel":"string | null"},"audio_channels":{"x-label":"Audio channels","description":"The number of audio channels in the audio file. This is only present when [multichannel](https://www.assemblyai.com/docs/pre-recorded-audio/transcribe-multiple-audio-channels) is enabled.","type":"integer","uniqueKey":"audio_channels","typeLabel":"integer"},"audio_duration":{"oneOf":[{"x-label":"Audio duration","description":"The duration of this transcript object's media file, in seconds","type":"integer","uniqueKey":"audio_duration.oneOf.0","typeLabel":"integer"},{"x-label":"Audio duration","description":"The duration of this transcript object's media file, in seconds","type":"null","uniqueKey":"audio_duration.oneOf.1","typeLabel":"null"}],"uniqueKey":"audio_duration","typeLabel":"integer | null"},"audio_end_at":{"oneOf":[{"x-label":"Audio end at","description":"The point in time, in milliseconds, in the file at which the transcription was terminated. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer","uniqueKey":"audio_end_at.oneOf.0","typeLabel":"integer"},{"x-label":"Audio end at","description":"The point in time, in milliseconds, in the file at which the transcription was terminated. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"null","uniqueKey":"audio_end_at.oneOf.1","typeLabel":"null"}],"uniqueKey":"audio_end_at","typeLabel":"integer | null"},"audio_start_from":{"oneOf":[{"x-label":"Audio start from","description":"The point in time, in milliseconds, in the file at which the transcription was started. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"integer","uniqueKey":"audio_start_from.oneOf.0","typeLabel":"integer"},{"x-label":"Audio start from","description":"The point in time, in milliseconds, in the file at which the transcription was started. See [Set the start and end of the transcript](https://www.assemblyai.com/docs/pre-recorded-audio/set-the-start-and-end-of-the-transcript) for more details.","type":"null","uniqueKey":"audio_start_from.oneOf.1","typeLabel":"null"}],"uniqueKey":"audio_start_from","typeLabel":"integer | null"},"auto_chapters":{"oneOf":[{"x-label":"Auto Chapters enabled","description":"Whether [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters) is enabled, can be true or false. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible chapter summaries. See the [updated Auto Chapters page](https://www.assemblyai.com/docs/speech-understanding/auto-chapters) for details.\n\nNote: This parameter is only supported for the Universal-2 model.\n","type":"boolean","deprecated":true,"uniqueKey":"auto_chapters.oneOf.0","typeLabel":"boolean"},{"x-label":"Auto Chapters enabled","description":"Whether [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters) is enabled, can be true or false. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible chapter summaries. See the [updated Auto Chapters page](https://www.assemblyai.com/docs/speech-understanding/auto-chapters) for details.\n\nNote: This parameter is only supported for the Universal-2 model.\n","type":"null","deprecated":true,"uniqueKey":"auto_chapters.oneOf.1","typeLabel":"null"}],"uniqueKey":"auto_chapters","typeLabel":"boolean | null"},"auto_highlights_result":{"oneOf":[{"type":"object","description":"An array of results for the Key Phrases model, if it is enabled.\nSee [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases) for more information.\n","required":["status","results"],"x-label":"Key Phrases result","x-fern-sdk-group-name":"transcripts","example":{"status":"success","results":[{"count":1,"rank":0.08,"text":"air quality alerts","timestamps":[{"start":3978,"end":5114}]},{"count":1,"rank":0.08,"text":"wide ranging air quality consequences","timestamps":[{"start":235388,"end":238694}]},{"count":1,"rank":0.07,"text":"more wildfires","timestamps":[{"start":230972,"end":232354}]},{"count":1,"rank":0.07,"text":"air pollution","timestamps":[{"start":156004,"end":156910}]},{"count":3,"rank":0.07,"text":"weather systems","timestamps":[{"start":47344,"end":47958},{"start":205268,"end":205818},{"start":211588,"end":213434}]},{"count":2,"rank":0.06,"text":"high levels","timestamps":[{"start":121128,"end":121646},{"start":155412,"end":155866}]},{"count":1,"rank":0.06,"text":"health conditions","timestamps":[{"start":152138,"end":152666}]},{"count":2,"rank":0.06,"text":"Peter de Carlo","timestamps":[{"start":18948,"end":19930},{"start":268298,"end":269194}]},{"count":1,"rank":0.06,"text":"New York City","timestamps":[{"start":125768,"end":126274}]},{"count":1,"rank":0.05,"text":"respiratory conditions","timestamps":[{"start":152964,"end":153786}]},{"count":3,"rank":0.05,"text":"New York","timestamps":[{"start":125768,"end":126034},{"start":171448,"end":171938},{"start":176008,"end":176322}]},{"count":3,"rank":0.05,"text":"climate change","timestamps":[{"start":229548,"end":230230},{"start":244576,"end":245162},{"start":263348,"end":263950}]},{"count":1,"rank":0.05,"text":"Johns Hopkins University Varsity","timestamps":[{"start":23972,"end":25490}]},{"count":1,"rank":0.05,"text":"heart conditions","timestamps":[{"start":153988,"end":154506}]},{"count":1,"rank":0.05,"text":"air quality warnings","timestamps":[{"start":12308,"end":13434}]}]},"properties":{"status":{"x-label":"Status","x-fern-sdk-group-name":"transcripts","type":"string","description":"The status of the Key Phrases model. Either success, or unavailable in the rare case that the model failed.","enum":["success","unavailable"],"x-aai-enum":{"success":{"label":"Success"},"unavailable":{"label":"Unavailable"}},"isRequired":true,"uniqueKey":"auto_highlights_result.oneOf.0.status","typeLabel":"enum\u003cstring>"},"results":{"x-label":"Results","description":"A temporally-sequential array of Key Phrases","type":"array","items":{"x-label":"Auto highlight result","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["count","rank","text","timestamps"],"properties":{"count":{"x-label":"Count","description":"The total number of times the key phrase appears in the audio file","type":"integer","isRequired":true,"uniqueKey":"auto_highlights_result.oneOf.0.results.items.[INDEX].count","typeLabel":"integer"},"rank":{"x-label":"Rank","description":"The total relevancy to the overall audio file of this key phrase - a greater number means more relevant","type":"number","format":"float","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"auto_highlights_result.oneOf.0.results.items.[INDEX].rank","typeLabel":"number\u003cfloat>"},"text":{"x-label":"Text","description":"The text itself of the key phrase","type":"string","isRequired":true,"uniqueKey":"auto_highlights_result.oneOf.0.results.items.[INDEX].text","typeLabel":"string"},"timestamps":{"x-label":"Timestamps","description":"The timestamp of the of the key phrase","type":"array","items":{"x-label":"Timestamp","description":"Timestamp containing a start and end property in milliseconds","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"start":{"x-label":"Start","description":"The start time in milliseconds","type":"integer","isRequired":true,"uniqueKey":"auto_highlights_result.oneOf.0.results.items.[INDEX].timestamps.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The end time in milliseconds","type":"integer","isRequired":true,"uniqueKey":"auto_highlights_result.oneOf.0.results.items.[INDEX].timestamps.items.[INDEX].end","typeLabel":"integer"}},"required":["start","end"],"example":{"start":3978,"end":5114},"uniqueKey":"auto_highlights_result.oneOf.0.results.items.[INDEX].timestamps.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"auto_highlights_result.oneOf.0.results.items.[INDEX].timestamps","typeLabel":"object[]"}},"example":{"count":1,"rank":0.08,"text":"air quality alerts","timestamps":[{"start":3978,"end":5114}]},"uniqueKey":"auto_highlights_result.oneOf.0.results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"auto_highlights_result.oneOf.0.results","typeLabel":"object[]"}},"uniqueKey":"auto_highlights_result.oneOf.0","typeLabel":"object"},{"type":"null","description":"An array of results for the Key Phrases model, if it is enabled.\nSee [Key Phrases](https://www.assemblyai.com/docs/speech-understanding/key-phrases) for more information.\n","x-label":"Key Phrases result","uniqueKey":"auto_highlights_result.oneOf.1","typeLabel":"null"}],"uniqueKey":"auto_highlights_result","typeLabel":"object | null"},"chapters":{"oneOf":[{"x-label":"Chapters","description":"An array of temporally sequential chapters for the audio file. See [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters) for more information.","type":"array","items":{"x-label":"Chapter","description":"Chapter of the audio file","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"required":["gist","headline","summary","start","end"],"properties":{"gist":{"x-label":"Gist","description":"An ultra-short summary (just a few words) of the content spoken in the chapter","type":"string","isRequired":true,"uniqueKey":"chapters.oneOf.0.items.[INDEX].gist","typeLabel":"string"},"headline":{"x-label":"Headline","description":"A single sentence summary of the content spoken during the chapter","type":"string","isRequired":true,"uniqueKey":"chapters.oneOf.0.items.[INDEX].headline","typeLabel":"string"},"summary":{"x-label":"Summary","description":"A one paragraph summary of the content spoken during the chapter","type":"string","isRequired":true,"uniqueKey":"chapters.oneOf.0.items.[INDEX].summary","typeLabel":"string"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the chapter","type":"integer","isRequired":true,"uniqueKey":"chapters.oneOf.0.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The starting time, in milliseconds, for the chapter","type":"integer","isRequired":true,"uniqueKey":"chapters.oneOf.0.items.[INDEX].end","typeLabel":"integer"}},"example":{"summary":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. In some places, the air quality warnings include the warning to stay inside.","gist":"Smoggy air quality alerts across US","headline":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts across US","start":250,"end":28840},"uniqueKey":"chapters.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"chapters.oneOf.0","typeLabel":"object[]"},{"x-label":"Chapters","description":"An array of temporally sequential chapters for the audio file. See [Auto Chapters](https://www.assemblyai.com/docs/speech-understanding/auto-chapters) for more information.","type":"null","items":{"x-label":"Chapter","description":"Chapter of the audio file","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"required":["gist","headline","summary","start","end"],"properties":{"gist":{"x-label":"Gist","description":"An ultra-short summary (just a few words) of the content spoken in the chapter","type":"string"},"headline":{"x-label":"Headline","description":"A single sentence summary of the content spoken during the chapter","type":"string"},"summary":{"x-label":"Summary","description":"A one paragraph summary of the content spoken during the chapter","type":"string"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the chapter","type":"integer"},"end":{"x-label":"End","description":"The starting time, in milliseconds, for the chapter","type":"integer"}},"example":{"summary":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. In some places, the air quality warnings include the warning to stay inside.","gist":"Smoggy air quality alerts across US","headline":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts across US","start":250,"end":28840}},"uniqueKey":"chapters.oneOf.1","typeLabel":"null"}],"uniqueKey":"chapters","typeLabel":"object[] | null"},"confidence":{"oneOf":[{"x-label":"Confidence","description":"The confidence score for the transcript, between 0.0 (low confidence) and 1.0 (high confidence)","type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"confidence.oneOf.0","typeLabel":"number\u003cdouble>"},{"x-label":"Confidence","description":"The confidence score for the transcript, between 0.0 (low confidence) and 1.0 (high confidence)","type":"null","format":"double","minimum":0,"maximum":1,"uniqueKey":"confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"confidence","typeLabel":"number\u003cdouble> | null"},"content_safety":{"oneOf":[{"x-label":"Content Moderation","description":"Whether [Content Moderation](https://www.assemblyai.com/docs/content-moderation) is enabled, can be true or false","type":"boolean","uniqueKey":"content_safety.oneOf.0","typeLabel":"boolean"},{"x-label":"Content Moderation","description":"Whether [Content Moderation](https://www.assemblyai.com/docs/content-moderation) is enabled, can be true or false","type":"null","uniqueKey":"content_safety.oneOf.1","typeLabel":"null"}],"uniqueKey":"content_safety","typeLabel":"boolean | null"},"content_safety_labels":{"oneOf":[{"type":"object","description":"An array of results for the Content Moderation model, if it is enabled.\nSee [Content moderation](https://www.assemblyai.com/docs/content-moderation) for more information.\n","required":["status","results","summary","severity_score_summary"],"x-label":"Content Moderation labels","x-fern-sdk-group-name":"transcripts","example":{"status":"success","results":[{"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning.","labels":[{"label":"disasters","confidence":0.8142836093902588,"severity":0.4093044400215149}],"sentences_idx_start":0,"sentences_idx_end":5,"timestamp":{"start":250,"end":28840}}],"summary":{"disasters":0.9940800441842205,"health_issues":0.9216489289040967},"severity_score_summary":{"disasters":{"low":0.5733263024656846,"medium":0.42667369753431533,"high":0},"health_issues":{"low":0.22863814977924785,"medium":0.45014154926938227,"high":0.32122030095136983}}},"properties":{"status":{"x-label":"Status","x-fern-sdk-group-name":"transcripts","type":"string","description":"The status of the Content Moderation model. Either success, or unavailable in the rare case that the model failed.","enum":["success","unavailable"],"x-aai-enum":{"success":{"label":"Success"},"unavailable":{"label":"Unavailable"}},"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.status","typeLabel":"enum\u003cstring>"},"results":{"x-label":"Results","description":"An array of results for the Content Moderation model","type":"array","items":{"x-label":"Content Moderation label result","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["text","labels","sentences_idx_start","sentences_idx_end","timestamp"],"properties":{"text":{"x-label":"Text","description":"The transcript of the section flagged by the Content Moderation model","type":"string","isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].text","typeLabel":"string"},"labels":{"x-label":"Labels","description":"An array of safety labels, one per sensitive topic that was detected in the section","type":"array","items":{"x-label":"Label","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["label","confidence","severity"],"properties":{"label":{"x-label":"Label","description":"The label of the sensitive topic","type":"string","isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].labels.items.[INDEX].label","typeLabel":"string"},"confidence":{"x-label":"Confidence","description":"The confidence score for the topic being discussed, from 0 to 1","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].labels.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"},"severity":{"x-label":"Severity","description":"How severely the topic is discussed in the section, from 0 to 1","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].labels.items.[INDEX].severity","typeLabel":"number\u003cdouble>"}},"example":{"label":"disasters","confidence":0.8142836093902588,"severity":0.4093044400215149},"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].labels.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].labels","typeLabel":"object[]"},"sentences_idx_start":{"x-label":"Sentence index start","description":"The sentence index at which the section begins","type":"integer","isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].sentences_idx_start","typeLabel":"integer"},"sentences_idx_end":{"x-label":"Sentence index end","description":"The sentence index at which the section ends","type":"integer","isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].sentences_idx_end","typeLabel":"integer"},"timestamp":{"x-label":"Timestamp","description":"Timestamp information for the section","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"start":{"x-label":"Start","description":"The start time in milliseconds","type":"integer","isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].timestamp.start","typeLabel":"integer"},"end":{"x-label":"End","description":"The end time in milliseconds","type":"integer","isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].timestamp.end","typeLabel":"integer"}},"required":["start","end"],"example":{"start":3978,"end":5114},"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX].timestamp","typeLabel":"object"}},"example":{"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning.","labels":[{"label":"disasters","confidence":0.8142836093902588,"severity":0.4093044400215149}],"sentences_idx_start":0,"sentences_idx_end":5,"timestamp":{"start":250,"end":28840}},"uniqueKey":"content_safety_labels.oneOf.0.results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.results","typeLabel":"object[]"},"summary":{"x-label":"Summary","description":"A summary of the Content Moderation confidence results for the entire audio file","type":"object","additionalProperties":{"description":"A confidence score for the presence of the sensitive topic \"topic\" across the entire audio file","type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"content_safety_labels.oneOf.0.summary.additionalProperties","typeLabel":"number\u003cdouble>"},"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.summary","typeLabel":"object"},"severity_score_summary":{"x-label":"Severity score summary","description":"A summary of the Content Moderation severity results for the entire audio file","type":"object","additionalProperties":{"x-label":"Severity score summary","type":"object","x-fern-sdk-group-name":"transcripts","required":["low","medium","high"],"properties":{"low":{"x-label":"Low","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.severity_score_summary.additionalProperties.low","typeLabel":"number\u003cdouble>"},"medium":{"x-label":"Medium","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.severity_score_summary.additionalProperties.medium","typeLabel":"number\u003cdouble>"},"high":{"x-label":"High","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.severity_score_summary.additionalProperties.high","typeLabel":"number\u003cdouble>"}},"example":{"low":0.5733263024656846,"medium":0.42667369753431533,"high":0},"uniqueKey":"content_safety_labels.oneOf.0.severity_score_summary.additionalProperties","typeLabel":"object"},"isRequired":true,"uniqueKey":"content_safety_labels.oneOf.0.severity_score_summary","typeLabel":"object"}},"uniqueKey":"content_safety_labels.oneOf.0","typeLabel":"object"},{"type":"null","description":"An array of results for the Content Moderation model, if it is enabled.\nSee [Content moderation](https://www.assemblyai.com/docs/content-moderation) for more information.\n","x-label":"Content Moderation labels","uniqueKey":"content_safety_labels.oneOf.1","typeLabel":"null"}],"uniqueKey":"content_safety_labels","typeLabel":"object | null"},"custom_spelling":{"oneOf":[{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. Each `to` value must be a single word, and each `from` phrase can contain at most 5 words. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/correct-spelling-of-terms) for more details.","type":"array","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string","uniqueKey":"custom_spelling.oneOf.0.items.[INDEX].from.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"custom_spelling.oneOf.0.items.[INDEX].from","typeLabel":"string[]"},"to":{"x-label":"To","description":"Word to replace with","type":"string","isRequired":true,"uniqueKey":"custom_spelling.oneOf.0.items.[INDEX].to","typeLabel":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"},"uniqueKey":"custom_spelling.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"custom_spelling.oneOf.0","typeLabel":"object[]"},{"x-label":"Custom spellings","description":"Customize how words are spelled and formatted using to and from values. Each `to` value must be a single word, and each `from` phrase can contain at most 5 words. See [Custom Spelling](https://www.assemblyai.com/docs/pre-recorded-audio/correct-spelling-of-terms) for more details.","type":"null","items":{"x-label":"Custom spelling","description":"Object containing words or phrases to replace, and the word or phrase to replace with","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"from":{"x-label":"From","description":"Words or phrases to replace","type":"array","items":{"x-label":"Word or phrase","description":"Word or phrase to replace","type":"string"}},"to":{"x-label":"To","description":"Word to replace with","type":"string"}},"required":["from","to"],"example":{"from":["dicarlo"],"to":"Decarlo"}},"uniqueKey":"custom_spelling.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_spelling","typeLabel":"object[] | null"},"disfluencies":{"oneOf":[{"x-label":"Disfluencies","description":"Whether [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/include-filler-words), like \"umm\", are transcribed; either true or false. This is the value that was applied to the transcript, which is the value from the request or, when the request did not set it, the request's default (true when `speech_models` includes `assemblyai-stt-3-7`, false otherwise).","type":"boolean","uniqueKey":"disfluencies.oneOf.0","typeLabel":"boolean"},{"x-label":"Disfluencies","description":"Whether [Filler Words](https://www.assemblyai.com/docs/pre-recorded-audio/include-filler-words), like \"umm\", are transcribed; either true or false. This is the value that was applied to the transcript, which is the value from the request or, when the request did not set it, the request's default (true when `speech_models` includes `assemblyai-stt-3-7`, false otherwise).","type":"null","uniqueKey":"disfluencies.oneOf.1","typeLabel":"null"}],"uniqueKey":"disfluencies","typeLabel":"boolean | null"},"domain":{"oneOf":[{"x-label":"Domain","description":"The domain-specific model applied to the transcript. When set to `\"medical-v1\"`, [Medical Mode](https://www.assemblyai.com/docs/pre-recorded-audio/medical-mode) was used to improve accuracy for medication names. When set to `\"veterinary-v1\"`, [Veterinary Mode](https://www.assemblyai.com/docs/pre-recorded-audio/veterinary-mode) was used to improve accuracy for veterinary terminology.\n","type":"string","uniqueKey":"domain.oneOf.0","typeLabel":"string"},{"x-label":"Domain","description":"The domain-specific model applied to the transcript. When set to `\"medical-v1\"`, [Medical Mode](https://www.assemblyai.com/docs/pre-recorded-audio/medical-mode) was used to improve accuracy for medication names. When set to `\"veterinary-v1\"`, [Veterinary Mode](https://www.assemblyai.com/docs/pre-recorded-audio/veterinary-mode) was used to improve accuracy for veterinary terminology.\n","type":"null","uniqueKey":"domain.oneOf.1","typeLabel":"null"}],"uniqueKey":"domain","typeLabel":"string | null"},"entities":{"oneOf":[{"x-label":"Entities","description":"An array of results for the Entity Detection model, if it is enabled.\nSee [Entity detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection) for more information.\n","type":"array","items":{"x-label":"Entity","description":"A detected entity","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"required":["entity_type","text","start","end"],"properties":{"entity_type":{"x-label":"Entity type","description":"The type of entity for the detected entity","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender","gender_sexuality","healthcare_number","injury","ip_address","language","location","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","organization_medical_facility","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","sexuality","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Measurements of time expressed as a numerical value plus a unit (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender":{"description":"Terms indicating gender identity (e.g., female, male, non-binary)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"organization_medical_facility":{"description":"Name of a medical facility (e.g., Mayo Clinic, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"sexuality":{"description":"Terms indicating sexual orientation (e.g., heterosexual, bisexual, gay)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender":{"label":"Gender"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"organization_medical_facility":{"label":"Organization medical facility"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"sexuality":{"label":"Sexuality"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}},"isRequired":true,"uniqueKey":"entities.oneOf.0.items.[INDEX].entity_type","typeLabel":"enum\u003cstring>"},"text":{"x-label":"Text","description":"The text for the detected entity","type":"string","isRequired":true,"uniqueKey":"entities.oneOf.0.items.[INDEX].text","typeLabel":"string"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, at which the detected entity appears in the audio file","type":"integer","isRequired":true,"uniqueKey":"entities.oneOf.0.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the detected entity in the audio file","type":"integer","isRequired":true,"uniqueKey":"entities.oneOf.0.items.[INDEX].end","typeLabel":"integer"}},"example":{"entity_type":"location","text":"Canada","start":2548,"end":3130},"uniqueKey":"entities.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"entities.oneOf.0","typeLabel":"object[]"},{"x-label":"Entities","description":"An array of results for the Entity Detection model, if it is enabled.\nSee [Entity detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection) for more information.\n","type":"null","items":{"x-label":"Entity","description":"A detected entity","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"required":["entity_type","text","start","end"],"properties":{"entity_type":{"x-label":"Entity type","description":"The type of entity for the detected entity","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender","gender_sexuality","healthcare_number","injury","ip_address","language","location","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","organization_medical_facility","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","sexuality","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Measurements of time expressed as a numerical value plus a unit (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender":{"description":"Terms indicating gender identity (e.g., female, male, non-binary)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"organization_medical_facility":{"description":"Name of a medical facility (e.g., Mayo Clinic, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"sexuality":{"description":"Terms indicating sexual orientation (e.g., heterosexual, bisexual, gay)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender":{"label":"Gender"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"organization_medical_facility":{"label":"Organization medical facility"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"sexuality":{"label":"Sexuality"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}}},"text":{"x-label":"Text","description":"The text for the detected entity","type":"string"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, at which the detected entity appears in the audio file","type":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the detected entity in the audio file","type":"integer"}},"example":{"entity_type":"location","text":"Canada","start":2548,"end":3130}},"uniqueKey":"entities.oneOf.1","typeLabel":"null"}],"uniqueKey":"entities","typeLabel":"object[] | null"},"entity_detection":{"oneOf":[{"x-label":"Entity Detection","description":"Whether [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection) is enabled, can be true or false","type":"boolean","uniqueKey":"entity_detection.oneOf.0","typeLabel":"boolean"},{"x-label":"Entity Detection","description":"Whether [Entity Detection](https://www.assemblyai.com/docs/speech-understanding/entity-detection) is enabled, can be true or false","type":"null","uniqueKey":"entity_detection.oneOf.1","typeLabel":"null"}],"uniqueKey":"entity_detection","typeLabel":"boolean | null"},"error":{"x-label":"Error","description":"Error message of why the transcript failed","type":"string","uniqueKey":"error","typeLabel":"string"},"filter_profanity":{"oneOf":[{"x-label":"Filter profanity","description":"Whether [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) is enabled, either true or false","type":"boolean","uniqueKey":"filter_profanity.oneOf.0","typeLabel":"boolean"},{"x-label":"Filter profanity","description":"Whether [Profanity Filtering](https://www.assemblyai.com/docs/profanity-filtering) is enabled, either true or false","type":"null","uniqueKey":"filter_profanity.oneOf.1","typeLabel":"null"}],"uniqueKey":"filter_profanity","typeLabel":"boolean | null"},"format_text":{"oneOf":[{"x-label":"Format text","description":"Whether [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio) is enabled, either true or false","type":"boolean","uniqueKey":"format_text.oneOf.0","typeLabel":"boolean"},{"x-label":"Format text","description":"Whether [Text Formatting](https://www.assemblyai.com/docs/pre-recorded-audio) is enabled, either true or false","type":"null","uniqueKey":"format_text.oneOf.1","typeLabel":"null"}],"uniqueKey":"format_text","typeLabel":"boolean | null"},"iab_categories":{"oneOf":[{"x-label":"Topic Detection","description":"Whether [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection) is enabled, can be true or false","type":"boolean","uniqueKey":"iab_categories.oneOf.0","typeLabel":"boolean"},{"x-label":"Topic Detection","description":"Whether [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection) is enabled, can be true or false","type":"null","uniqueKey":"iab_categories.oneOf.1","typeLabel":"null"}],"uniqueKey":"iab_categories","typeLabel":"boolean | null"},"iab_categories_result":{"oneOf":[{"type":"object","description":"The result of the Topic Detection model, if it is enabled.\nSee [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection) for more information.\n","required":["status","results","summary"],"x-label":"Topic Detection result","x-fern-sdk-group-name":"transcripts","example":{"status":"success","results":[{"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning.","labels":[{"relevance":0.988274097442627,"label":"Home\u0026Garden>IndoorEnvironmentalQuality"},{"relevance":0.5821335911750793,"label":"NewsAndPolitics>Weather"},{"relevance":0.0042327106930315495,"label":"MedicalHealth>DiseasesAndConditions>LungAndRespiratoryHealth"},{"relevance":0.0033971222583204508,"label":"NewsAndPolitics>Disasters"},{"relevance":0.002469958271831274,"label":"BusinessAndFinance>Business>GreenSolutions"},{"relevance":0.0014376690378412604,"label":"MedicalHealth>DiseasesAndConditions>Cancer"},{"relevance":0.0014294233405962586,"label":"Science>Environment"},{"relevance":0.001234519761055708,"label":"Travel>TravelLocations>PolarTravel"},{"relevance":0.0010231725173071027,"label":"MedicalHealth>DiseasesAndConditions>ColdAndFlu"},{"relevance":0.0007445293595083058,"label":"BusinessAndFinance>Industries>PowerAndEnergyIndustry"}],"timestamp":{"start":250,"end":28840}}],"summary":{"NewsAndPolitics>Weather":1,"Home\u0026Garden>IndoorEnvironmentalQuality":0.9043831825256348,"Science>Environment":0.16117265820503235,"BusinessAndFinance>Industries>EnvironmentalServicesIndustry":0.14393523335456848,"MedicalHealth>DiseasesAndConditions>LungAndRespiratoryHealth":0.11401086300611496,"BusinessAndFinance>Business>GreenSolutions":0.06348437070846558,"NewsAndPolitics>Disasters":0.05041387677192688,"Travel>TravelLocations>PolarTravel":0.01308488193899393,"HealthyLiving":0.008222488686442375,"MedicalHealth>DiseasesAndConditions>ColdAndFlu":0.0022315620444715023,"MedicalHealth>DiseasesAndConditions>HeartAndCardiovascularDiseases":0.00213034451007843,"HealthyLiving>Wellness>SmokingCessation":0.001540527562610805,"MedicalHealth>DiseasesAndConditions>Injuries":0.0013950627762824297,"BusinessAndFinance>Industries>PowerAndEnergyIndustry":0.0012570273829624057,"MedicalHealth>DiseasesAndConditions>Cancer":0.001097781932912767,"MedicalHealth>DiseasesAndConditions>Allergies":0.0010148967849090695,"MedicalHealth>DiseasesAndConditions>MentalHealth":0.000717321818228811,"Style\u0026Fashion>PersonalCare>DeodorantAndAntiperspirant":0.0006022014422342181,"Technology\u0026Computing>Computing>ComputerNetworking":0.0005461975233629346,"MedicalHealth>DiseasesAndConditions>Injuries>FirstAid":0.0004885646631009877}},"properties":{"status":{"x-label":"Status","x-fern-sdk-group-name":"transcripts","type":"string","description":"The status of the Topic Detection model. Either success, or unavailable in the rare case that the model failed.","enum":["success","unavailable"],"x-aai-enum":{"success":{"label":"Success"},"unavailable":{"label":"Unavailable"}},"isRequired":true,"uniqueKey":"iab_categories_result.oneOf.0.status","typeLabel":"enum\u003cstring>"},"results":{"x-label":"Results","description":"An array of results for the Topic Detection model","type":"array","items":{"x-label":"Topic Detection result","description":"The result of the topic detection model","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"required":["text"],"properties":{"text":{"x-label":"Text","description":"The text in the transcript in which a detected topic occurs","type":"string","isRequired":true,"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX].text","typeLabel":"string"},"labels":{"x-label":"Labels","description":"An array of detected topics in the text","type":"array","items":{"x-label":"Label","type":"object","additionalProperties":false,"required":["relevance","label"],"properties":{"relevance":{"x-label":"Relevance","description":"How relevant the detected topic is of a detected topic","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX].labels.items.[INDEX].relevance","typeLabel":"number\u003cdouble>"},"label":{"x-label":"Label","description":"The IAB taxonomical label for the label of the detected topic, where > denotes supertopic/subtopic relationship","type":"string","isRequired":true,"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX].labels.items.[INDEX].label","typeLabel":"string"}},"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX].labels.items.[INDEX]","typeLabel":"object"},"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX].labels","typeLabel":"object[]"},"timestamp":{"x-label":"Timestamp","description":"Timestamp containing a start and end property in milliseconds","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"start":{"x-label":"Start","description":"The start time in milliseconds","type":"integer","isRequired":true,"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX].timestamp.start","typeLabel":"integer"},"end":{"x-label":"End","description":"The end time in milliseconds","type":"integer","isRequired":true,"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX].timestamp.end","typeLabel":"integer"}},"required":["start","end"],"example":{"start":3978,"end":5114},"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX].timestamp","typeLabel":"object"}},"example":{"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning.","labels":[{"relevance":0.988274097442627,"label":"Home\u0026Garden>IndoorEnvironmentalQuality"},{"relevance":0.5821335911750793,"label":"NewsAndPolitics>Weather"},{"relevance":0.0042327106930315495,"label":"MedicalHealth>DiseasesAndConditions>LungAndRespiratoryHealth"},{"relevance":0.0033971222583204508,"label":"NewsAndPolitics>Disasters"},{"relevance":0.002469958271831274,"label":"BusinessAndFinance>Business>GreenSolutions"},{"relevance":0.0014376690378412604,"label":"MedicalHealth>DiseasesAndConditions>Cancer"},{"relevance":0.0014294233405962586,"label":"Science>Environment"},{"relevance":0.001234519761055708,"label":"Travel>TravelLocations>PolarTravel"},{"relevance":0.0010231725173071027,"label":"MedicalHealth>DiseasesAndConditions>ColdAndFlu"},{"relevance":0.0007445293595083058,"label":"BusinessAndFinance>Industries>PowerAndEnergyIndustry"}],"timestamp":{"start":250,"end":28840}},"uniqueKey":"iab_categories_result.oneOf.0.results.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"iab_categories_result.oneOf.0.results","typeLabel":"object[]"},"summary":{"x-label":"Summary","description":"The overall relevance of topic to the entire audio file","type":"object","additionalProperties":{"type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"iab_categories_result.oneOf.0.summary.additionalProperties","typeLabel":"number\u003cdouble>"},"isRequired":true,"uniqueKey":"iab_categories_result.oneOf.0.summary","typeLabel":"object"}},"uniqueKey":"iab_categories_result.oneOf.0","typeLabel":"object"},{"type":"null","description":"The result of the Topic Detection model, if it is enabled.\nSee [Topic Detection](https://www.assemblyai.com/docs/speech-understanding/topic-detection) for more information.\n","x-label":"Topic Detection result","uniqueKey":"iab_categories_result.oneOf.1","typeLabel":"null"}],"uniqueKey":"iab_categories_result","typeLabel":"object | null"},"keyterms_prompt":{"x-label":"Keyterms prompt","description":"Improve accuracy with up to 200 (for Universal-2) or 1000 (for AssemblyAI-STT-3.7) domain-specific words or phrases (maximum 6 words per phrase). See [Keyterms Prompting](https://www.assemblyai.com/docs/pre-recorded-audio/prompting#keyterms-prompting) for more details.\n","type":"array","items":{"x-label":"Keyterm","type":"string","uniqueKey":"keyterms_prompt.items.[INDEX]","typeLabel":"string"},"uniqueKey":"keyterms_prompt","typeLabel":"string[]"},"language_code":{"oneOf":[{"type":"string","description":"The language of your audio file.\nPossible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\n","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","yue","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","xh","zu"],"x-label":"Language code","x-fern-sdk-group-name":"transcripts","x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"},"yue":{"label":"Cantonese"},"xh":{"label":"Xhosa"},"zu":{"label":"Zulu"}},"x-ts-type":"LiteralUnion\u003cTranscriptLanguageCode, string>","x-go-type":"TranscriptLanguageCode","uniqueKey":"language_code.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"string","description":"The language of your audio file.\nPossible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\n","x-label":"Language code","x-ts-type":"LiteralUnion\u003cTranscriptLanguageCode, string>","x-go-type":"TranscriptLanguageCode","uniqueKey":"language_code.oneOf.1","typeLabel":"string"}],"uniqueKey":"language_code","typeLabel":"enum\u003cstring> | string"},"language_codes":{"oneOf":[{"description":"The language codes of your audio file. Used for [Code switching](https://www.assemblyai.com/docs/pre-recorded-audio/code-switching). On AssemblyAI-STT-3.7, accepts any number of supported languages, and English isn't required. On Universal-2, accepts at most two languages, and one of them must be `en`. Can't be used together with `language_code` or `language_detection`.\n","type":"array","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","yue","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","xh","zu"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"},"yue":{"label":"Cantonese"},"xh":{"label":"Xhosa"},"zu":{"label":"Zulu"}},"uniqueKey":"language_codes.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"language_codes.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"description":"The language codes of your audio file. Used for [Code switching](https://www.assemblyai.com/docs/pre-recorded-audio/code-switching). On AssemblyAI-STT-3.7, accepts any number of supported languages, and English isn't required. On Universal-2, accepts at most two languages, and one of them must be `en`. Can't be used together with `language_code` or `language_detection`.\n","type":"null","items":{"x-label":"Language code","type":"string","description":"The language of your audio file. Possible values are found in [Supported Languages](https://www.assemblyai.com/docs/pre-recorded-audio/supported-languages).\n","x-fern-sdk-group-name":"transcripts","enum":["en","en_au","en_uk","en_us","es","fr","de","it","pt","nl","af","sq","am","ar","hy","as","az","ba","eu","be","bn","bs","br","bg","my","ca","zh","yue","hr","cs","da","et","fo","fi","gl","ka","el","gu","ht","ha","haw","he","hi","hu","is","id","ja","jw","kn","kk","km","ko","lo","la","lv","ln","lt","lb","mk","mg","ms","ml","mt","mi","mr","mn","ne","no","nn","oc","pa","ps","fa","pl","ro","ru","sa","sr","sn","sd","si","sk","sl","so","su","sw","sv","tl","tg","ta","tt","te","th","bo","tr","tk","uk","ur","uz","vi","cy","yi","yo","xh","zu"],"x-aai-enum":{"en":{"label":"English (global)"},"en_au":{"label":"English (Australian)"},"en_uk":{"label":"English (British)"},"en_us":{"label":"English (US)"},"es":{"label":"Spanish"},"fr":{"label":"French"},"de":{"label":"German"},"it":{"label":"Italian"},"pt":{"label":"Portuguese"},"nl":{"label":"Dutch"},"af":{"label":"Afrikaans"},"sq":{"label":"Albanian"},"am":{"label":"Amharic"},"ar":{"label":"Arabic"},"hy":{"label":"Armenian"},"as":{"label":"Assamese"},"az":{"label":"Azerbaijani"},"ba":{"label":"Bashkir"},"eu":{"label":"Basque"},"be":{"label":"Belarusian"},"bn":{"label":"Bengali"},"bs":{"label":"Bosnian"},"br":{"label":"Breton"},"bg":{"label":"Bulgarian"},"my":{"label":"Burmese"},"ca":{"label":"Catalan"},"zh":{"label":"Chinese"},"hr":{"label":"Croatian"},"cs":{"label":"Czech"},"da":{"label":"Danish"},"et":{"label":"Estonian"},"fo":{"label":"Faroese"},"fi":{"label":"Finnish"},"gl":{"label":"Galician"},"ka":{"label":"Georgian"},"el":{"label":"Greek"},"gu":{"label":"Gujarati"},"ht":{"label":"Haitian"},"ha":{"label":"Hausa"},"haw":{"label":"Hawaiian"},"he":{"label":"Hebrew"},"hi":{"label":"Hindi"},"hu":{"label":"Hungarian"},"is":{"label":"Icelandic"},"id":{"label":"Indonesian"},"ja":{"label":"Japanese"},"jw":{"label":"Javanese"},"kn":{"label":"Kannada"},"kk":{"label":"Kazakh"},"km":{"label":"Khmer"},"ko":{"label":"Korean"},"lo":{"label":"Lao"},"la":{"label":"Latin"},"lv":{"label":"Latvian"},"ln":{"label":"Lingala"},"lt":{"label":"Lithuanian"},"lb":{"label":"Luxembourgish"},"mk":{"label":"Macedonian"},"mg":{"label":"Malagasy"},"ms":{"label":"Malay"},"ml":{"label":"Malayalam"},"mt":{"label":"Maltese"},"mi":{"label":"Maori"},"mr":{"label":"Marathi"},"mn":{"label":"Mongolian"},"ne":{"label":"Nepali"},"no":{"label":"Norwegian"},"nn":{"label":"Norwegian Nynorsk"},"oc":{"label":"Occitan"},"pa":{"label":"Panjabi"},"ps":{"label":"Pashto"},"fa":{"label":"Persian"},"pl":{"label":"Polish"},"ro":{"label":"Romanian"},"ru":{"label":"Russian"},"sa":{"label":"Sanskrit"},"sr":{"label":"Serbian"},"sn":{"label":"Shona"},"sd":{"label":"Sindhi"},"si":{"label":"Sinhala"},"sk":{"label":"Slovak"},"sl":{"label":"Slovenian"},"so":{"label":"Somali"},"su":{"label":"Sundanese"},"sw":{"label":"Swahili"},"sv":{"label":"Swedish"},"tl":{"label":"Tagalog"},"tg":{"label":"Tajik"},"ta":{"label":"Tamil"},"tt":{"label":"Tatar"},"te":{"label":"Telugu"},"th":{"label":"Thai"},"bo":{"label":"Tibetan"},"tr":{"label":"Turkish"},"tk":{"label":"Turkmen"},"uk":{"label":"Ukrainian"},"ur":{"label":"Urdu"},"uz":{"label":"Uzbek"},"vi":{"label":"Vietnamese"},"cy":{"label":"Welsh"},"yi":{"label":"Yiddish"},"yo":{"label":"Yoruba"},"yue":{"label":"Cantonese"},"xh":{"label":"Xhosa"},"zu":{"label":"Zulu"}}},"uniqueKey":"language_codes.oneOf.1","typeLabel":"null"}],"uniqueKey":"language_codes","typeLabel":"enum\u003cstring>[] | null"},"language_detection":{"oneOf":[{"x-label":"Language detection","description":"Whether [Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) is enabled, either true or false","type":"boolean","uniqueKey":"language_detection.oneOf.0","typeLabel":"boolean"},{"x-label":"Language detection","description":"Whether [Automatic language detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) is enabled, either true or false","type":"null","uniqueKey":"language_detection.oneOf.1","typeLabel":"null"}],"uniqueKey":"language_detection","typeLabel":"boolean | null"},"language_detection_options":{"x-label":"Specify options for Automatic Language Detection.","description":"Specify options for [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection).","type":"object","additionalProperties":false,"properties":{"expected_languages":{"x-label":"Expected languages","description":"List of languages expected in the audio file. Defaults to `[\"all\"]` when unspecified. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.","type":"array","items":{"x-label":"language","type":"string","uniqueKey":"language_detection_options.expected_languages.items.[INDEX]","typeLabel":"string"},"uniqueKey":"language_detection_options.expected_languages","typeLabel":"string[]"},"fallback_language":{"x-label":"Fallback language","description":"If the detected language of the audio file is not in the list of expected languages, the `fallback_language` is used. Specify `\"auto\"` to let our model choose the fallback language from `expected_languages` with the highest confidence score. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","default":"auto","uniqueKey":"language_detection_options.fallback_language","typeLabel":"string"},"code_switching":{"x-label":"Code switching","description":"Whether [code switching](https://www.assemblyai.com/docs/pre-recorded-audio/code-switching) should be detected. Only supported on Universal-2. AssemblyAI-STT-3.7 code-switches natively, so this option doesn't apply to it.\n","type":"boolean","default":false,"uniqueKey":"language_detection_options.code_switching","typeLabel":"boolean"},"code_switching_confidence_threshold":{"x-label":"Code switching confidence threshold","description":"The confidence threshold for [code switching](https://www.assemblyai.com/docs/pre-recorded-audio/code-switching) detection. If the code switching confidence is below this threshold, the transcript will be processed in the language with the highest `language_detection_confidence` score.\n","type":"number","minimum":0,"maximum":1,"default":0.3,"uniqueKey":"language_detection_options.code_switching_confidence_threshold","typeLabel":"number"},"localization":{"x-label":"Localization","description":"Render the transcript in a regional variant of the detected language. Supported values are `en_au` (Australian English) and `en_uk` (British English) — only English is supported today, and you can specify at most one locale per base language. Base or default-region codes such as `en` and `en_us` are not localization variants and return a `400`.\n\nWhen the detected language matches the requested locale's base language, the transcript uses that locale's spelling and `language_code` returns the region-aware code (for example `en_au`) instead of the base `en`. Otherwise, when the detected language isn't available as a locale, the option is ignored. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"array","items":{"x-label":"locale","type":"string","uniqueKey":"language_detection_options.localization.items.[INDEX]","typeLabel":"string"},"uniqueKey":"language_detection_options.localization","typeLabel":"string[]"},"on_no_speech_detected":{"x-label":"On no speech detected","description":"Controls what happens when no speech is detected in the audio. With `error` (the default), the transcript fails and the reason is returned in `error`. With `fallback`, the transcript completes with an empty `text`, `language_code` is set to the `fallback_language`, and an explanatory warning is returned in `metadata.warnings`.\n\n`fallback` requires `fallback_language` to be set to a specific language code; `auto` returns a `400`. See [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) for more details.\n","type":"string","enum":["error","fallback"],"default":"error","uniqueKey":"language_detection_options.on_no_speech_detected","typeLabel":"enum\u003cstring>"}},"uniqueKey":"language_detection_options","typeLabel":"object"},"metadata":{"oneOf":[{"x-label":"Metadata","description":"Additional information about the transcript, including any warnings raised while processing the request.","type":"object","properties":{"warnings":{"oneOf":[{"x-label":"Warnings","description":"Warnings raised while processing the request, for example when [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) was skipped because the audio contained no speech.\n","type":"array","items":{"x-label":"Warning","type":"object","properties":{"message":{"x-label":"Message","description":"A human-readable description of the warning.","type":"string","uniqueKey":"metadata.oneOf.0.warnings.oneOf.0.items.[INDEX].message","typeLabel":"string"}},"uniqueKey":"metadata.oneOf.0.warnings.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"metadata.oneOf.0.warnings.oneOf.0","typeLabel":"object[]"},{"x-label":"Warnings","description":"Warnings raised while processing the request, for example when [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) was skipped because the audio contained no speech.\n","type":"null","items":{"x-label":"Warning","type":"object","properties":{"message":{"x-label":"Message","description":"A human-readable description of the warning.","type":"string"}}},"uniqueKey":"metadata.oneOf.0.warnings.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata.oneOf.0.warnings","typeLabel":"object[] | null"}},"uniqueKey":"metadata.oneOf.0","typeLabel":"object"},{"x-label":"Metadata","description":"Additional information about the transcript, including any warnings raised while processing the request.","type":"null","properties":{"warnings":{"oneOf":[{"x-label":"Warnings","description":"Warnings raised while processing the request, for example when [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) was skipped because the audio contained no speech.\n","type":"array","items":{"x-label":"Warning","type":"object","properties":{"message":{"x-label":"Message","description":"A human-readable description of the warning.","type":"string"}}}},{"x-label":"Warnings","description":"Warnings raised while processing the request, for example when [Automatic Language Detection](https://www.assemblyai.com/docs/pre-recorded-audio/language-detection) was skipped because the audio contained no speech.\n","type":"null","items":{"x-label":"Warning","type":"object","properties":{"message":{"x-label":"Message","description":"A human-readable description of the warning.","type":"string"}}}}]}},"uniqueKey":"metadata.oneOf.1","typeLabel":"null"}],"uniqueKey":"metadata","typeLabel":"object | null"},"multichannel":{"oneOf":[{"x-label":"Multichannel","description":"Whether [Multichannel transcription](https://www.assemblyai.com/docs/pre-recorded-audio/transcribe-multiple-audio-channels) was enabled in the transcription request, either true or false","type":"boolean","uniqueKey":"multichannel.oneOf.0","typeLabel":"boolean"},{"x-label":"Multichannel","description":"Whether [Multichannel transcription](https://www.assemblyai.com/docs/pre-recorded-audio/transcribe-multiple-audio-channels) was enabled in the transcription request, either true or false","type":"null","uniqueKey":"multichannel.oneOf.1","typeLabel":"null"}],"uniqueKey":"multichannel","typeLabel":"boolean | null"},"prompt":{"x-label":"Prompt","description":"Provide natural language prompting of up to 1,500 words of contextual information to the model. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for best practices.\n\nNote: This parameter is only supported for the AssemblyAI-STT-3.7 model.\n","type":"string","uniqueKey":"prompt","typeLabel":"string"},"punctuate":{"oneOf":[{"x-label":"Punctuate","description":"Whether [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio) is enabled, either true or false","type":"boolean","uniqueKey":"punctuate.oneOf.0","typeLabel":"boolean"},{"x-label":"Punctuate","description":"Whether [Automatic Punctuation](https://www.assemblyai.com/docs/pre-recorded-audio) is enabled, either true or false","type":"null","uniqueKey":"punctuate.oneOf.1","typeLabel":"null"}],"uniqueKey":"punctuate","typeLabel":"boolean | null"},"redact_pii_audio":{"oneOf":[{"x-label":"Redact PII audio","description":"Whether a redacted version of the audio file was generated,\neither true or false. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more information.\n","type":"boolean","uniqueKey":"redact_pii_audio.oneOf.0","typeLabel":"boolean"},{"x-label":"Redact PII audio","description":"Whether a redacted version of the audio file was generated,\neither true or false. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more information.\n","type":"null","uniqueKey":"redact_pii_audio.oneOf.1","typeLabel":"null"}],"uniqueKey":"redact_pii_audio","typeLabel":"boolean | null"},"redact_pii_audio_options":{"x-label":"Redact PII audio options","description":"The options for PII-redacted audio, if redact_pii_audio is enabled.\nSee [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more information.\n","type":"object","additionalProperties":false,"properties":{"return_redacted_no_speech_audio":{"x-label":"Return redacted no speech audio","description":"By default, audio redaction provides redacted audio URLs only when speech is detected. However, if your use-case specifically requires redacted audio files even for silent audio files without any dialogue, you can opt to receive these URLs by setting this parameter to `true`. Requires `redact_pii_audio` to be `true`.","type":"boolean","default":false,"uniqueKey":"redact_pii_audio_options.return_redacted_no_speech_audio","typeLabel":"boolean"},"override_audio_redaction_method":{"x-label":"Override audio redaction method","description":"Specify the method used to redact audio. By default, redacted audio uses a beep sound. Set to `silence` to replace PII with silence instead of a beep.","type":"string","enum":["silence"],"uniqueKey":"redact_pii_audio_options.override_audio_redaction_method","typeLabel":"enum\u003cstring>"}},"uniqueKey":"redact_pii_audio_options","typeLabel":"object"},"redact_pii_audio_quality":{"oneOf":[{"type":"string","description":"The audio quality of the PII-redacted audio file, if redact_pii_audio is enabled.\nSee [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more information.\n","enum":["mp3","wav"],"x-label":"Redact PII audio quality","x-fern-sdk-group-name":"transcripts","x-fern-enum":{"mp3":{"description":"MP3 audio format is lower quality and lower size than WAV.","casing":{"camel":"mp3","snake":"mp3","pascal":"Mp3","screamingSnake":"MP3"}},"wav":{"description":"WAV audio format is the highest quality (no compression) and larger size than MP3."}},"x-aai-enum":{"mp3":{"label":"MP3"},"wav":{"label":"WAV"}},"example":"mp3","uniqueKey":"redact_pii_audio_quality.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"The audio quality of the PII-redacted audio file, if redact_pii_audio is enabled.\nSee [PII redaction](https://www.assemblyai.com/docs/pii-redaction#request-for-redacted-audio) for more information.\n","x-label":"Redact PII audio quality","uniqueKey":"redact_pii_audio_quality.oneOf.1","typeLabel":"null"}],"uniqueKey":"redact_pii_audio_quality","typeLabel":"enum\u003cstring> | null"},"redact_pii_policies":{"oneOf":[{"x-label":"Redact PII policies","description":"The list of PII Redaction policies that were enabled, if PII Redaction is enabled.\nSee [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"array","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender","gender_sexuality","healthcare_number","injury","ip_address","language","location","location_address","location_address_street","location_city","location_coordinate","location_country","location_state","location_zip","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","organization_medical_facility","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","sexuality","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Measurements of time expressed as a numerical value plus a unit (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender":{"description":"Terms indicating gender identity (e.g., female, male, non-binary)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"location_address":{"description":"A complete mailing address (e.g., 145 Windsor St., Toronto, ON M5A 2P5)"},"location_address_street":{"description":"Street-level component of an address (e.g., 145 Windsor St.)"},"location_city":{"description":"City name (e.g., Toronto, San Francisco)"},"location_coordinate":{"description":"Geographic coordinates (e.g., 40.7128° N, 74.0060° W)"},"location_country":{"description":"Country name (e.g., Canada, United States)"},"location_state":{"description":"State, province, or region name (e.g., Ontario, California)"},"location_zip":{"description":"Postal or ZIP code (e.g., M5A 2P5, 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"organization_medical_facility":{"description":"Name of a medical facility (e.g., Mayo Clinic, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"sexuality":{"description":"Terms indicating sexual orientation (e.g., heterosexual, bisexual, gay)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender":{"label":"Gender"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"location_address":{"label":"Location address"},"location_address_street":{"label":"Location address street"},"location_city":{"label":"Location city"},"location_coordinate":{"label":"Location coordinate"},"location_country":{"label":"Location country"},"location_state":{"label":"Location state"},"location_zip":{"label":"Location ZIP"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"organization_medical_facility":{"label":"Organization medical facility"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"sexuality":{"label":"Sexuality"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}},"uniqueKey":"redact_pii_policies.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"redact_pii_policies.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"x-label":"Redact PII policies","description":"The list of PII Redaction policies that were enabled, if PII Redaction is enabled.\nSee [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"null","items":{"x-label":"PII policy","description":"The type of PII to redact","x-fern-sdk-group-name":"transcripts","type":"string","enum":["account_number","banking_information","blood_type","credit_card_cvv","credit_card_expiration","credit_card_number","date","date_interval","date_of_birth","drivers_license","drug","duration","email_address","event","filename","gender","gender_sexuality","healthcare_number","injury","ip_address","language","location","location_address","location_address_street","location_city","location_coordinate","location_country","location_state","location_zip","marital_status","medical_condition","medical_process","money_amount","nationality","number_sequence","occupation","organization","organization_medical_facility","passport_number","password","person_age","person_name","phone_number","physical_attribute","political_affiliation","religion","sexuality","statistics","time","url","us_social_security_number","username","vehicle_id","zodiac_sign"],"x-fern-enum":{"account_number":{"description":"Customer account or membership identification number (e.g., Policy No. 10042992, Member ID: HZ-5235-001)"},"banking_information":{"description":"Banking information, including account and routing numbers"},"blood_type":{"description":"Blood type (e.g., O-, AB positive)"},"credit_card_cvv":{"description":"Credit card verification code (e.g., CVV: 080)"},"credit_card_expiration":{"description":"Expiration date of a credit card"},"credit_card_number":{"description":"Credit card number"},"date":{"description":"Specific calendar date (e.g., December 18)"},"date_interval":{"description":"Broader time periods, including date ranges, months, seasons, years, and decades (e.g., 2020-2021, 5-9 May, January 1984)"},"date_of_birth":{"description":"Date of birth (e.g., Date of Birth: March 7,1961)"},"drivers_license":{"description":"Driver's license number. (e.g., DL# 356933-540)"},"drug":{"description":"Medications, vitamins, or supplements (e.g., Advil, Acetaminophen, Panadol)"},"duration":{"description":"Measurements of time expressed as a numerical value plus a unit (e.g., 8 months, 2 years)"},"email_address":{"description":"Email address (e.g., support@assemblyai.com)"},"event":{"description":"Name of an event or holiday (e.g., Olympics, Yom Kippur)"},"filename":{"description":"Names of computer files, including the extension or filepath (e.g., Taxes/2012/brad-tax-returns.pdf)"},"gender":{"description":"Terms indicating gender identity (e.g., female, male, non-binary)"},"gender_sexuality":{"description":"Terms indicating gender identity or sexual orientation, including slang terms (e.g., female, bisexual, trans)"},"healthcare_number":{"description":"Healthcare numbers and health plan beneficiary numbers (e.g., Policy No.: 5584-486-674-YM)"},"injury":{"description":"Bodily injury (e.g., I broke my arm, I have a sprained wrist)"},"ip_address":{"description":"Internet IP address, including IPv4 and IPv6 formats (e.g., 192.168.0.1)"},"language":{"description":"Name of a natural language (e.g., Spanish, French)"},"location":{"description":"Any Location reference including mailing address, postal code, city, state, province, country, or coordinates. (e.g., Lake Victoria, 145 Windsor St., 90210)"},"location_address":{"description":"A complete mailing address (e.g., 145 Windsor St., Toronto, ON M5A 2P5)"},"location_address_street":{"description":"Street-level component of an address (e.g., 145 Windsor St.)"},"location_city":{"description":"City name (e.g., Toronto, San Francisco)"},"location_coordinate":{"description":"Geographic coordinates (e.g., 40.7128° N, 74.0060° W)"},"location_country":{"description":"Country name (e.g., Canada, United States)"},"location_state":{"description":"State, province, or region name (e.g., Ontario, California)"},"location_zip":{"description":"Postal or ZIP code (e.g., M5A 2P5, 90210)"},"marital_status":{"description":"Terms indicating marital status (e.g., Single, common-law, ex-wife, married)"},"medical_condition":{"description":"Name of a medical condition, disease, syndrome, deficit, or disorder (e.g., chronic fatigue syndrome, arrhythmia, depression)"},"medical_process":{"description":"Medical process, including treatments, procedures, and tests (e.g., heart surgery, CT scan)"},"money_amount":{"description":"Name and/or amount of currency (e.g., 15 pesos, $94.50)"},"nationality":{"description":"Terms indicating nationality, ethnicity, or race (e.g., American, Asian, Caucasian)"},"number_sequence":{"description":"Numerical PII (including alphanumeric strings) that doesn't fall under other categories"},"occupation":{"description":"Job title or profession (e.g., professor, actors, engineer, CPA)"},"organization":{"description":"Name of an organization (e.g., CNN, McDonalds, University of Alaska, Northwest General Hospital)"},"organization_medical_facility":{"description":"Name of a medical facility (e.g., Mayo Clinic, Northwest General Hospital)"},"passport_number":{"description":"Passport numbers, issued by any country (e.g., PA4568332, NU3C6L86S12)"},"password":{"description":"Account passwords, PINs, access keys, or verification answers (e.g., 27%alfalfa, temp1234, My mother's maiden name is Smith)"},"person_age":{"description":"Number associated with an age (e.g., 27, 75)"},"person_name":{"description":"Name of a person (e.g., Bob, Doug Jones, Dr. Kay Martinez, MD)"},"phone_number":{"description":"Telephone or fax number"},"physical_attribute":{"description":"Distinctive bodily attributes, including race (e.g., I'm 190cm tall, He belongs to the Black students' association)"},"political_affiliation":{"description":"Terms referring to a political party, movement, or ideology (e.g., Republican, Liberal)"},"religion":{"description":"Terms indicating religious affiliation (e.g., Hindu, Catholic)"},"sexuality":{"description":"Terms indicating sexual orientation (e.g., heterosexual, bisexual, gay)"},"statistics":{"description":"Medical statistics (e.g., 18%, 18 percent)"},"time":{"description":"Expressions indicating clock times (e.g., 19:37:28, 10pm EST)"},"url":{"description":"Internet addresses (e.g., https://www.assemblyai.com/)"},"us_social_security_number":{"description":"Social Security Number or equivalent"},"username":{"description":"Usernames, login names, or handles (e.g., @AssemblyAI)"},"vehicle_id":{"description":"Vehicle identification numbers (VINs), vehicle serial numbers, and license plate numbers (e.g., 5FNRL38918B111818, BIF7547)"},"zodiac_sign":{"description":"Names of Zodiac signs (e.g., Aries, Taurus)"}},"x-aai-enum":{"account_number":{"label":"Account number"},"banking_information":{"label":"Banking information"},"blood_type":{"label":"Blood type"},"credit_card_cvv":{"label":"Credit card CVV"},"credit_card_expiration":{"label":"Credit card expiration"},"credit_card_number":{"label":"Credit card number"},"date":{"label":"Date"},"date_interval":{"label":"Date interval"},"date_of_birth":{"label":"Date of birth"},"drivers_license":{"label":"Driver's license"},"drug":{"label":"Drug"},"duration":{"label":"Duration"},"email_address":{"label":"Email address"},"event":{"label":"Event"},"filename":{"label":"Filename"},"gender":{"label":"Gender"},"gender_sexuality":{"label":"Gender sexuality"},"healthcare_number":{"label":"Healthcare number"},"injury":{"label":"Injury"},"ip_address":{"label":"IP address"},"language":{"label":"Language"},"location":{"label":"Location"},"location_address":{"label":"Location address"},"location_address_street":{"label":"Location address street"},"location_city":{"label":"Location city"},"location_coordinate":{"label":"Location coordinate"},"location_country":{"label":"Location country"},"location_state":{"label":"Location state"},"location_zip":{"label":"Location ZIP"},"marital_status":{"label":"Marital status"},"medical_condition":{"label":"Medical condition"},"medical_process":{"label":"Medical process"},"money_amount":{"label":"Money amount"},"nationality":{"label":"Nationality"},"number_sequence":{"label":"Number sequence"},"occupation":{"label":"Occupation"},"organization":{"label":"Organization"},"organization_medical_facility":{"label":"Organization medical facility"},"passport_number":{"label":"Passport number"},"password":{"label":"Password"},"person_age":{"label":"Person age"},"person_name":{"label":"Person name"},"phone_number":{"label":"Phone number"},"physical_attribute":{"label":"Physical attribute"},"political_affiliation":{"label":"Political affiliation"},"religion":{"label":"Religion"},"sexuality":{"label":"Sexuality"},"statistics":{"label":"Statistics"},"time":{"label":"Time"},"url":{"label":"URL"},"us_social_security_number":{"label":"US Social Security Number"},"username":{"label":"Username"},"vehicle_id":{"label":"Vehicle ID"},"zodiac_sign":{"label":"Zodiac sign"}}},"uniqueKey":"redact_pii_policies.oneOf.1","typeLabel":"null"}],"uniqueKey":"redact_pii_policies","typeLabel":"enum\u003cstring>[] | null"},"redact_pii_sub":{"x-label":"Redact PII substitution","type":"string","x-fern-sdk-group-name":"transcripts","description":"The replacement logic for detected PII, can be `entity_name` or `hash`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more details.","enum":["entity_name","hash"],"x-aai-enum":{"entity_name":{"label":"Entity name"},"hash":{"label":"Hash"}},"uniqueKey":"redact_pii_sub","typeLabel":"enum\u003cstring>"},"redact_pii_return_unredacted":{"oneOf":[{"x-label":"Return unredacted transcript","description":"Whether the original unredacted transcript was also returned alongside the redacted one. When `true`, the response includes `unredacted_text`, `unredacted_words`, and `unredacted_utterances`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"boolean","uniqueKey":"redact_pii_return_unredacted.oneOf.0","typeLabel":"boolean"},{"x-label":"Return unredacted transcript","description":"Whether the original unredacted transcript was also returned alongside the redacted one. When `true`, the response includes `unredacted_text`, `unredacted_words`, and `unredacted_utterances`. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"null","uniqueKey":"redact_pii_return_unredacted.oneOf.1","typeLabel":"null"}],"uniqueKey":"redact_pii_return_unredacted","typeLabel":"boolean | null"},"sentiment_analysis":{"oneOf":[{"x-label":"Sentiment Analysis","description":"Whether [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis) is enabled, can be true or false","type":"boolean","uniqueKey":"sentiment_analysis.oneOf.0","typeLabel":"boolean"},{"x-label":"Sentiment Analysis","description":"Whether [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis) is enabled, can be true or false","type":"null","uniqueKey":"sentiment_analysis.oneOf.1","typeLabel":"null"}],"uniqueKey":"sentiment_analysis","typeLabel":"boolean | null"},"sentiment_analysis_results":{"oneOf":[{"x-label":"Sentiment Analysis results","description":"An array of results for the Sentiment Analysis model, if it is enabled.\nSee [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis) for more information.\n","type":"array","items":{"x-label":"Sentiment Analysis result","description":"The result of the Sentiment Analysis model","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"required":["text","start","end","sentiment","confidence","speaker"],"properties":{"text":{"x-label":"Text","description":"The transcript of the sentence","type":"string","isRequired":true,"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].text","typeLabel":"string"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, of the sentence","type":"integer","isRequired":true,"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, of the sentence","type":"integer","isRequired":true,"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].end","typeLabel":"integer"},"sentiment":{"x-label":"Sentiment","x-fern-sdk-group-name":"transcripts","enum":["POSITIVE","NEUTRAL","NEGATIVE"],"x-aai-enum":{"POSITIVE":{"label":"Positive"},"NEUTRAL":{"label":"Neutral"},"NEGATIVE":{"label":"Negative"}},"description":"The detected sentiment for the sentence, one of POSITIVE, NEUTRAL, NEGATIVE","type":"string","isRequired":true,"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].sentiment","typeLabel":"enum\u003cstring>"},"confidence":{"x-label":"Confidence","description":"The confidence score for the detected sentiment of the sentence, from 0 to 1","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the sentence if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string","isRequired":true,"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].speaker.oneOf.0","typeLabel":"string"},{"x-label":"Speaker","description":"The speaker of the sentence if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null","isRequired":true,"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].speaker.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].speaker","typeLabel":"string | null"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string","uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].channel.oneOf.0","typeLabel":"string"},{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null","uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].channel.oneOf.1","typeLabel":"null"}],"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX].channel","typeLabel":"string | null"}},"example":{"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US.","start":250,"end":6350,"sentiment":"NEGATIVE","confidence":0.8181032538414001,"speaker":null},"uniqueKey":"sentiment_analysis_results.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"sentiment_analysis_results.oneOf.0","typeLabel":"object[]"},{"x-label":"Sentiment Analysis results","description":"An array of results for the Sentiment Analysis model, if it is enabled.\nSee [Sentiment Analysis](https://www.assemblyai.com/docs/speech-understanding/sentiment-analysis) for more information.\n","type":"null","items":{"x-label":"Sentiment Analysis result","description":"The result of the Sentiment Analysis model","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"required":["text","start","end","sentiment","confidence","speaker"],"properties":{"text":{"x-label":"Text","description":"The transcript of the sentence","type":"string"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, of the sentence","type":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, of the sentence","type":"integer"},"sentiment":{"x-label":"Sentiment","x-fern-sdk-group-name":"transcripts","enum":["POSITIVE","NEUTRAL","NEGATIVE"],"x-aai-enum":{"POSITIVE":{"label":"Positive"},"NEUTRAL":{"label":"Neutral"},"NEGATIVE":{"label":"Negative"}},"description":"The detected sentiment for the sentence, one of POSITIVE, NEUTRAL, NEGATIVE","type":"string"},"confidence":{"x-label":"Confidence","description":"The confidence score for the detected sentiment of the sentence, from 0 to 1","type":"number","format":"double","minimum":0,"maximum":1},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string"},{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null"}]},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the sentence if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string"},{"x-label":"Speaker","description":"The speaker of the sentence if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null"}]}},"example":{"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US.","start":250,"end":6350,"sentiment":"NEGATIVE","confidence":0.8181032538414001,"speaker":null}},"uniqueKey":"sentiment_analysis_results.oneOf.1","typeLabel":"null"}],"uniqueKey":"sentiment_analysis_results","typeLabel":"object[] | null"},"speaker_labels":{"oneOf":[{"x-label":"Speaker labels","description":"Whether [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, can be true or false","type":"boolean","uniqueKey":"speaker_labels.oneOf.0","typeLabel":"boolean"},{"x-label":"Speaker labels","description":"Whether [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, can be true or false","type":"null","uniqueKey":"speaker_labels.oneOf.1","typeLabel":"null"}],"uniqueKey":"speaker_labels","typeLabel":"boolean | null"},"speakers_expected":{"oneOf":[{"x-label":"Speakers expected","description":"Tell the speaker label model how many speakers it should attempt to identify. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers#set-number-of-speakers-expected) for more details.","type":"integer","uniqueKey":"speakers_expected.oneOf.0","typeLabel":"integer"},{"x-label":"Speakers expected","description":"Tell the speaker label model how many speakers it should attempt to identify. See [Set number of speakers expected](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers#set-number-of-speakers-expected) for more details.","type":"null","uniqueKey":"speakers_expected.oneOf.1","typeLabel":"null"}],"uniqueKey":"speakers_expected","typeLabel":"integer | null"},"speech_model_used":{"x-label":"Speech model used","type":"string","enum":["assemblyai-stt-3-7","universal-2"],"x-fern-sdk-group-name":"transcripts","description":"The speech model that was actually used for the transcription. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models.","uniqueKey":"speech_model_used","typeLabel":"enum\u003cstring>"},"speech_models":{"oneOf":[{"x-label":"Speech models","description":"List of speech models from the request that were considered to transcribe the audio. For new accounts created on or after November 17, 2026, if not specified in the request, this defaults to `[\"assemblyai-stt-3-7\"]`. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"array","items":{"x-label":"Speech model","type":"string","enum":["assemblyai-stt-3-7","universal-2"],"x-fern-sdk-group-name":"transcripts","uniqueKey":"speech_models.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"uniqueKey":"speech_models.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"x-label":"Speech models","description":"List of speech models from the request that were considered to transcribe the audio. For new accounts created on or after November 17, 2026, if not specified in the request, this defaults to `[\"assemblyai-stt-3-7\"]`. See [Model Selection](https://www.assemblyai.com/docs/pre-recorded-audio/select-the-speech-model) for available models and routing behavior.\n","type":"null","items":{"x-label":"Speech model","type":"string","enum":["assemblyai-stt-3-7","universal-2"],"x-fern-sdk-group-name":"transcripts"},"uniqueKey":"speech_models.oneOf.1","typeLabel":"null"}],"uniqueKey":"speech_models","typeLabel":"enum\u003cstring>[] | null"},"speech_threshold":{"oneOf":[{"x-label":"Speech threshold","description":"Defaults to null. Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"number","minimum":0,"maximum":1,"format":"float","uniqueKey":"speech_threshold.oneOf.0","typeLabel":"number\u003cfloat>"},{"x-label":"Speech threshold","description":"Defaults to null. Reject audio files that contain less than this fraction of speech.\nValid values are in the range [0, 1] inclusive. See [Speech Threshold](https://www.assemblyai.com/docs/speech-threshold) for more details.\n","type":"null","minimum":0,"maximum":1,"format":"float","uniqueKey":"speech_threshold.oneOf.1","typeLabel":"null"}],"uniqueKey":"speech_threshold","typeLabel":"number\u003cfloat> | null"},"speech_understanding":{"x-label":"Speech Understanding","description":"Speech understanding tasks like [Translation](https://www.assemblyai.com/docs/speech-understanding/translation), [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification), and [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting). See the task-specific docs for available options and configuration.\n","type":"object","properties":{"request":{"oneOf":[{"type":"object","description":"Request body for [Translation](https://www.assemblyai.com/docs/speech-understanding/translation).","required":["translation"],"x-label":"Translation request body","properties":{"translation":{"type":"object","properties":{"target_languages":{"type":"array","items":{"type":"string","uniqueKey":"speech_understanding.request.oneOf.0.translation.target_languages.items.[INDEX]","typeLabel":"string"},"description":"List of target language codes (e.g., `[\"es\", \"de\"]`). See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for supported languages.","isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.0.translation.target_languages","typeLabel":"string[]"},"formal":{"type":"boolean","description":"Use formal language style. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","default":true,"uniqueKey":"speech_understanding.request.oneOf.0.translation.formal","typeLabel":"boolean"},"match_original_utterance":{"type":"boolean","description":"When enabled with Speaker Labels, returns translated text in the utterances array. Each utterance will include a `translated_texts` key containing translations for each target language.","default":false,"uniqueKey":"speech_understanding.request.oneOf.0.translation.match_original_utterance","typeLabel":"boolean"}},"required":["target_languages"],"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.0.translation","typeLabel":"object"}},"uniqueKey":"speech_understanding.request.oneOf.0","typeLabel":"object"},{"type":"object","description":"Request body for [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification).","required":["speaker_identification"],"properties":{"speaker_identification":{"type":"object","properties":{"speaker_type":{"type":"string","enum":["role","name"],"description":"Type of speaker identification. See [Speaker Identification](https://www.assemblyai.com/docs/speech-understanding/speaker-identification) for details on each type.","isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speaker_type","typeLabel":"enum\u003cstring>"},"known_values":{"type":"array","items":{"type":"string","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.known_values.items.[INDEX]","typeLabel":"string"},"description":"Required if speaker_type is \"role\". Each value must be 35 characters or less.","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.known_values","typeLabel":"string[]"},"speakers":{"type":"array","description":"An array of speaker objects with metadata to improve identification accuracy. Each object should include a `role` or `name` (depending on `speaker_type`) and an optional `description` to help the model identify the speaker. You can also include any additional custom properties (e.g., `company`, `title`) to provide more context. Use this as an alternative to `known_values` when you want to provide additional context about each speaker.","items":{"type":"object","properties":{"role":{"type":"string","description":"The role of the speaker. Required when `speaker_type` is \"role\".","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers.items.[INDEX].role","typeLabel":"string"},"name":{"type":"string","description":"The name of the speaker. Required when `speaker_type` is \"name\".","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers.items.[INDEX].name","typeLabel":"string"},"description":{"type":"string","description":"A description of the speaker to help the model identify them based on conversational context.","uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers.items.[INDEX].description","typeLabel":"string"}},"additionalProperties":true,"uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification.speakers","typeLabel":"object[]"}},"required":["speaker_type"],"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.1.speaker_identification","typeLabel":"object"}},"uniqueKey":"speech_understanding.request.oneOf.1","typeLabel":"object"},{"type":"object","description":"Request body for [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting).","required":["custom_formatting"],"properties":{"custom_formatting":{"type":"object","properties":{"date":{"type":"string","description":"Date format pattern (e.g., `\"mm/dd/yyyy\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details.","uniqueKey":"speech_understanding.request.oneOf.2.custom_formatting.date","typeLabel":"string"},"phone_number":{"type":"string","description":"Phone number format pattern (e.g., `\"(xxx)xxx-xxxx\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details.","uniqueKey":"speech_understanding.request.oneOf.2.custom_formatting.phone_number","typeLabel":"string"},"email":{"type":"string","description":"Email format pattern (e.g., `\"username@domain.com\"`). See [Custom Formatting](https://www.assemblyai.com/docs/speech-understanding/custom-formatting) for more details.","uniqueKey":"speech_understanding.request.oneOf.2.custom_formatting.email","typeLabel":"string"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.2.custom_formatting","typeLabel":"object"}},"uniqueKey":"speech_understanding.request.oneOf.2","typeLabel":"object"},{"type":"object","description":"Request body for [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization).","required":["summarization"],"properties":{"summarization":{"type":"object","properties":{"summary_type":{"type":"string","enum":["paragraph","bullets"],"description":"Type of summary. Bullets returns short bullet point style summaries, paragraph is generally more verbose and detailed.","isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.3.summarization.summary_type","typeLabel":"enum\u003cstring>"},"effort":{"type":"string","enum":["low","medium"],"uniqueKey":"speech_understanding.request.oneOf.3.summarization.effort","typeLabel":"enum\u003cstring>"}},"required":["summary_type"],"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.3.summarization","typeLabel":"object"}},"uniqueKey":"speech_understanding.request.oneOf.3","typeLabel":"object"},{"type":"object","description":"Request body for [Action Items](https://www.assemblyai.com/docs/speech-understanding/action-items).","required":["action_items"],"properties":{"action_items":{"type":"object","properties":{"include_decisions":{"type":"bool","description":"Option to include decision making in action items.","uniqueKey":"speech_understanding.request.oneOf.4.action_items.include_decisions","typeLabel":"bool"},"effort":{"type":"string","enum":["low","medium"],"uniqueKey":"speech_understanding.request.oneOf.4.action_items.effort","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"speech_understanding.request.oneOf.4.action_items","typeLabel":"object"}},"uniqueKey":"speech_understanding.request.oneOf.4","typeLabel":"object"}],"uniqueKey":"speech_understanding.request","typeLabel":"object"},"response":{"oneOf":[{"type":"object","properties":{"translation":{"type":"object","properties":{"status":{"type":"string","uniqueKey":"speech_understanding.response.oneOf.0.translation.status","typeLabel":"string"}},"uniqueKey":"speech_understanding.response.oneOf.0.translation","typeLabel":"object"}},"uniqueKey":"speech_understanding.response.oneOf.0","typeLabel":"object"},{"type":"object","properties":{"speaker_identification":{"type":"object","properties":{"mapping":{"type":"object","description":"A mapping of the original generic speaker labels (e.g., \"A\", \"B\") to the identified speaker names or roles.","additionalProperties":{"type":"string","uniqueKey":"speech_understanding.response.oneOf.1.speaker_identification.mapping.additionalProperties","typeLabel":"string"},"uniqueKey":"speech_understanding.response.oneOf.1.speaker_identification.mapping","typeLabel":"object"},"status":{"type":"string","uniqueKey":"speech_understanding.response.oneOf.1.speaker_identification.status","typeLabel":"string"}},"uniqueKey":"speech_understanding.response.oneOf.1.speaker_identification","typeLabel":"object"}},"uniqueKey":"speech_understanding.response.oneOf.1","typeLabel":"object"},{"type":"object","properties":{"custom_formatting":{"type":"object","properties":{"mapping":{"type":"object","additionalProperties":{"type":"string","uniqueKey":"speech_understanding.response.oneOf.2.custom_formatting.mapping.additionalProperties","typeLabel":"string"},"uniqueKey":"speech_understanding.response.oneOf.2.custom_formatting.mapping","typeLabel":"object"},"formatted_text":{"type":"string","uniqueKey":"speech_understanding.response.oneOf.2.custom_formatting.formatted_text","typeLabel":"string"}},"uniqueKey":"speech_understanding.response.oneOf.2.custom_formatting","typeLabel":"object"}},"uniqueKey":"speech_understanding.response.oneOf.2","typeLabel":"object"},{"type":"object","properties":{"summarization":{"type":"object","properties":{"summary":{"type":"array","description":"Array of summaries.","items":{"type":"object","uniqueKey":"speech_understanding.response.oneOf.3.summarization.summary.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"speech_understanding.response.oneOf.3.summarization.summary","typeLabel":"object[]"},"status":{"type":"string","isRequired":true,"uniqueKey":"speech_understanding.response.oneOf.3.summarization.status","typeLabel":"string"}},"required":["summary","status"],"uniqueKey":"speech_understanding.response.oneOf.3.summarization","typeLabel":"object"}},"uniqueKey":"speech_understanding.response.oneOf.3","typeLabel":"object"},{"type":"object","properties":{"action_items":{"type":"object","properties":{"status":{"type":"string","isRequired":true,"uniqueKey":"speech_understanding.response.oneOf.4.action_items.status","typeLabel":"string"},"items":{"type":"array","description":"Array of action items.","items":{"type":"object","uniqueKey":"speech_understanding.response.oneOf.4.action_items.\\items.items.[INDEX]","typeLabel":"object"},"uniqueKey":"speech_understanding.response.oneOf.4.action_items.\\items","typeLabel":"object[]"}},"required":["action_items","status"],"uniqueKey":"speech_understanding.response.oneOf.4.action_items","typeLabel":"object"}},"uniqueKey":"speech_understanding.response.oneOf.4","typeLabel":"object"}],"uniqueKey":"speech_understanding.response","typeLabel":"object"}},"uniqueKey":"speech_understanding","typeLabel":"object"},"summary":{"oneOf":[{"x-label":"Summary","description":"The generated summary of the media file, if [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization) is enabled. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.","type":"string","deprecated":true,"uniqueKey":"summary.oneOf.0","typeLabel":"string"},{"x-label":"Summary","description":"The generated summary of the media file, if [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization) is enabled. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.","type":"null","deprecated":true,"uniqueKey":"summary.oneOf.1","typeLabel":"null"}],"uniqueKey":"summary","typeLabel":"string | null"},"summary_model":{"oneOf":[{"x-label":"Summary model","description":"The Summarization model used to generate the summary,\nif [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization) is enabled. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.\n","type":"string","deprecated":true,"uniqueKey":"summary_model.oneOf.0","typeLabel":"string"},{"x-label":"Summary model","description":"The Summarization model used to generate the summary,\nif [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization) is enabled. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.\n","type":"null","deprecated":true,"uniqueKey":"summary_model.oneOf.1","typeLabel":"null"}],"uniqueKey":"summary_model","typeLabel":"string | null"},"summary_type":{"oneOf":[{"x-label":"Summary type","description":"The type of summary generated, if [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization) is enabled. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.","type":"string","deprecated":true,"uniqueKey":"summary_type.oneOf.0","typeLabel":"string"},{"x-label":"Summary type","description":"The type of summary generated, if [Summarization](https://www.assemblyai.com/docs/speech-understanding/summarization) is enabled. Deprecated - use [LLM Gateway](https://www.assemblyai.com/docs/llm-gateway/quickstart) instead for more flexible summaries. See the [updated Summarization page](https://www.assemblyai.com/docs/speech-understanding/summarization) for details.","type":"null","deprecated":true,"uniqueKey":"summary_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"summary_type","typeLabel":"string | null"},"remove_audio_tags":{"oneOf":[{"type":"string","description":"AssemblyAI-STT-3.7 generates rich transcripts that can include inline annotations such as audio event markers and speaker cues. Set to `\"all\"` to remove all inline annotations, or `\"speaker\"` to remove only speaker cues while keeping other annotations. By default, all inline annotations are removed.\n\nNote: This parameter is only supported for the AssemblyAI-STT-3.7 model.\n","enum":["all","speaker"],"x-label":"Remove audio tags","uniqueKey":"remove_audio_tags.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","description":"AssemblyAI-STT-3.7 generates rich transcripts that can include inline annotations such as audio event markers and speaker cues. Set to `\"all\"` to remove all inline annotations, or `\"speaker\"` to remove only speaker cues while keeping other annotations. By default, all inline annotations are removed.\n\nNote: This parameter is only supported for the AssemblyAI-STT-3.7 model.\n","x-label":"Remove audio tags","uniqueKey":"remove_audio_tags.oneOf.1","typeLabel":"null"}],"uniqueKey":"remove_audio_tags","typeLabel":"enum\u003cstring> | null"},"temperature":{"oneOf":[{"x-label":"Temperature","description":"The temperature that was used for the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter only takes effect on the AssemblyAI-STT-3.7 model.\n","type":"number","minimum":0,"maximum":1,"uniqueKey":"temperature.oneOf.0","typeLabel":"number"},{"x-label":"Temperature","description":"The temperature that was used for the model's response. See the [Prompting Guide](https://www.assemblyai.com/docs/pre-recorded-audio/prompting) for more details.\n\nNote: This parameter only takes effect on the AssemblyAI-STT-3.7 model.\n","type":"null","minimum":0,"maximum":1,"uniqueKey":"temperature.oneOf.1","typeLabel":"null"}],"uniqueKey":"temperature","typeLabel":"number | null"},"text":{"oneOf":[{"x-label":"Text","description":"The textual transcript of your media file","type":"string","uniqueKey":"text.oneOf.0","typeLabel":"string"},{"x-label":"Text","description":"The textual transcript of your media file","type":"null","uniqueKey":"text.oneOf.1","typeLabel":"null"}],"uniqueKey":"text","typeLabel":"string | null"},"unredacted_text":{"oneOf":[{"x-label":"Unredacted text","description":"The original textual transcript of your media file before PII redaction was applied. Only returned when `redact_pii_return_unredacted` was set to `true` on the transcription request, otherwise this field is omitted and the `text` field remains fully redacted. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"string","uniqueKey":"unredacted_text.oneOf.0","typeLabel":"string"},{"x-label":"Unredacted text","description":"The original textual transcript of your media file before PII redaction was applied. Only returned when `redact_pii_return_unredacted` was set to `true` on the transcription request, otherwise this field is omitted and the `text` field remains fully redacted. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"null","uniqueKey":"unredacted_text.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_text","typeLabel":"string | null"},"throttled":{"oneOf":[{"x-label":"Throttled","description":"True while a request is throttled and false when a request is no longer throttled","type":"boolean","uniqueKey":"throttled.oneOf.0","typeLabel":"boolean"},{"x-label":"Throttled","description":"True while a request is throttled and false when a request is no longer throttled","type":"null","uniqueKey":"throttled.oneOf.1","typeLabel":"null"}],"uniqueKey":"throttled","typeLabel":"boolean | null"},"utterances":{"oneOf":[{"x-label":"Utterances","description":"When multichannel or speaker_labels is enabled, a list of turn-by-turn utterance objects.\nSee [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) and [Multichannel transcription](https://www.assemblyai.com/docs/pre-recorded-audio/transcribe-multiple-audio-channels) for more information.\n","type":"array","items":{"type":"object","x-label":"Utterance","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this utterance","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, of the utterance in the audio file","type":"integer","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, of the utterance in the audio file","type":"integer","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].end","typeLabel":"integer"},"text":{"x-label":"Text","description":"The text for this utterance","type":"string","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].text","typeLabel":"string"},"words":{"x-label":"Words","description":"The words in the utterance.","type":"array","items":{"x-label":"Word","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["confidence","start","end","text","speaker"],"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this word","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the word","type":"integer","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the word","type":"integer","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].end","typeLabel":"integer"},"text":{"x-label":"Text","description":"The text of the word","type":"string","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].text","typeLabel":"string"},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker.oneOf.0","typeLabel":"string"},{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker","typeLabel":"string | null"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string","uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].channel.oneOf.0","typeLabel":"string"},{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null","uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].channel.oneOf.1","typeLabel":"null"}],"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].channel","typeLabel":"string | null"},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker_confidence.oneOf.0","typeLabel":"number\u003cdouble>"},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker_confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker_confidence","typeLabel":"number\u003cdouble> | null"}},"example":{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"channel":null,"speaker":null},"uniqueKey":"utterances.oneOf.0.items.[INDEX].words.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].words","typeLabel":"object[]"},"speaker":{"x-label":"Speaker","description":"The speaker of this utterance, where each speaker is assigned a sequential capital letter - e.g. \"A\" for Speaker A, \"B\" for Speaker B, etc.","type":"string","isRequired":true,"uniqueKey":"utterances.oneOf.0.items.[INDEX].speaker","typeLabel":"string"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string","uniqueKey":"utterances.oneOf.0.items.[INDEX].channel.oneOf.0","typeLabel":"string"},{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null","uniqueKey":"utterances.oneOf.0.items.[INDEX].channel.oneOf.1","typeLabel":"null"}],"uniqueKey":"utterances.oneOf.0.items.[INDEX].channel","typeLabel":"string | null"},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this utterance, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"utterances.oneOf.0.items.[INDEX].speaker_confidence.oneOf.0","typeLabel":"number\u003cdouble>"},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this utterance, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1,"uniqueKey":"utterances.oneOf.0.items.[INDEX].speaker_confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"utterances.oneOf.0.items.[INDEX].speaker_confidence","typeLabel":"number\u003cdouble> | null"},"translated_texts":{"x-label":"Translated texts","description":"Translations keyed by language code (e.g., `{\"es\": \"Texto traducido\", \"de\": \"Übersetzter Text\"}`). Only present when `match_original_utterance` is enabled with translation.","type":"object","additionalProperties":{"type":"string","uniqueKey":"utterances.oneOf.0.items.[INDEX].translated_texts.additionalProperties","typeLabel":"string"},"uniqueKey":"utterances.oneOf.0.items.[INDEX].translated_texts","typeLabel":"object"}},"required":["confidence","start","end","text","words","speaker"],"example":{"confidence":0.9359033333333334,"end":26950,"speaker":"A","start":250,"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor.","words":[{"text":"Smoke","start":250,"end":650,"confidence":0.97503,"speaker":"A"},{"text":"from","start":730,"end":1022,"confidence":0.99999,"speaker":"A"},{"text":"hundreds","start":1076,"end":1418,"confidence":0.99843,"speaker":"A"},{"text":"of","start":1434,"end":1614,"confidence":0.85,"speaker":"A"},{"text":"wildfires","start":1652,"end":2346,"confidence":0.89657,"speaker":"A"},{"text":"in","start":2378,"end":2526,"confidence":0.99994,"speaker":"A"},{"text":"Canada","start":2548,"end":3130,"confidence":0.93864,"speaker":"A"},{"text":"is","start":3210,"end":3454,"confidence":0.999,"speaker":"A"},{"text":"triggering","start":3492,"end":3946,"confidence":0.75366,"speaker":"A"},{"text":"air","start":3978,"end":4174,"confidence":1,"speaker":"A"},{"text":"quality","start":4212,"end":4558,"confidence":0.87745,"speaker":"A"},{"text":"alerts","start":4644,"end":5114,"confidence":0.94739,"speaker":"A"},{"text":"throughout","start":5162,"end":5466,"confidence":0.99726,"speaker":"A"},{"text":"the","start":5498,"end":5694,"confidence":0.79,"speaker":"A"},{"text":"US.","start":5732,"end":6382,"confidence":0.88,"speaker":"A"}]},"uniqueKey":"utterances.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"utterances.oneOf.0","typeLabel":"object[]"},{"x-label":"Utterances","description":"When multichannel or speaker_labels is enabled, a list of turn-by-turn utterance objects.\nSee [Speaker diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) and [Multichannel transcription](https://www.assemblyai.com/docs/pre-recorded-audio/transcribe-multiple-audio-channels) for more information.\n","type":"null","items":{"type":"object","x-label":"Utterance","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this utterance","type":"number","format":"double","minimum":0,"maximum":1},"start":{"x-label":"Start","description":"The starting time, in milliseconds, of the utterance in the audio file","type":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, of the utterance in the audio file","type":"integer"},"text":{"x-label":"Text","description":"The text for this utterance","type":"string"},"words":{"x-label":"Words","description":"The words in the utterance.","type":"array","items":{"x-label":"Word","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["confidence","start","end","text","speaker"],"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this word","type":"number","format":"double","minimum":0,"maximum":1},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the word","type":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the word","type":"integer"},"text":{"x-label":"Text","description":"The text of the word","type":"string"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string"},{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null"}]},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string"},{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null"}]},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1}]}},"example":{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"channel":null,"speaker":null}}},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string"},{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null"}]},"speaker":{"x-label":"Speaker","description":"The speaker of this utterance, where each speaker is assigned a sequential capital letter - e.g. \"A\" for Speaker A, \"B\" for Speaker B, etc.","type":"string"},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this utterance, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this utterance, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1}]},"translated_texts":{"x-label":"Translated texts","description":"Translations keyed by language code (e.g., `{\"es\": \"Texto traducido\", \"de\": \"Übersetzter Text\"}`). Only present when `match_original_utterance` is enabled with translation.","type":"object","additionalProperties":{"type":"string"}}},"required":["confidence","start","end","text","words","speaker"],"example":{"confidence":0.9359033333333334,"end":26950,"speaker":"A","start":250,"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor.","words":[{"text":"Smoke","start":250,"end":650,"confidence":0.97503,"speaker":"A"},{"text":"from","start":730,"end":1022,"confidence":0.99999,"speaker":"A"},{"text":"hundreds","start":1076,"end":1418,"confidence":0.99843,"speaker":"A"},{"text":"of","start":1434,"end":1614,"confidence":0.85,"speaker":"A"},{"text":"wildfires","start":1652,"end":2346,"confidence":0.89657,"speaker":"A"},{"text":"in","start":2378,"end":2526,"confidence":0.99994,"speaker":"A"},{"text":"Canada","start":2548,"end":3130,"confidence":0.93864,"speaker":"A"},{"text":"is","start":3210,"end":3454,"confidence":0.999,"speaker":"A"},{"text":"triggering","start":3492,"end":3946,"confidence":0.75366,"speaker":"A"},{"text":"air","start":3978,"end":4174,"confidence":1,"speaker":"A"},{"text":"quality","start":4212,"end":4558,"confidence":0.87745,"speaker":"A"},{"text":"alerts","start":4644,"end":5114,"confidence":0.94739,"speaker":"A"},{"text":"throughout","start":5162,"end":5466,"confidence":0.99726,"speaker":"A"},{"text":"the","start":5498,"end":5694,"confidence":0.79,"speaker":"A"},{"text":"US.","start":5732,"end":6382,"confidence":0.88,"speaker":"A"}]}},"uniqueKey":"utterances.oneOf.1","typeLabel":"null"}],"uniqueKey":"utterances","typeLabel":"object[] | null"},"unredacted_utterances":{"oneOf":[{"x-label":"Unredacted utterances","description":"The original turn-by-turn utterance objects before PII redaction was applied. Same shape as `utterances`. Only returned when `redact_pii_return_unredacted` was set to `true` on the transcription request, otherwise this field is omitted and the `utterances` field remains fully redacted. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"array","items":{"type":"object","x-label":"Utterance","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this utterance","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, of the utterance in the audio file","type":"integer","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, of the utterance in the audio file","type":"integer","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].end","typeLabel":"integer"},"text":{"x-label":"Text","description":"The text for this utterance","type":"string","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].text","typeLabel":"string"},"words":{"x-label":"Words","description":"The words in the utterance.","type":"array","items":{"x-label":"Word","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["confidence","start","end","text","speaker"],"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this word","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the word","type":"integer","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the word","type":"integer","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].end","typeLabel":"integer"},"text":{"x-label":"Text","description":"The text of the word","type":"string","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].text","typeLabel":"string"},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker.oneOf.0","typeLabel":"string"},{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker","typeLabel":"string | null"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string","uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].channel.oneOf.0","typeLabel":"string"},{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null","uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].channel.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].channel","typeLabel":"string | null"},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker_confidence.oneOf.0","typeLabel":"number\u003cdouble>"},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker_confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX].speaker_confidence","typeLabel":"number\u003cdouble> | null"}},"example":{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"channel":null,"speaker":null},"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].words","typeLabel":"object[]"},"speaker":{"x-label":"Speaker","description":"The speaker of this utterance, where each speaker is assigned a sequential capital letter - e.g. \"A\" for Speaker A, \"B\" for Speaker B, etc.","type":"string","isRequired":true,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].speaker","typeLabel":"string"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string","uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].channel.oneOf.0","typeLabel":"string"},{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null","uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].channel.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].channel","typeLabel":"string | null"},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this utterance, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].speaker_confidence.oneOf.0","typeLabel":"number\u003cdouble>"},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this utterance, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1,"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].speaker_confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].speaker_confidence","typeLabel":"number\u003cdouble> | null"},"translated_texts":{"x-label":"Translated texts","description":"Translations keyed by language code (e.g., `{\"es\": \"Texto traducido\", \"de\": \"Übersetzter Text\"}`). Only present when `match_original_utterance` is enabled with translation.","type":"object","additionalProperties":{"type":"string","uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].translated_texts.additionalProperties","typeLabel":"string"},"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX].translated_texts","typeLabel":"object"}},"required":["confidence","start","end","text","words","speaker"],"example":{"confidence":0.9359033333333334,"end":26950,"speaker":"A","start":250,"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor.","words":[{"text":"Smoke","start":250,"end":650,"confidence":0.97503,"speaker":"A"},{"text":"from","start":730,"end":1022,"confidence":0.99999,"speaker":"A"},{"text":"hundreds","start":1076,"end":1418,"confidence":0.99843,"speaker":"A"},{"text":"of","start":1434,"end":1614,"confidence":0.85,"speaker":"A"},{"text":"wildfires","start":1652,"end":2346,"confidence":0.89657,"speaker":"A"},{"text":"in","start":2378,"end":2526,"confidence":0.99994,"speaker":"A"},{"text":"Canada","start":2548,"end":3130,"confidence":0.93864,"speaker":"A"},{"text":"is","start":3210,"end":3454,"confidence":0.999,"speaker":"A"},{"text":"triggering","start":3492,"end":3946,"confidence":0.75366,"speaker":"A"},{"text":"air","start":3978,"end":4174,"confidence":1,"speaker":"A"},{"text":"quality","start":4212,"end":4558,"confidence":0.87745,"speaker":"A"},{"text":"alerts","start":4644,"end":5114,"confidence":0.94739,"speaker":"A"},{"text":"throughout","start":5162,"end":5466,"confidence":0.99726,"speaker":"A"},{"text":"the","start":5498,"end":5694,"confidence":0.79,"speaker":"A"},{"text":"US.","start":5732,"end":6382,"confidence":0.88,"speaker":"A"}]},"uniqueKey":"unredacted_utterances.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"unredacted_utterances.oneOf.0","typeLabel":"object[]"},{"x-label":"Unredacted utterances","description":"The original turn-by-turn utterance objects before PII redaction was applied. Same shape as `utterances`. Only returned when `redact_pii_return_unredacted` was set to `true` on the transcription request, otherwise this field is omitted and the `utterances` field remains fully redacted. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"null","items":{"type":"object","x-label":"Utterance","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this utterance","type":"number","format":"double","minimum":0,"maximum":1},"start":{"x-label":"Start","description":"The starting time, in milliseconds, of the utterance in the audio file","type":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, of the utterance in the audio file","type":"integer"},"text":{"x-label":"Text","description":"The text for this utterance","type":"string"},"words":{"x-label":"Words","description":"The words in the utterance.","type":"array","items":{"x-label":"Word","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["confidence","start","end","text","speaker"],"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this word","type":"number","format":"double","minimum":0,"maximum":1},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the word","type":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the word","type":"integer"},"text":{"x-label":"Text","description":"The text of the word","type":"string"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string"},{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null"}]},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string"},{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null"}]},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1}]}},"example":{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"channel":null,"speaker":null}}},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string"},{"x-label":"Channel","description":"The channel of this utterance. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null"}]},"speaker":{"x-label":"Speaker","description":"The speaker of this utterance, where each speaker is assigned a sequential capital letter - e.g. \"A\" for Speaker A, \"B\" for Speaker B, etc.","type":"string"},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this utterance, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this utterance, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1}]},"translated_texts":{"x-label":"Translated texts","description":"Translations keyed by language code (e.g., `{\"es\": \"Texto traducido\", \"de\": \"Übersetzter Text\"}`). Only present when `match_original_utterance` is enabled with translation.","type":"object","additionalProperties":{"type":"string"}}},"required":["confidence","start","end","text","words","speaker"],"example":{"confidence":0.9359033333333334,"end":26950,"speaker":"A","start":250,"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor.","words":[{"text":"Smoke","start":250,"end":650,"confidence":0.97503,"speaker":"A"},{"text":"from","start":730,"end":1022,"confidence":0.99999,"speaker":"A"},{"text":"hundreds","start":1076,"end":1418,"confidence":0.99843,"speaker":"A"},{"text":"of","start":1434,"end":1614,"confidence":0.85,"speaker":"A"},{"text":"wildfires","start":1652,"end":2346,"confidence":0.89657,"speaker":"A"},{"text":"in","start":2378,"end":2526,"confidence":0.99994,"speaker":"A"},{"text":"Canada","start":2548,"end":3130,"confidence":0.93864,"speaker":"A"},{"text":"is","start":3210,"end":3454,"confidence":0.999,"speaker":"A"},{"text":"triggering","start":3492,"end":3946,"confidence":0.75366,"speaker":"A"},{"text":"air","start":3978,"end":4174,"confidence":1,"speaker":"A"},{"text":"quality","start":4212,"end":4558,"confidence":0.87745,"speaker":"A"},{"text":"alerts","start":4644,"end":5114,"confidence":0.94739,"speaker":"A"},{"text":"throughout","start":5162,"end":5466,"confidence":0.99726,"speaker":"A"},{"text":"the","start":5498,"end":5694,"confidence":0.79,"speaker":"A"},{"text":"US.","start":5732,"end":6382,"confidence":0.88,"speaker":"A"}]}},"uniqueKey":"unredacted_utterances.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_utterances","typeLabel":"object[] | null"},"webhook_auth_header_name":{"oneOf":[{"x-label":"Webhook auth header name","description":"The header name to be sent with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests. Must be 1-1000 characters and contain only ASCII letters, numbers, hyphens, and underscores. Requires `webhook_auth_header_value` and `webhook_url` to also be set.","type":"string","uniqueKey":"webhook_auth_header_name.oneOf.0","typeLabel":"string"},{"x-label":"Webhook auth header name","description":"The header name to be sent with the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests. Must be 1-1000 characters and contain only ASCII letters, numbers, hyphens, and underscores. Requires `webhook_auth_header_value` and `webhook_url` to also be set.","type":"null","uniqueKey":"webhook_auth_header_name.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_auth_header_name","typeLabel":"string | null"},"webhook_status_code":{"oneOf":[{"x-label":"Webhook HTTP status code","description":"The status code we received from your server when delivering the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) request, if a webhook URL was provided","type":"integer","uniqueKey":"webhook_status_code.oneOf.0","typeLabel":"integer"},{"x-label":"Webhook HTTP status code","description":"The status code we received from your server when delivering the transcript completed or failed [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) request, if a webhook URL was provided","type":"null","uniqueKey":"webhook_status_code.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_status_code","typeLabel":"integer | null"},"webhook_url":{"oneOf":[{"x-label":"Webhook URL","description":"The URL to which we send [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests.\n","type":"string","format":"url","uniqueKey":"webhook_url.oneOf.0","typeLabel":"string\u003curl>"},{"x-label":"Webhook URL","description":"The URL to which we send [webhook](https://www.assemblyai.com/docs/deployment/webhooks-for-pre-recorded-audio) requests.\n","type":"null","format":"url","uniqueKey":"webhook_url.oneOf.1","typeLabel":"null"}],"uniqueKey":"webhook_url","typeLabel":"string\u003curl> | null"},"words":{"oneOf":[{"x-label":"Words","description":"An array of temporally-sequential word objects, one for each word in the transcript.\n","type":"array","items":{"x-label":"Word","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["confidence","start","end","text","speaker"],"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this word","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"words.oneOf.0.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the word","type":"integer","isRequired":true,"uniqueKey":"words.oneOf.0.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the word","type":"integer","isRequired":true,"uniqueKey":"words.oneOf.0.items.[INDEX].end","typeLabel":"integer"},"text":{"x-label":"Text","description":"The text of the word","type":"string","isRequired":true,"uniqueKey":"words.oneOf.0.items.[INDEX].text","typeLabel":"string"},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string","isRequired":true,"uniqueKey":"words.oneOf.0.items.[INDEX].speaker.oneOf.0","typeLabel":"string"},{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null","isRequired":true,"uniqueKey":"words.oneOf.0.items.[INDEX].speaker.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"words.oneOf.0.items.[INDEX].speaker","typeLabel":"string | null"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string","uniqueKey":"words.oneOf.0.items.[INDEX].channel.oneOf.0","typeLabel":"string"},{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null","uniqueKey":"words.oneOf.0.items.[INDEX].channel.oneOf.1","typeLabel":"null"}],"uniqueKey":"words.oneOf.0.items.[INDEX].channel","typeLabel":"string | null"},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"words.oneOf.0.items.[INDEX].speaker_confidence.oneOf.0","typeLabel":"number\u003cdouble>"},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1,"uniqueKey":"words.oneOf.0.items.[INDEX].speaker_confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"words.oneOf.0.items.[INDEX].speaker_confidence","typeLabel":"number\u003cdouble> | null"}},"example":{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"channel":null,"speaker":null},"uniqueKey":"words.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"words.oneOf.0","typeLabel":"object[]"},{"x-label":"Words","description":"An array of temporally-sequential word objects, one for each word in the transcript.\n","type":"null","items":{"x-label":"Word","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["confidence","start","end","text","speaker"],"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this word","type":"number","format":"double","minimum":0,"maximum":1},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the word","type":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the word","type":"integer"},"text":{"x-label":"Text","description":"The text of the word","type":"string"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string"},{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null"}]},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string"},{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null"}]},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1}]}},"example":{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"channel":null,"speaker":null}},"uniqueKey":"words.oneOf.1","typeLabel":"null"}],"uniqueKey":"words","typeLabel":"object[] | null"},"unredacted_words":{"oneOf":[{"x-label":"Unredacted words","description":"The original temporally-sequential word objects before PII redaction was applied. Same shape as `words`. Only returned when `redact_pii_return_unredacted` was set to `true` on the transcription request, otherwise this field is omitted and the `words` field remains fully redacted. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"array","items":{"x-label":"Word","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["confidence","start","end","text","speaker"],"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this word","type":"number","format":"double","minimum":0,"maximum":1,"isRequired":true,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].confidence","typeLabel":"number\u003cdouble>"},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the word","type":"integer","isRequired":true,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].start","typeLabel":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the word","type":"integer","isRequired":true,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].end","typeLabel":"integer"},"text":{"x-label":"Text","description":"The text of the word","type":"string","isRequired":true,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].text","typeLabel":"string"},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string","isRequired":true,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].speaker.oneOf.0","typeLabel":"string"},{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null","isRequired":true,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].speaker.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].speaker","typeLabel":"string | null"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string","uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].channel.oneOf.0","typeLabel":"string"},{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null","uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].channel.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].channel","typeLabel":"string | null"},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].speaker_confidence.oneOf.0","typeLabel":"number\u003cdouble>"},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1,"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].speaker_confidence.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX].speaker_confidence","typeLabel":"number\u003cdouble> | null"}},"example":{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"channel":null,"speaker":null},"uniqueKey":"unredacted_words.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"unredacted_words.oneOf.0","typeLabel":"object[]"},{"x-label":"Unredacted words","description":"The original temporally-sequential word objects before PII redaction was applied. Same shape as `words`. Only returned when `redact_pii_return_unredacted` was set to `true` on the transcription request, otherwise this field is omitted and the `words` field remains fully redacted. See [PII redaction](https://www.assemblyai.com/docs/pii-redaction) for more information.\n","type":"null","items":{"x-label":"Word","type":"object","x-fern-sdk-group-name":"transcripts","additionalProperties":false,"required":["confidence","start","end","text","speaker"],"properties":{"confidence":{"x-label":"Confidence","description":"The confidence score for the transcript of this word","type":"number","format":"double","minimum":0,"maximum":1},"start":{"x-label":"Start","description":"The starting time, in milliseconds, for the word","type":"integer"},"end":{"x-label":"End","description":"The ending time, in milliseconds, for the word","type":"integer"},"text":{"x-label":"Text","description":"The text of the word","type":"string"},"channel":{"oneOf":[{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"string"},{"x-label":"Channel","description":"The channel of the word. The left and right channels are channels 1 and 2. Additional channels increment the channel number sequentially.","type":"null"}]},"speaker":{"oneOf":[{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"string"},{"x-label":"Speaker","description":"The speaker of the word if [Speaker Diarization](https://www.assemblyai.com/docs/pre-recorded-audio/label-speakers) is enabled, else null","type":"null"}]},"speaker_confidence":{"oneOf":[{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"number","format":"double","minimum":0,"maximum":1},{"x-label":"Speaker confidence","description":"The confidence score for the speaker label of this word, between 0 and 1. Only present when `speaker_options.include_speaker_confidence` is `true`.","type":"null","format":"double","minimum":0,"maximum":1}]}},"example":{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"channel":null,"speaker":null}},"uniqueKey":"unredacted_words.oneOf.1","typeLabel":"null"}],"uniqueKey":"unredacted_words","typeLabel":"object[] | null"},"custom_topics":{"oneOf":[{"x-label":"Custom topics enabled","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","deprecated":true,"uniqueKey":"custom_topics.oneOf.0","typeLabel":"boolean"},{"x-label":"Custom topics enabled","description":"This parameter does not currently have any functionality attached to it.","type":"null","deprecated":true,"uniqueKey":"custom_topics.oneOf.1","typeLabel":"null"}],"uniqueKey":"custom_topics","typeLabel":"boolean | null"},"speed_boost":{"oneOf":[{"x-label":"Speed boost","description":"This parameter does not currently have any functionality attached to it.","type":"boolean","deprecated":true,"uniqueKey":"speed_boost.oneOf.0","typeLabel":"boolean"},{"x-label":"Speed boost","description":"This parameter does not currently have any functionality attached to it.","type":"null","deprecated":true,"uniqueKey":"speed_boost.oneOf.1","typeLabel":"null"}],"uniqueKey":"speed_boost","typeLabel":"boolean | null"},"topics":{"x-label":"Topics","description":"This parameter does not currently have any functionality attached to it.","type":"array","items":{"x-label":"Topic","type":"string","uniqueKey":"topics.items.[INDEX]","typeLabel":"string"},"deprecated":true,"uniqueKey":"topics","typeLabel":"string[]"},"translated_texts":{"type":"object","description":"Translated text keyed by language code. See [Translation](https://www.assemblyai.com/docs/speech-understanding/translation) for more details.","properties":{"language_code":{"x-label":"Language code","type":"string","description":"Translated text for this language code","uniqueKey":"translated_texts.language_code","typeLabel":"string"}},"uniqueKey":"translated_texts","typeLabel":"object"}},"required":["id","speech_model","language_model","acoustic_model","status","audio_url","webhook_auth","auto_highlights","redact_pii","summarization","language_confidence_threshold","language_confidence"],"example":{"id":"9ea68fd3-f953-42c1-9742-976c447fb463","speech_model":null,"speech_model_used":"assemblyai-stt-3-7","language_model":"assemblyai_default","acoustic_model":"assemblyai_default","language_code":"en_us","language_detection":true,"language_confidence_threshold":0.7,"language_confidence":0.9959,"status":"completed","audio_url":"https://assembly.ai/wildfires.mp3","text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning. What is it about the conditions right now that have caused this round of wildfires to affect so many people so far away? Well, there's a couple of things. The season has been pretty dry already. And then the fact that we're getting hit in the US. Is because there's a couple of weather systems that are essentially channeling the smoke from those Canadian wildfires through Pennsylvania into the Mid Atlantic and the Northeast and kind of just dropping the smoke there. So what is it in this haze that makes it harmful? And I'm assuming it is harmful. It is. The levels outside right now in Baltimore are considered unhealthy. And most of that is due to what's called particulate matter, which are tiny particles, microscopic smaller than the width of your hair that can get into your lungs and impact your respiratory system, your cardiovascular system, and even your neurological your brain. What makes this particularly harmful? Is it the volume of particulant? Is it something in particular? What is it exactly? Can you just drill down on that a little bit more? Yeah. So the concentration of particulate matter I was looking at some of the monitors that we have was reaching levels of what are, in science, big 150 micrograms per meter cubed, which is more than ten times what the annual average should be and about four times higher than what you're supposed to have on a 24 hours average. And so the concentrations of these particles in the air are just much, much higher than we typically see. And exposure to those high levels can lead to a host of health problems. And who is most vulnerable? I noticed that in New York City, for example, they're canceling outdoor activities. And so here it is in the early days of summer, and they have to keep all the kids inside. So who tends to be vulnerable in a situation like this? It's the youngest. So children, obviously, whose bodies are still developing. The elderly, who are their bodies are more in decline and they're more susceptible to the health impacts of breathing, the poor air quality. And then people who have preexisting health conditions, people with respiratory conditions or heart conditions can be triggered by high levels of air pollution. Could this get worse? That's a good question. In some areas, it's much worse than others. And it just depends on kind of where the smoke is concentrated. I think New York has some of the higher concentrations right now, but that's going to change as that air moves away from the New York area. But over the course of the next few days, we will see different areas being hit at different times with the highest concentrations. I was going to ask you about more fires start burning. I don't expect the concentrations to go up too much higher. I was going to ask you how and you started to answer this, but how much longer could this last? Or forgive me if I'm asking you to speculate, but what do you think? Well, I think the fires are going to burn for a little bit longer, but the key for us in the US. Is the weather system changing. And so right now, it's kind of the weather systems that are pulling that air into our mid Atlantic and Northeast region. As those weather systems change and shift, we'll see that smoke going elsewhere and not impact us in this region as much. And so I think that's going to be the defining factor. And I think the next couple of days we're going to see a shift in that weather pattern and start to push the smoke away from where we are. And finally, with the impacts of climate change, we are seeing more wildfires. Will we be seeing more of these kinds of wide ranging air quality consequences or circumstances? I mean, that is one of the predictions for climate change. Looking into the future, the fire season is starting earlier and lasting longer, and we're seeing more frequent fires. So, yeah, this is probably something that we'll be seeing more frequently. This tends to be much more of an issue in the Western US. So the eastern US. Getting hit right now is a little bit new. But yeah, I think with climate change moving forward, this is something that is going to happen more frequently. That's Peter De Carlo, associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University. Sergeant Carlo, thanks so much for joining us and sharing this expertise with us. Thank you for having me.","words":[{"text":"Smoke","start":250,"end":650,"confidence":0.97465,"speaker":null},{"text":"from","start":730,"end":1022,"confidence":0.99999,"speaker":null},{"text":"hundreds","start":1076,"end":1418,"confidence":0.99844,"speaker":null},{"text":"of","start":1434,"end":1614,"confidence":0.84,"speaker":null},{"text":"wildfires","start":1652,"end":2346,"confidence":0.89572,"speaker":null},{"text":"in","start":2378,"end":2526,"confidence":0.99994,"speaker":null},{"text":"Canada","start":2548,"end":3130,"confidence":0.93953,"speaker":null},{"text":"is","start":3210,"end":3454,"confidence":0.999,"speaker":null},{"text":"triggering","start":3492,"end":3946,"confidence":0.74794,"speaker":null},{"text":"air","start":3978,"end":4174,"confidence":1,"speaker":null},{"text":"quality","start":4212,"end":4558,"confidence":0.88077,"speaker":null},{"text":"alerts","start":4644,"end":5114,"confidence":0.94814,"speaker":null},{"text":"throughout","start":5162,"end":5466,"confidence":0.99726,"speaker":null},{"text":"the","start":5498,"end":5694,"confidence":0.79,"speaker":null},{"text":"US.","start":5732,"end":6382,"confidence":0.89,"speaker":null}],"utterances":[{"confidence":0.9359033333333334,"end":26950,"speaker":"A","start":250,"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor.","words":[{"text":"Smoke","start":250,"end":650,"confidence":0.97503,"speaker":"A"},{"text":"from","start":730,"end":1022,"confidence":0.99999,"speaker":"A"},{"text":"hundreds","start":1076,"end":1418,"confidence":0.99843,"speaker":"A"},{"text":"of","start":1434,"end":1614,"confidence":0.85,"speaker":"A"},{"text":"wildfires","start":1652,"end":2346,"confidence":0.89657,"speaker":"A"},{"text":"in","start":2378,"end":2526,"confidence":0.99994,"speaker":"A"},{"text":"Canada","start":2548,"end":3130,"confidence":0.93864,"speaker":"A"},{"text":"is","start":3210,"end":3454,"confidence":0.999,"speaker":"A"},{"text":"triggering","start":3492,"end":3946,"confidence":0.75366,"speaker":"A"},{"text":"air","start":3978,"end":4174,"confidence":1,"speaker":"A"},{"text":"quality","start":4212,"end":4558,"confidence":0.87745,"speaker":"A"},{"text":"alerts","start":4644,"end":5114,"confidence":0.94739,"speaker":"A"},{"text":"throughout","start":5162,"end":5466,"confidence":0.99726,"speaker":"A"},{"text":"the","start":5498,"end":5694,"confidence":0.79,"speaker":"A"},{"text":"US.","start":5732,"end":6382,"confidence":0.88,"speaker":"A"}]}],"confidence":0.9404651451800253,"audio_duration":281,"punctuate":true,"format_text":true,"multichannel":false,"webhook_url":"https://your-webhook-url.tld/path","webhook_status_code":200,"webhook_auth":true,"webhook_auth_header_name":"webhook-secret","auto_highlights_result":{"status":"success","results":[{"count":1,"rank":0.08,"text":"air quality alerts","timestamps":[{"start":3978,"end":5114}]},{"count":1,"rank":0.08,"text":"wide ranging air quality consequences","timestamps":[{"start":235388,"end":238694}]},{"count":1,"rank":0.07,"text":"more wildfires","timestamps":[{"start":230972,"end":232354}]},{"count":1,"rank":0.07,"text":"air pollution","timestamps":[{"start":156004,"end":156910}]},{"count":3,"rank":0.07,"text":"weather systems","timestamps":[{"start":47344,"end":47958},{"start":205268,"end":205818},{"start":211588,"end":213434}]},{"count":2,"rank":0.06,"text":"high levels","timestamps":[{"start":121128,"end":121646},{"start":155412,"end":155866}]},{"count":1,"rank":0.06,"text":"health conditions","timestamps":[{"start":152138,"end":152666}]},{"count":2,"rank":0.06,"text":"Peter de Carlo","timestamps":[{"start":18948,"end":19930},{"start":268298,"end":269194}]},{"count":1,"rank":0.06,"text":"New York City","timestamps":[{"start":125768,"end":126274}]},{"count":1,"rank":0.05,"text":"respiratory conditions","timestamps":[{"start":152964,"end":153786}]},{"count":3,"rank":0.05,"text":"New York","timestamps":[{"start":125768,"end":126034},{"start":171448,"end":171938},{"start":176008,"end":176322}]},{"count":3,"rank":0.05,"text":"climate change","timestamps":[{"start":229548,"end":230230},{"start":244576,"end":245162},{"start":263348,"end":263950}]},{"count":1,"rank":0.05,"text":"Johns Hopkins University Varsity","timestamps":[{"start":23972,"end":25490}]},{"count":1,"rank":0.05,"text":"heart conditions","timestamps":[{"start":153988,"end":154506}]},{"count":1,"rank":0.05,"text":"air quality warnings","timestamps":[{"start":12308,"end":13434}]}]},"auto_highlights":true,"audio_start_from":10,"audio_end_at":280,"filter_profanity":true,"redact_pii":true,"redact_pii_audio":true,"redact_pii_audio_quality":"mp3","redact_pii_policies":["us_social_security_number","credit_card_number"],"redact_pii_sub":"hash","speaker_labels":true,"content_safety":true,"iab_categories":true,"content_safety_labels":{"status":"success","results":[{"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning.","labels":[{"label":"disasters","confidence":0.8142836093902588,"severity":0.4093044400215149}],"sentences_idx_start":0,"sentences_idx_end":5,"timestamp":{"start":250,"end":28840}}],"summary":{"disasters":0.9940800441842205,"health_issues":0.9216489289040967},"severity_score_summary":{"disasters":{"low":0.5733263024656846,"medium":0.42667369753431533,"high":0},"health_issues":{"low":0.22863814977924785,"medium":0.45014154926938227,"high":0.32122030095136983}}},"iab_categories_result":{"status":"success","results":[{"text":"Smoke from hundreds of wildfires in Canada is triggering air quality alerts throughout the US. Skylines from Maine to Maryland to Minnesota are gray and smoggy. And in some places, the air quality warnings include the warning to stay inside. We wanted to better understand what's happening here and why, so we called Peter de Carlo, an associate professor in the Department of Environmental Health and Engineering at Johns Hopkins University Varsity. Good morning, professor. Good morning.","labels":[{"relevance":0.988274097442627,"label":"Home\u0026Garden>IndoorEnvironmentalQuality"},{"relevance":0.5821335911750793,"label":"NewsAndPolitics>Weather"},{"relevance":0.0042327106930315495,"label":"MedicalHealth>DiseasesAndConditions>LungAndRespiratoryHealth"},{"relevance":0.0033971222583204508,"label":"NewsAndPolitics>Disasters"},{"relevance":0.002469958271831274,"label":"BusinessAndFinance>Business>GreenSolutions"},{"relevance":0.0014376690378412604,"label":"MedicalHealth>DiseasesAndConditions>Cancer"},{"relevance":0.0014294233405962586,"label":"Science>Environment"},{"relevance":0.001234519761055708,"label":"Travel>TravelLocations>PolarTravel"},{"relevance":0.0010231725173071027,"label":"MedicalHealth>DiseasesAndConditions>ColdAndFlu"},{"relevance":0.0007445293595083058,"label":"BusinessAndFinance>Industries>PowerAndEnergyIndustry"}],"timestamp":{"start":250,"end":28840}}],"summary":{"NewsAndPolitics>Weather":1,"Home\u0026Garden>IndoorEnvironmentalQuality":0.9043831825256348,"Science>Environment":0.16117265820503235,"BusinessAndFinance>Industries>EnvironmentalServicesIndustry":0.14393523335456848,"MedicalHealth>DiseasesAndConditions>LungAndRespiratoryHealth":0.11401086300611496,"BusinessAndFinance>Business>GreenSolutions":0.06348437070846558,"NewsAndPolitics>Disasters":0.05041387677192688,"Travel>TravelLocations>PolarTravel":0.01308488193899393,"HealthyLiving":0.008222488686442375,"MedicalHealth>DiseasesAndConditions>ColdAndFlu":0.0022315620444715023,"MedicalHealth>DiseasesAndConditions>HeartAndCardiovascularDiseases":0.00213034451007843,"HealthyLiving>Wellness>SmokingCessation":0.001540527562610805,"MedicalHealth>DiseasesAndConditions>Injuries":0.0013950627762824297,"BusinessAndFinance>Industries>PowerAndEnergyIndustry":0.0012570273829624057,"MedicalHealth>DiseasesAndConditions>Cancer":0.001097781932912767,"MedicalHealth>DiseasesAndConditions>Allergies":0.0010148967849090695,"MedicalHealth>DiseasesAndConditions>MentalHealth":0.000717321818228811,"Style\u0026Fashion>PersonalCare>DeodorantAndAntiperspirant":0.0006022014422342181,"Technology\u0026Computing>Computing>ComputerNetworking":0.0005461975233629346,"MedicalHealth>DiseasesAndConditions>Injuries>FirstAid":0.0004885646631009877}},"custom_spelling":null,"throttled":null,"auto_chapters":false,"summarization":false,"summary_type":null,"summary_model":null,"custom_topics":true,"topics":[],"speech_threshold":0.5,"remove_audio_tags":null,"domain":null,"disfluencies":true,"sentiment_analysis":true,"sentiment_analysis_results":null,"entity_detection":true,"entities":[{"entity_type":"location","text":"Canada","start":2548,"end":3130},{"entity_type":"location","text":"the US","start":5498,"end":6382},{"entity_type":"location","text":"Maine","start":7492,"end":7914},{"entity_type":"location","text":"Maryland","start":8212,"end":8634},{"entity_type":"location","text":"Minnesota","start":8932,"end":9578},{"entity_type":"person_name","text":"Peter de Carlo","start":18948,"end":19930},{"entity_type":"occupation","text":"associate professor","start":20292,"end":21194},{"entity_type":"organization","text":"Department of Environmental Health and Engineering","start":21508,"end":23706},{"entity_type":"organization","text":"Johns Hopkins University Varsity","start":23972,"end":25490},{"entity_type":"occupation","text":"professor","start":26076,"end":26950},{"entity_type":"location","text":"the US","start":45184,"end":45898},{"entity_type":"nationality","text":"Canadian","start":49728,"end":50086}],"chapters":null,"summary":null,"speakers_expected":2},"uniqueKey":"","typeLabel":"object"},"example":{"id":"0072a82b-aa22-4962-add2-6121c36c17c6","language_model":"assemblyai_default","acoustic_model":"assemblyai_default","language_code":null,"speech_understanding":null,"translated_texts":null,"status":"processing","audio_url":"https://assembly.ai/wildfires.mp3","text":null,"words":null,"utterances":null,"confidence":null,"audio_duration":null,"punctuate":true,"format_text":true,"dual_channel":false,"webhook_url":null,"webhook_status_code":null,"webhook_auth":false,"webhook_auth_header_name":null,"speed_boost":false,"auto_highlights_result":null,"auto_highlights":true,"audio_start_from":null,"audio_end_at":null,"word_boost":[],"boost_param":null,"prompt":null,"keyterms_prompt":null,"filter_profanity":true,"redact_pii":false,"redact_pii_audio":false,"redact_pii_audio_quality":null,"redact_pii_audio_options":null,"redact_pii_policies":null,"redact_pii_sub":null,"redact_static_entities":null,"speaker_labels":true,"speaker_options":{"min_speakers_expected":2,"max_speakers_expected":2,"advanced_speaker_segmentation":true},"content_safety":true,"iab_categories":true,"content_safety_labels":{},"iab_categories_result":{},"language_detection":true,"language_detection_options":null,"language_detection_results":null,"language_confidence_threshold":0.7,"language_confidence":null,"custom_spelling":null,"throttled":false,"auto_chapters":false,"summarization":false,"summary_type":null,"summary_model":null,"custom_topics":false,"topics":[],"speech_threshold":null,"speech_model":null,"speech_models":["assemblyai-stt-3-7"],"speech_model_used":"assemblyai-stt-3-7","temperature":null,"remove_audio_tags":"all","chapters":null,"disfluencies":true,"entity_detection":true,"sentiment_analysis":true,"sentiment_analysis_results":null,"entities":null,"speakers_expected":2,"summary":null,"custom_topics_results":null,"is_deleted":null,"multichannel":null,"project_id":14296,"token_id":14296},"examples":{"Example":{"title":"Example","value":{"id":"0072a82b-aa22-4962-add2-6121c36c17c6","language_model":"assemblyai_default","acoustic_model":"assemblyai_default","language_code":null,"speech_understanding":null,"translated_texts":null,"status":"processing","audio_url":"https://assembly.ai/wildfires.mp3","text":null,"words":null,"utterances":null,"confidence":null,"audio_duration":null,"punctuate":true,"format_text":true,"dual_channel":false,"webhook_url":null,"webhook_status_code":null,"webhook_auth":false,"webhook_auth_header_name":null,"speed_boost":false,"auto_highlights_result":null,"auto_highlights":true,"audio_start_from":null,"audio_end_at":null,"word_boost":[],"boost_param":null,"prompt":null,"keyterms_prompt":null,"filter_profanity":true,"redact_pii":false,"redact_pii_audio":false,"redact_pii_audio_quality":null,"redact_pii_audio_options":null,"redact_pii_policies":null,"redact_pii_sub":null,"redact_static_entities":null,"speaker_labels":true,"speaker_options":{"min_speakers_expected":2,"max_speakers_expected":2,"advanced_speaker_segmentation":true},"content_safety":true,"iab_categories":true,"content_safety_labels":{},"iab_categories_result":{},"language_detection":true,"language_detection_options":null,"language_detection_results":null,"language_confidence_threshold":0.7,"language_confidence":null,"custom_spelling":null,"throttled":false,"auto_chapters":false,"summarization":false,"summary_type":null,"summary_model":null,"custom_topics":false,"topics":[],"speech_threshold":null,"speech_model":null,"speech_models":["assemblyai-stt-3-7"],"speech_model_used":"assemblyai-stt-3-7","temperature":null,"remove_audio_tags":"all","chapters":null,"disfluencies":true,"entity_detection":true,"sentiment_analysis":true,"sentiment_analysis_results":null,"entities":null,"speakers_expected":2,"summary":null,"custom_topics_results":null,"is_deleted":null,"multichannel":null,"project_id":14296,"token_id":14296}}},"exampleType":"examples"}},"links":{"GetTranscriptById":{"$ref":"#/components/links/GetTranscriptById"},"GetTranscriptSentencesById":{"$ref":"#/components/links/GetTranscriptSentencesById"},"GetTranscriptParagraphsById":{"$ref":"#/components/links/GetTranscriptParagraphsById"},"GetTranscriptSubtitlesById":{"$ref":"#/components/links/GetTranscriptSubtitlesById"},"GetTranscriptRedactedAudioById":{"$ref":"#/components/links/GetTranscriptRedactedAudioById"},"WordSearchByTranscriptId":{"$ref":"#/components/links/WordSearchByTranscriptId"},"DeleteTranscriptById":{"$ref":"#/components/links/DeleteTranscriptById"}},"exampleType":"examples"},"904ee1af-0461-4048-8eed-49c41554fce9":{"x-label":"Bad request","description":"Bad request","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"This is a sample error message"},"examples":{"Example":{"title":"Example","value":{"error":"This is a sample error message"}}},"exampleType":"examples"}},"exampleType":"examples"},"f0cdadc1-b860-4b41-94f5-1a21cacf37e5":{"x-label":"Unauthorized","description":"Unauthorized","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Authentication error, API token missing/invalid"},"examples":{"Example":{"title":"Example","value":{"error":"Authentication error, API token missing/invalid"}}},"exampleType":"examples"}},"exampleType":"examples"},"099458c9-8783-4bc4-8280-dace01486743":{"x-label":"Cannot access uploaded file","description":"Cannot access uploaded file","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Cannot access uploaded file"},"examples":{"Example":{"title":"Example","value":{"error":"Cannot access uploaded file"}}},"exampleType":"examples"}},"exampleType":"examples"},"1ed97bd0-4264-485b-adf2-1a7cba20b9dd":{"x-label":"Not found","description":"Not found","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Not found"},"examples":{"Example":{"title":"Example","value":{"error":"Not found"}}},"exampleType":"examples"}},"exampleType":"examples"},"3446cb21-8d77-4b02-b8b9-2da5a78df547":{"x-label":"Too many requests","description":"Too many requests","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Too Many Requests"},"examples":{"Example":{"title":"Example","value":{"error":"Too Many Requests"}}},"exampleType":"examples"}},"headers":{"Retry-After":{"description":"The number of seconds to wait before retrying the request","schema":{"type":"integer"}}},"exampleType":"examples"},"fa00b4b4-551d-4276-a9a5-5870f476f38a":{"x-label":"Internal server error","description":"An error occurred while processing the request","content":{"application/json":{"schema":{"x-label":"Error","type":"object","additionalProperties":true,"required":["error"],"properties":{"error":{"x-label":"Error message","description":"Error message","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"status":{"x-label":"Status","type":"string","const":"error","uniqueKey":"status","typeLabel":"string"}},"example":{"error":"Transcript creation error, audio_url not found"},"uniqueKey":"","typeLabel":"object"},"example":{"error":"Internal server error. Please retry your request. If the error persists, please contact support@assemblyai.com for more information."},"examples":{"Example":{"title":"Example","value":{"error":"Internal server error. Please retry your request. If the error persists, please contact support@assemblyai.com for more information."}}},"exampleType":"examples"}},"exampleType":"examples"},"1e28bfe0-b824-4b14-891a-f9f2a9bfd30d":{"x-label":"Service unavailable","description":"Service unavailable","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"e5f26380-6f9a-49ed-94c8-5e335a250193":{"x-label":"Gateway timeout","description":"Gateway timeout","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"callbacks":[{"callbackName":"transcriptReadyWebhook","expression":"{$request.body#/webhook_url}","method":"post","resolved":{"operation":{"summary":"Transcript ready webhook","requestBody":"ca1b1ecb-b9a2-4888-8ba1-a12398871c84","responses":{"2XX":"9e485406-b748-4113-97af-80ef91cffa69","4XX":"6fef9cc9-db25-4920-bd54-729148b2f50c","5XX":"24115801-ba48-4990-99d4-f40a1147762c"},"method":"post","type":"path"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"description":"The notification when the transcript status is completed or error.","x-label":"Transcript ready notification","x-fern-sdk-group-name":"transcripts","type":"object","additionalProperties":false,"properties":{"transcript_id":{"x-label":"Transcript ID","description":"The ID of the transcript","type":"string","format":"uuid","isRequired":true,"uniqueKey":"transcript_id","typeLabel":"string\u003cuuid>"},"status":{"x-label":"Transcript status","type":"string","description":"The status of the transcript. Either completed or error.","x-fern-sdk-group-name":"transcripts","enum":["completed","error"],"x-fern-enum":{"completed":{"description":"The transcript job has been completed successfully."},"error":{"description":"An error occurred while processing the audio file."}},"x-aai-enum":{"completed":{"label":"Completed"},"error":{"label":"Error"}},"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"required":["transcript_id","status"],"example":{"transcript_id":"9ea68fd3-f953-42c1-9742-976c447fb463","status":"completed"},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"transcript_id":"9ea68fd3-f953-42c1-9742-976c447fb463","status":"completed"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"9e485406-b748-4113-97af-80ef91cffa69":{"description":"Successfully received the notification","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"6fef9cc9-db25-4920-bd54-729148b2f50c":{"description":"Invalid request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"24115801-ba48-4990-99d4-f40a1147762c":{"description":"Unexpected error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{}}}},{"callbackName":"redactedAudioWebhook","expression":"{$request.body#/webhook_url}","method":"post","resolved":{"operation":{"summary":"Redacted audio ready webhook","requestBody":"03af72c6-82c3-4ffb-9429-c262fb674d93","responses":{"2XX":"c379574a-2880-47ee-8a5c-0552a459be20","4XX":"2c2f1154-8ad2-4980-a12e-af4ac87b07a3","5XX":"f6e23333-86df-4358-a697-96b786cef850"},"method":"post","type":"path"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"The notification when the redacted audio is ready.","required":["status","redacted_audio_url"],"x-label":"Redacted audio notification","x-fern-sdk-group-name":"transcripts","example":{"redacted_audio_url":"https://s3.us-west-2.amazonaws.com/api.assembly.ai.usw2/redacted-audio/785efd9e-0e20-45e1-967b-3db17770ed9f.wav?AWSAccessKeyId=aws-access-key0id\u0026Signature=signature\u0026x-amz-security-token=security-token\u0026Expires=1698966551","status":"redacted_audio_ready"},"properties":{"status":{"x-label":"Status","description":"The status of the redacted audio","x-fern-sdk-group-name":"transcripts","type":"string","enum":["redacted_audio_ready"],"x-aai-enum":{"redacted_audio_ready":{"label":"Redacted audio is ready"}},"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"redacted_audio_url":{"x-label":"Redacted audio URL","description":"The URL of the redacted audio file","type":"string","format":"url","isRequired":true,"uniqueKey":"redacted_audio_url","typeLabel":"string\u003curl>"}},"additionalProperties":false,"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"redacted_audio_url":"https://s3.us-west-2.amazonaws.com/api.assembly.ai.usw2/redacted-audio/785efd9e-0e20-45e1-967b-3db17770ed9f.wav?AWSAccessKeyId=aws-access-key0id\u0026Signature=signature\u0026x-amz-security-token=security-token\u0026Expires=1698966551","status":"redacted_audio_ready"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"c379574a-2880-47ee-8a5c-0552a459be20":{"description":"Successfully received the notification","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"2c2f1154-8ad2-4980-a12e-af4ac87b07a3":{"description":"Invalid request","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"f6e23333-86df-4358-a697-96b786cef850":{"description":"Unexpected error","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{}}}}],"security":{"da0aa2b4-d1f8-45b5-8ba0-ae4397fdd565":{"ApiKey":{"type":"apiKey","in":"header","name":"Authorization","description":"Add your AssemblyAI API key as the Authorization header value. Required on every request.","scopes":[],"schemeName":"ApiKey"}}},"servers":{"90f40eae-7250-4ea8-a01b-fc04eabb210e":{"url":"https://api.assemblyai.com","description":"AssemblyAI API","x-fern-server-name":"Default"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"Authorization","description":"Add your AssemblyAI API key as the Authorization header value. Required on every request.","scopes":[],"schemeName":"ApiKey"},"schema":{"title":"Authorization","type":"string","description":"Add your AssemblyAI API key as the Authorization header value. Required on every request.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKey","name":"Authorization"}],"title":"ApiKey"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"assemblyai-fff14a6f","siteName":"AssemblyAI","title":"Transcribe audio - AssemblyAI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-08T23:11:45.389Z","originalFileLocation":"pre-recorded-audio/api-reference/transcripts/submit.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"To use our EU server for transcription, replace api.assemblyai.com with api.eu.assemblyai.com. Create a transcript from a media file that is accessible via a URL.\">\u003cmeta data-mint-head name=\"application-name\" content=\"AssemblyAI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Transcribe audio - AssemblyAI\">\u003cmeta data-mint-head property=\"og:description\" content=\"To use our EU server for transcription, replace api.assemblyai.com with api.eu.assemblyai.com. Create a transcript from a media file that is accessible via a URL.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"AssemblyAI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://assemblyai-fff14a6f.mintlify.site/docs/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Transcribe+audio\u0026amp;description=%3CNote%3ETo+use+our+EU+server+for+transcription%2C+replace+%60api.assemblyai.com%60+with+%60api.eu.assemblyai.com%60.%3C%2FNote%3E%0ACreate+a+transcript+from+a+media+file+that+is+ac\u0026amp;theme=7f291be5810d1f7c5136ed41\u0026amp;signature=736dad6171314c2025f188f5fa9262eff6007e5f60bcdab4602412e2e9994925\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Transcribe audio - AssemblyAI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"To use our EU server for transcription, replace api.assemblyai.com with api.eu.assemblyai.com. Create a transcript from a media file that is accessible via a URL.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://assemblyai-fff14a6f.mintlify.site/docs/_mintlify/api/og/v2?division=API+reference\u0026amp;title=Transcribe+audio\u0026amp;description=%3CNote%3ETo+use+our+EU+server+for+transcription%2C+replace+%60api.assemblyai.com%60+with+%60api.eu.assemblyai.com%60.%3C%2FNote%3E%0ACreate+a+transcript+from+a+media+file+that+is+ac\u0026amp;theme=7f291be5810d1f7c5136ed41\u0026amp;signature=736dad6171314c2025f188f5fa9262eff6007e5f60bcdab4602412e2e9994925\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/docs/mintlify-assets/_mintlify/favicons/assemblyai-fff14a6f/IP3FX8MjuVkHah_W/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"AssemblyAI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#614fd2\">\u003clink data-mint-head rel=\"canonical\" href=\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/docs/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/pre-recorded-audio/api-reference/transcripts/submit.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://www.assemblyai.com/#organization\",\"name\":\"AssemblyAI\",\"url\":\"https://www.assemblyai.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/assemblyai-fff14a6f/vMuNaI_PbWUbVeV0/assets/assemblyai-lockup-primary.svg?fit=max\u0026auto=format\u0026n=vMuNaI_PbWUbVeV0\u0026q=85\u0026s=808d2a677e2536423045d44b3f330ac2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://www.assemblyai.com/docs#website\",\"name\":\"AssemblyAI\",\"url\":\"https://www.assemblyai.com/docs\",\"publisher\":{\"@id\":\"https://www.assemblyai.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit#webpage\",\"url\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit\",\"name\":\"Transcribe audio\",\"description\":\"To use our EU server for transcription, replace api.assemblyai.com with api.eu.assemblyai.com. Create a transcript from a media file that is accessible via a URL.\",\"dateModified\":\"2026-09-08T23:11:45.389Z\",\"isPartOf\":{\"@id\":\"https://www.assemblyai.com/docs#website\"},\"breadcrumb\":{\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API reference\",\"item\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/files/upload\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Transcribe audio\",\"item\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit#apireference\",\"headline\":\"Transcribe audio\",\"name\":\"Transcribe audio\",\"description\":\"To use our EU server for transcription, replace api.assemblyai.com with api.eu.assemblyai.com. Create a transcript from a media file that is accessible via a URL.\",\"url\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit\",\"mainEntityOfPage\":{\"@id\":\"https://www.assemblyai.com/docs/pre-recorded-audio/api-reference/transcripts/submit#webpage\"},\"dateModified\":\"2026-09-08T23:11:45.389Z\",\"publisher\":{\"@id\":\"https://www.assemblyai.com/#organization\"},\"isPartOf\":{\"@id\":\"https://www.assemblyai.com/docs#website\"}}]}\u003c/script>","agentPointerHref":"/docs/pre-recorded-audio/api-reference/transcripts/submit.md","siteName":"AssemblyAI","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":""}]},{"tab":"Pre-recorded STT","groups":[{"group":"Getting started","pages":[{"title":"Quickstart","href":"/pre-recorded-audio/getting-started/transcribe-an-audio-file"},{"group":"Model selection","pages":[{"title":"Model selection","sidebarTitle":"Speech models","href":"/pre-recorded-audio/select-the-speech-model"},{"title":"assemblyai-stt-3-7 migration guide","sidebarTitle":"assemblyai-stt-3-7 migration guide","href":"/pre-recorded-audio/assemblyai-stt-3-7-migration-guide"}]}]},{"group":"Features","pages":[{"title":"Prompting and Keyterms","sidebarTitle":"Prompting and Keyterms","href":"/pre-recorded-audio/prompting"},{"title":"Medical Mode","href":"/pre-recorded-audio/medical-mode"},{"title":"Veterinary Mode (beta)","sidebarTitle":"Veterinary Mode","tag":"Beta","href":"/pre-recorded-audio/veterinary-mode"},{"title":"Speaker Diarization","sidebarTitle":"Speaker Diarization","href":"/pre-recorded-audio/label-speakers"},{"title":"Multichannel Transcription","sidebarTitle":"Multichannel Transcription","href":"/pre-recorded-audio/transcribe-multiple-audio-channels"},{"title":"Code Switching","sidebarTitle":"Code Switching","href":"/pre-recorded-audio/code-switching"},{"group":"Languages","pages":[{"title":"Automatic Language Detection","sidebarTitle":"Detect language automatically","href":"/pre-recorded-audio/language-detection"},{"title":"Set Language Manually","sidebarTitle":"Set language manually","href":"/pre-recorded-audio/set-language-manually"},{"title":"Supported Languages","sidebarTitle":"Supported languages","href":"/pre-recorded-audio/supported-languages"}]},{"title":"Custom Spelling","sidebarTitle":"Custom Spelling","href":"/pre-recorded-audio/correct-spelling-of-terms"},{"title":"Formatting","sidebarTitle":"Formatting","href":"/pre-recorded-audio/formatting"},{"title":"Verbatim","sidebarTitle":"Verbatim","href":"/pre-recorded-audio/include-filler-words"},{"title":"Word Search","sidebarTitle":"Word Search","href":"/pre-recorded-audio/search-for-words-in-transcript"},{"title":"Set the Start and End of the Transcript","sidebarTitle":"Set the start and end of the transcript","href":"/pre-recorded-audio/set-the-start-and-end-of-the-transcript"},{"group":"Transcription operations","pages":[{"title":"Transcript Status","sidebarTitle":"Check transcript status","href":"/pre-recorded-audio/check-transcript-status"},{"title":"Transcript export options","sidebarTitle":"Export transcripts as SRT, VTT, or text","href":"/pre-recorded-audio/export-transcripts-as-srt-vtt-or-text"},{"title":"Delete Transcripts","sidebarTitle":"Delete transcripts","href":"/pre-recorded-audio/delete-transcripts"}]}]},{"group":"API reference","pages":[{"title":"Upload a media file","openapi":"openapi.yaml POST /v2/upload","description":"Upload a media file to AssemblyAI's servers.\n\n\u003cNote>To upload a media file to our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\n\u003cWarning>Requests to transcribe uploaded files must use an API key from the same project as the key that was used to upload the file. If you use an API key from a different project you will get a `403` error and \"Cannot access uploaded file\" message.\u003c/Warning>\n","href":"/pre-recorded-audio/api-reference/files/upload"},{"title":"Transcribe audio","openapi":"openapi.yaml POST /v2/transcript","href":"/pre-recorded-audio/api-reference/transcripts/submit"},{"title":"Get a transcript","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}","description":"\u003cNote>To retrieve your transcriptions on our EU server, replace `api.assemblyai.com` with `api.eu.assemblyai.com`.\u003c/Note>\nGet the transcript resource. The transcript is ready when the \"status\" is \"completed\".\n\nRequests to this endpoint are limited to 60 per minute for each API key and transcript combination. If you exceed this limit, the API returns a `429` response with a `Retry-After` header that indicates how many seconds to wait before retrying. To avoid polling, use [webhooks](/pre-recorded-audio/webhooks).\n","href":"/pre-recorded-audio/api-reference/transcripts/get"},{"title":"Get transcript sentences","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/sentences","href":"/pre-recorded-audio/api-reference/transcripts/get-sentences"},{"title":"Get transcript paragraphs","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/paragraphs","href":"/pre-recorded-audio/api-reference/transcripts/get-paragraphs"},{"title":"Get subtitles","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/{subtitle_format}","href":"/pre-recorded-audio/api-reference/transcripts/get-subtitles"},{"title":"Get redacted audio","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/redacted-audio","href":"/pre-recorded-audio/api-reference/transcripts/get-redacted-audio"},{"title":"Word search","openapi":"openapi.yaml GET /v2/transcript/{transcript_id}/word-search","href":"/pre-recorded-audio/api-reference/transcripts/word-search"},{"title":"List transcripts","openapi":"openapi.yaml GET /v2/transcript","href":"/pre-recorded-audio/api-reference/transcripts/list"},{"title":"Delete a transcript","openapi":"openapi.yaml DELETE /v2/transcript/{transcript_id}","href":"/pre-recorded-audio/api-reference/transcripts/delete"}]},{"group":"Advanced","pages":[{"title":"Webhooks for pre-recorded audio","sidebarTitle":"Webhooks","href":"/pre-recorded-audio/webhooks"},{"title":"Benchmarks","sidebarTitle":"View model benchmarks","href":"/pre-recorded-audio/benchmarks"},{"title":"Evaluating Pre-recorded STT models","sidebarTitle":"Evaluate model accuracy","href":"/pre-recorded-audio/evaluations"},{"title":"Cloud Endpoints and Data Residency","sidebarTitle":"Cloud endpoints \u0026 data residency","href":"/pre-recorded-audio/select-the-region"},{"title":"Rate limits","sidebarTitle":"Manage rate limits","href":"/pre-recorded-audio/rate-limits"}]},{"group":"Guides","pages":[{"group":"Migration guides","expanded":false,"pages":[{"title":"Migration guide: Deepgram to AssemblyAI","sidebarTitle":"Migration guide Deepgram to AssemblyAI","href":"/pre-recorded-audio/migration-guides/dg_to_aai"},{"title":"Migration guide: OpenAI to AssemblyAI","sidebarTitle":"Migration guide OpenAI to AssemblyAI","href":"/pre-recorded-audio/migration-guides/oai_to_aai"},{"title":"Migration guide: AWS Transcribe to AssemblyAI","sidebarTitle":"Migration guide AWS Transcribe to AssemblyAI","href":"/pre-recorded-audio/migration-guides/aws_to_aai"},{"title":"Migration guide: Google Speech-to-Text to AssemblyAI","sidebarTitle":"Migration guide Google Speech-to-Text to AssemblyAI","href":"/pre-recorded-audio/migration-guides/google_to_aai"},{"title":"Migration guide: Gladia to AssemblyAI","sidebarTitle":"Migration guide Gladia to AssemblyAI","href":"/pre-recorded-audio/migration-guides/gladia_to_aai"}]},{"group":"Tutorials","expanded":false,"pages":[{"title":"Best Practices for building Meeting Notetakers","sidebarTitle":"Build a meeting notetaker","href":"/meeting-notetaker-best-practices"},{"title":"Build a medical scribe","href":"/medical-scribe-best-practices"},{"title":"Best Practices for building Contact Center Applications","sidebarTitle":"Build a contact center application","href":"/contact-center-best-practices"},{"group":"Basic transcription workflows","pages":[{"title":"Get YouTube Video Transcripts with yt-dlp","href":"/pre-recorded-audio/guides/transcribe_youtube_videos"},{"title":"Build a UI for Transcription with Gradio and Python","href":"/pre-recorded-audio/guides/gradio-frontend"},{"title":"Detect Low Confidence Words in a Transcript","href":"/pre-recorded-audio/guides/detecting-low-confidence-words"}]},{"group":"Batch transcription","pages":[{"title":"Running Bulk Transcription and Load Tests at Scale","href":"/pre-recorded-audio/guides/bulk-transcription-and-load-tests-at-scale"},{"title":"Transcribe Multiple Files Simultaneously Using the JavaScript SDK","href":"/pre-recorded-audio/guides/sdk-node-batch"},{"title":"Transcribe Multiple Files Simultaneously Using the Python SDK","href":"/pre-recorded-audio/guides/batch_transcription"}]},{"group":"Hosting audio files","pages":[{"title":"Transcribe from an S3 Bucket","href":"/pre-recorded-audio/guides/transcribe_from_s3"},{"title":"Transcribe Google Drive Files","sidebarTitle":"Transcribe a Google Drive File","href":"/pre-recorded-audio/guides/transcribing-google-drive-file"},{"title":"Transcribe GitHub Files","href":"/pre-recorded-audio/guides/transcribing-github-files"}]},{"group":"Speaker labels","pages":[{"title":"Iterate over Speaker Labels with Make.com","href":"/pre-recorded-audio/guides/make-speaker-labels"},{"title":"Calculate the Talk / Listen Ratio of Speakers","href":"/pre-recorded-audio/guides/talk-listen-ratio"},{"title":"Plot A Speaker Timeline with Matplotlib","href":"/pre-recorded-audio/guides/speaker_timeline"},{"title":"Generate Custom Speaker Labels with Pyannote","href":"/pre-recorded-audio/guides/Use_AssemblyAI_with_Pyannote_to_generate_custom_Speaker_Labels"},{"title":"Use Speaker Diarization with Async Chunking","href":"/pre-recorded-audio/guides/speaker-diarization-with-async-chunking"},{"title":"Setup A Speaker Identification System using Pinecone \u0026 Nvidia TitaNet","href":"/pre-recorded-audio/guides/titanet-speaker-identification"}]},{"group":"Automatic Language Detection","pages":[{"title":"Use Automatic Language Detection as a Separate Step From Transcription","href":"/pre-recorded-audio/guides/automatic-language-detection-separate"},{"title":"Route to Default Language if Language Confidence is Low","href":"/pre-recorded-audio/guides/automatic-language-detection-route-default-language"}]},{"group":"Subtitles","pages":[{"title":"Create Custom Length Subtitles","href":"/pre-recorded-audio/guides/subtitle_creation_by_word_count"},{"title":"Create Subtitles with Speaker Labels","href":"/pre-recorded-audio/guides/speaker_labelled_subtitles"},{"title":"Generate Subtitles for Videos","href":"/pre-recorded-audio/guides/subtitles"},{"title":"Translate an AssemblyAI Subtitle Transcript","href":"/pre-recorded-audio/guides/translate_subtitles"}]},{"group":"Delete transcripts","pages":[{"title":"Schedule a DELETE request with AssemblyAI and EasyCron","href":"/pre-recorded-audio/guides/schedule_delete"}]},{"group":"Error handling and audio file fixes","pages":[{"title":"Troubleshoot Common Errors","href":"/pre-recorded-audio/guides/common_errors_and_solutions"},{"title":"Implement Retry Server Error Logic","href":"/pre-recorded-audio/guides/retry-server-error"},{"title":"Implement Retry Upload Error Logic","href":"/pre-recorded-audio/guides/retry-upload-error"},{"title":"Identify Duplicate Dual Channel Files","href":"/pre-recorded-audio/guides/identify_duplicate_channels"},{"title":"Correct Audio Duration Discrepancies with Multi-Tool Validation and Transcoding","href":"/pre-recorded-audio/guides/audio-duration-fix"},{"title":"Audio File Downsampling Recommendations and Best Practices","href":"/pre-recorded-audio/guides/downsampling"}]},{"group":"Translation","pages":[{"title":"Translate an AssemblyAI Subtitle Transcript","href":"/pre-recorded-audio/guides/translate_subtitles"},{"title":"Translate AssemblyAI Transcripts Into Other Languages Using Commercial Models","href":"/pre-recorded-audio/guides/translate_transcripts"},{"title":"Transform Chinese transcripts into Simplified or Traditional Text","href":"/pre-recorded-audio/guides/traditional_simplified_chinese"}]},{"group":"Do more with our SDKs","pages":[{"title":"Do More With Our SDKs","href":"/pre-recorded-audio/guides/do-more-with-sdk"}]}]}]}]},{"tab":"Real-time STT","pages":[{"title":"Real-time STT","href":"/streaming/getting-started/transcribe-streaming-audio"}]},{"tab":"Sync STT","pages":[{"title":"Sync STT","href":"/sync-stt/getting-started/quickstart"}]},{"tab":"Dictation API","pages":[{"title":"Dictation API","href":"/dictation"}]},{"tab":"Text to Speech","pages":[{"title":"Text to Speech","href":"/tts/getting-started/quickstart"}]},{"tab":"Voice Agent API","hidden":true,"pages":[{"title":"Voice Agent API","href":"/voice-agents/voice-agent-api"}]},{"tab":"Speech Understanding","pages":[{"title":"Speech Understanding","href":"/speech-understanding/getting-started"}]},{"tab":"Guardrails","pages":[{"title":"Guardrails","href":"/guardrails/getting-started"}]},{"tab":"LLM Gateway","pages":[{"title":"LLM Gateway","href":"/llm-gateway/quickstart"}]},{"tab":"FAQ","pages":[{"title":"FAQ","href":"/faq"}]}]},"basePath":"","title":"Transcribe audio - AssemblyAI","deploymentId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","buildId":"dpl_J2QdBVuN65x4CCtpqPb371YPt4xi","dynamics":["10e4515597","c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["BannerMarkdown-Cm-LN0H3.js","dist-DWEsd3cZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","OpenApiReferenceProvider-tiVafkWW.js","utils-CURQcKis.js","cloneDeep-D7WNbvHt.js","_Uint8Array-BY_XlfVz.js","isObject-FP1Yky1u.js","utils-CdFTKPRO.js","addUniqueKeysToSchema-BSfwE63N.js","snippetPresets-BHyg8yZ0.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-CQdVXSju.js","isEqual-ft5OxoSH.js","usePlaygroundInputsStore-BILH4rrw.js","shallow-DterCiSU.js","getApiPlaygroundDisplay-uFtORr6j.js","CodeSnippet-BeuhEvUS.js","CodeSnippets-laCoJsvn.js","Page-CTsmHnLF.js","getPastedJson-DOT1n5Lt.js","icon-COH-nmcZ.js","MethodPill-BbAWkCf6.js","DuplicateIcon-CpagiAFQ.js","createIcon-Bw2Dnowf.js","DynamicMarkdown-DzuINhDe.js","SectionHeading-B3H20qI6.js","axios-vUo_bRtp.js","Markdown-DBdbz5B3.js","AssistantPageLink-DuX7jTnG.js"]}