DELETE
/
v2
/
transcript
/
{transcript_id}
Delete transcript
curl --request DELETE \
  --url https://api.assemblyai.com/v2/transcript/{transcript_id} \
  --header 'Authorization: <api-key>'
{
  "id": "9ea68fd3-f953-42c1-9742-976c447fb463",
  "speech_model": null,
  "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,
  "dual_channel": 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,
  "word_boost": [
    "aws",
    "azure",
    "google cloud"
  ],
  "boost_param": "high",
  "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&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
    }
  },
  "custom_spelling": null,
  "throttled": null,
  "auto_chapters": true,
  "summarization": true,
  "summary_type": "bullets",
  "summary_model": "informative",
  "custom_topics": true,
  "topics": [],
  "speech_threshold": 0.5,
  "disfluencies": false,
  "sentiment_analysis": true,
  "chapters": [
    {
      "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
    },
    {
      "summary": "Air pollution levels in Baltimore are considered unhealthy. Exposure to high levels can lead to a host of health problems. With climate change, we are seeing more wildfires. Will we be seeing more of these kinds of wide ranging air quality consequences?",
      "gist": "What is it about the conditions right now that have caused this round",
      "headline": "High particulate matter in wildfire smoke can lead to serious health problems",
      "start": 29610,
      "end": 280340
    }
  ],
  "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
    }
  ],
  "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.\\n- Air pollution levels in Baltimore are considered unhealthy. Exposure to high levels can lead to a host of health problems. With climate change, we are seeing more wildfires. Will we be seeing more of these kinds of wide ranging air quality consequences?",
  "speakers_expected": 2
}

Authorizations

​
Authorization
string
header
required

Path Parameters

​
transcript_id
string
required

ID of the transcript

Response

The deleted transcript response

A transcript object

​
id
string<uuid>
required

The unique identifier of your transcript

​
audio_url
string<url>
required

The URL of the media that was transcribed

​
status
enum<string>
required

The status of your transcript. Possible values are queued, processing, completed, or error.

Available options:
queued,
processing,
completed,
error
​
language_confidence_threshold
number | null
required

The confidence threshold for the automatically detected language. An error will be returned if the language confidence is below this threshold.

Required range: 0 <= x <= 1
​
language_confidence
number | null
required

The confidence score for the detected language, between 0.0 (low confidence) and 1.0 (high confidence)

Required range: 0 <= x <= 1
​
speech_model
enum<string> | null
required

The speech model used for the transcription. When null, the default model is used. The speech model to use for the transcription.

Available options:
best,
nano
​
webhook_auth
boolean
required

Whether webhook authentication details were provided

​
auto_highlights
boolean
required

Whether Key Phrases is enabled, either true or false

​
redact_pii
boolean
required

Whether PII Redaction is enabled, either true or false

​
summarization
boolean
required

Whether Summarization is enabled, either true or false

​
language_model
string
required
deprecated

The language model that was used for the transcript

​
acoustic_model
string
required
deprecated

The acoustic model that was used for the transcript

​
language_code

The language of your audio file. Possible values are found in Supported Languages. The default value is 'en_us'.

The language of your audio file. Possible values are found in Supported Languages. The default value is 'en_us'.

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,
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
​
language_detection
boolean | null

Whether Automatic language detection is enabled, either true or false

​
text
string | null

The textual transcript of your media file

​
words
object[] | null

An array of temporally-sequential word objects, one for each word in the transcript. See Speech recognition for more information.

​
utterances
object[] | null

When dual_channel or speaker_labels is enabled, a list of turn-by-turn utterance objects. See Speaker diarization for more information.

​
confidence
number | null

The confidence score for the transcript, between 0.0 (low confidence) and 1.0 (high confidence)

Required range: 0 <= x <= 1
​
audio_duration
integer | null

The duration of this transcript object's media file, in seconds

​
punctuate
boolean | null

Whether Automatic Punctuation is enabled, either true or false

​
format_text
boolean | null

Whether Text Formatting is enabled, either true or false

​
disfluencies
boolean | null

Transcribe Filler Words, like "umm", in your media file; can be true or false

​
multichannel
boolean | null

Whether Multichannel transcription was enabled in the transcription request, either true or false

​
audio_channels
integer

The number of audio channels in the audio file. This is only present when multichannel is enabled.

​
dual_channel
boolean | null
deprecated

Whether Dual channel transcription was enabled in the transcription request, either true or false

​
webhook_url
string<url> | null

The URL to which we send webhook requests. We sends two different types of webhook requests. One request when a transcript is completed or failed, and one request when the redacted audio is ready if redact_pii_audio is enabled.

​
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

​
webhook_auth_header_name
string | null

The header name to be sent with the transcript completed or failed webhook requests

​
speed_boost
boolean | null
deprecated

Whether speed boost is enabled

​
auto_highlights_result
object | null

An array of results for the Key Phrases model, if it is enabled. See Key Phrases for more information.

An array of results for the Key Phrases model, if it is enabled. See Key phrases for more information.

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 }]
    }
  ]
}
​
audio_start_from
integer | null

The point in time, in milliseconds, in the file at which the transcription was started

​
audio_end_at
integer | null

The point in time, in milliseconds, in the file at which the transcription was terminated

​
word_boost
string[]

The list of custom vocabulary to boost transcription probability for

​
boost_param
string | null

The word boost parameter value

​
filter_profanity
boolean | null

Whether Profanity Filtering is enabled, either true or false

​
redact_pii_audio
boolean | null

Whether a redacted version of the audio file was generated, either true or false. See PII redaction for more information.

​
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.

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>[] | null

The list of PII Redaction policies that were enabled, if PII Redaction is enabled. See PII redaction for more information.

​
redact_pii_sub
enum<string>

The replacement logic for detected PII, can be "entity_type" or "hash". See PII redaction for more details.

Available options:
entity_name,
hash
​
speaker_labels
boolean | null

Whether Speaker diarization is enabled, can be true or false

​
speakers_expected
integer | null

Tell the speaker label model how many speakers it should attempt to identify, up to 10. See Speaker diarization for more details.

​
content_safety
boolean | null

Whether Content Moderation is enabled, can be true or false

​
content_safety_labels
object | null

An array of results for the Content Moderation model, if it is enabled. See Content moderation for more information.

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
    }
  }
}
​
iab_categories
boolean | null

Whether Topic Detection is enabled, can be true or false

​
iab_categories_result
object | null

The result of the Topic Detection model, if it is enabled. See Topic Detection for more information.

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
  }
}
​
custom_spelling
object[] | null

Customize how words are spelled and formatted using to and from values

​
auto_chapters
boolean | null

Whether Auto Chapters is enabled, can be true or false

​
chapters
object[] | null

An array of temporally sequential chapters for the audio file

​
summary_type
string | null

The type of summary generated, if Summarization is enabled

​
summary_model
string | null

The Summarization model used to generate the summary, if Summarization is enabled

​
summary
string | null

The generated summary of the media file, if Summarization is enabled

​
custom_topics
boolean | null

Whether custom topics is enabled, either true or false

​
topics
string[]

The list of custom topics provided if custom topics is enabled

​
sentiment_analysis
boolean | null

Whether Sentiment Analysis is enabled, can be true or false

​
sentiment_analysis_results
object[] | null

An array of results for the Sentiment Analysis model, if it is enabled. See Sentiment Analysis for more information.

​
entity_detection
boolean | null

Whether Entity Detection is enabled, can be true or false

​
entities
object[] | null

An array of results for the Entity Detection model, if it is enabled. See Entity detection for more information.

​
speech_threshold
number | null

Defaults to null. Reject audio files that contain less than this fraction of speech. Valid values are in the range [0, 1] inclusive.

Required range: 0 <= x <= 1
​
throttled
boolean | null

True while a request is throttled and false when a request is no longer throttled

​
error
string

Error message of why the transcript failed