Submit a transcript

Transcribe audio

curl --request POST \
  --url https://api.assemblyai.com/v2/transcript \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
}
'

import requests

url = "https://api.assemblyai.com/v2/transcript"

payload = {
    "speech_model": None,
    "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": None,
    "summary_type": None,
    "custom_topics": True,
    "topics": [],
    "remove_audio_tags": None,
    "domain": None,
    "speech_understanding": { "request": { "translation": {
                "target_languages": ["es", "de"],
                "formal": True,
                "match_original_utterance": True
            } } },
    "audio_url": "https://assembly.ai/wildfires.mp3"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.assemblyai.com/v2/transcript', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.assemblyai.com/v2/transcript",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.assemblyai.com/v2/transcript"

	payload := strings.NewReader("{\n  \"speech_model\": null,\n  \"language_detection\": true,\n  \"language_confidence_threshold\": 0.7,\n  \"punctuate\": true,\n  \"format_text\": true,\n  \"multichannel\": true,\n  \"webhook_url\": \"https://your-webhook-url/path\",\n  \"webhook_auth_header_name\": \"webhook-secret\",\n  \"webhook_auth_header_value\": \"webhook-secret-value\",\n  \"auto_highlights\": true,\n  \"audio_start_from\": 10,\n  \"audio_end_at\": 280,\n  \"filter_profanity\": true,\n  \"redact_pii\": true,\n  \"redact_pii_audio\": true,\n  \"redact_pii_audio_quality\": \"mp3\",\n  \"redact_pii_policies\": [\n    \"us_social_security_number\",\n    \"credit_card_number\"\n  ],\n  \"redact_pii_sub\": \"hash\",\n  \"speaker_labels\": true,\n  \"speakers_expected\": 2,\n  \"content_safety\": true,\n  \"iab_categories\": true,\n  \"custom_spelling\": [],\n  \"disfluencies\": false,\n  \"sentiment_analysis\": true,\n  \"auto_chapters\": false,\n  \"entity_detection\": true,\n  \"speech_threshold\": 0.5,\n  \"summarization\": false,\n  \"summary_model\": null,\n  \"summary_type\": null,\n  \"custom_topics\": true,\n  \"topics\": [],\n  \"remove_audio_tags\": null,\n  \"domain\": null,\n  \"speech_understanding\": {\n    \"request\": {\n      \"translation\": {\n        \"target_languages\": [\n          \"es\",\n          \"de\"\n        ],\n        \"formal\": true,\n        \"match_original_utterance\": true\n      }\n    }\n  },\n  \"audio_url\": \"https://assembly.ai/wildfires.mp3\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.assemblyai.com/v2/transcript")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"speech_model\": null,\n  \"language_detection\": true,\n  \"language_confidence_threshold\": 0.7,\n  \"punctuate\": true,\n  \"format_text\": true,\n  \"multichannel\": true,\n  \"webhook_url\": \"https://your-webhook-url/path\",\n  \"webhook_auth_header_name\": \"webhook-secret\",\n  \"webhook_auth_header_value\": \"webhook-secret-value\",\n  \"auto_highlights\": true,\n  \"audio_start_from\": 10,\n  \"audio_end_at\": 280,\n  \"filter_profanity\": true,\n  \"redact_pii\": true,\n  \"redact_pii_audio\": true,\n  \"redact_pii_audio_quality\": \"mp3\",\n  \"redact_pii_policies\": [\n    \"us_social_security_number\",\n    \"credit_card_number\"\n  ],\n  \"redact_pii_sub\": \"hash\",\n  \"speaker_labels\": true,\n  \"speakers_expected\": 2,\n  \"content_safety\": true,\n  \"iab_categories\": true,\n  \"custom_spelling\": [],\n  \"disfluencies\": false,\n  \"sentiment_analysis\": true,\n  \"auto_chapters\": false,\n  \"entity_detection\": true,\n  \"speech_threshold\": 0.5,\n  \"summarization\": false,\n  \"summary_model\": null,\n  \"summary_type\": null,\n  \"custom_topics\": true,\n  \"topics\": [],\n  \"remove_audio_tags\": null,\n  \"domain\": null,\n  \"speech_understanding\": {\n    \"request\": {\n      \"translation\": {\n        \"target_languages\": [\n          \"es\",\n          \"de\"\n        ],\n        \"formal\": true,\n        \"match_original_utterance\": true\n      }\n    }\n  },\n  \"audio_url\": \"https://assembly.ai/wildfires.mp3\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.assemblyai.com/v2/transcript")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"speech_model\": null,\n  \"language_detection\": true,\n  \"language_confidence_threshold\": 0.7,\n  \"punctuate\": true,\n  \"format_text\": true,\n  \"multichannel\": true,\n  \"webhook_url\": \"https://your-webhook-url/path\",\n  \"webhook_auth_header_name\": \"webhook-secret\",\n  \"webhook_auth_header_value\": \"webhook-secret-value\",\n  \"auto_highlights\": true,\n  \"audio_start_from\": 10,\n  \"audio_end_at\": 280,\n  \"filter_profanity\": true,\n  \"redact_pii\": true,\n  \"redact_pii_audio\": true,\n  \"redact_pii_audio_quality\": \"mp3\",\n  \"redact_pii_policies\": [\n    \"us_social_security_number\",\n    \"credit_card_number\"\n  ],\n  \"redact_pii_sub\": \"hash\",\n  \"speaker_labels\": true,\n  \"speakers_expected\": 2,\n  \"content_safety\": true,\n  \"iab_categories\": true,\n  \"custom_spelling\": [],\n  \"disfluencies\": false,\n  \"sentiment_analysis\": true,\n  \"auto_chapters\": false,\n  \"entity_detection\": true,\n  \"speech_threshold\": 0.5,\n  \"summarization\": false,\n  \"summary_model\": null,\n  \"summary_type\": null,\n  \"custom_topics\": true,\n  \"topics\": [],\n  \"remove_audio_tags\": null,\n  \"domain\": null,\n  \"speech_understanding\": {\n    \"request\": {\n      \"translation\": {\n        \"target_languages\": [\n          \"es\",\n          \"de\"\n        ],\n        \"formal\": true,\n        \"match_original_utterance\": true\n      }\n    }\n  },\n  \"audio_url\": \"https://assembly.ai/wildfires.mp3\"\n}"

response = http.request(request)
puts response.read_body

{
  "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,
  "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&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": false,
  "summarization": false,
  "summary_type": null,
  "summary_model": null,
  "custom_topics": true,
  "topics": [],
  "speech_threshold": 0.5,
  "remove_audio_tags": null,
  "domain": null,
  "disfluencies": false,
  "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
}

{
  "error": "This is a sample error message"
}

{
  "error": "Authentication error, API token missing/invalid"
}

{
  "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."
}

POST

transcript

Transcribe audio

curl --request POST \
  --url https://api.assemblyai.com/v2/transcript \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "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"
}
'

import requests

url = "https://api.assemblyai.com/v2/transcript"

payload = {
    "speech_model": None,
    "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": None,
    "summary_type": None,
    "custom_topics": True,
    "topics": [],
    "remove_audio_tags": None,
    "domain": None,
    "speech_understanding": { "request": { "translation": {
                "target_languages": ["es", "de"],
                "formal": True,
                "match_original_utterance": True
            } } },
    "audio_url": "https://assembly.ai/wildfires.mp3"
}
headers = {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    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'
  })
};

fetch('https://api.assemblyai.com/v2/transcript', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.assemblyai.com/v2/transcript",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    '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'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: <api-key>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.assemblyai.com/v2/transcript"

	payload := strings.NewReader("{\n  \"speech_model\": null,\n  \"language_detection\": true,\n  \"language_confidence_threshold\": 0.7,\n  \"punctuate\": true,\n  \"format_text\": true,\n  \"multichannel\": true,\n  \"webhook_url\": \"https://your-webhook-url/path\",\n  \"webhook_auth_header_name\": \"webhook-secret\",\n  \"webhook_auth_header_value\": \"webhook-secret-value\",\n  \"auto_highlights\": true,\n  \"audio_start_from\": 10,\n  \"audio_end_at\": 280,\n  \"filter_profanity\": true,\n  \"redact_pii\": true,\n  \"redact_pii_audio\": true,\n  \"redact_pii_audio_quality\": \"mp3\",\n  \"redact_pii_policies\": [\n    \"us_social_security_number\",\n    \"credit_card_number\"\n  ],\n  \"redact_pii_sub\": \"hash\",\n  \"speaker_labels\": true,\n  \"speakers_expected\": 2,\n  \"content_safety\": true,\n  \"iab_categories\": true,\n  \"custom_spelling\": [],\n  \"disfluencies\": false,\n  \"sentiment_analysis\": true,\n  \"auto_chapters\": false,\n  \"entity_detection\": true,\n  \"speech_threshold\": 0.5,\n  \"summarization\": false,\n  \"summary_model\": null,\n  \"summary_type\": null,\n  \"custom_topics\": true,\n  \"topics\": [],\n  \"remove_audio_tags\": null,\n  \"domain\": null,\n  \"speech_understanding\": {\n    \"request\": {\n      \"translation\": {\n        \"target_languages\": [\n          \"es\",\n          \"de\"\n        ],\n        \"formal\": true,\n        \"match_original_utterance\": true\n      }\n    }\n  },\n  \"audio_url\": \"https://assembly.ai/wildfires.mp3\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.assemblyai.com/v2/transcript")
  .header("Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"speech_model\": null,\n  \"language_detection\": true,\n  \"language_confidence_threshold\": 0.7,\n  \"punctuate\": true,\n  \"format_text\": true,\n  \"multichannel\": true,\n  \"webhook_url\": \"https://your-webhook-url/path\",\n  \"webhook_auth_header_name\": \"webhook-secret\",\n  \"webhook_auth_header_value\": \"webhook-secret-value\",\n  \"auto_highlights\": true,\n  \"audio_start_from\": 10,\n  \"audio_end_at\": 280,\n  \"filter_profanity\": true,\n  \"redact_pii\": true,\n  \"redact_pii_audio\": true,\n  \"redact_pii_audio_quality\": \"mp3\",\n  \"redact_pii_policies\": [\n    \"us_social_security_number\",\n    \"credit_card_number\"\n  ],\n  \"redact_pii_sub\": \"hash\",\n  \"speaker_labels\": true,\n  \"speakers_expected\": 2,\n  \"content_safety\": true,\n  \"iab_categories\": true,\n  \"custom_spelling\": [],\n  \"disfluencies\": false,\n  \"sentiment_analysis\": true,\n  \"auto_chapters\": false,\n  \"entity_detection\": true,\n  \"speech_threshold\": 0.5,\n  \"summarization\": false,\n  \"summary_model\": null,\n  \"summary_type\": null,\n  \"custom_topics\": true,\n  \"topics\": [],\n  \"remove_audio_tags\": null,\n  \"domain\": null,\n  \"speech_understanding\": {\n    \"request\": {\n      \"translation\": {\n        \"target_languages\": [\n          \"es\",\n          \"de\"\n        ],\n        \"formal\": true,\n        \"match_original_utterance\": true\n      }\n    }\n  },\n  \"audio_url\": \"https://assembly.ai/wildfires.mp3\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.assemblyai.com/v2/transcript")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"speech_model\": null,\n  \"language_detection\": true,\n  \"language_confidence_threshold\": 0.7,\n  \"punctuate\": true,\n  \"format_text\": true,\n  \"multichannel\": true,\n  \"webhook_url\": \"https://your-webhook-url/path\",\n  \"webhook_auth_header_name\": \"webhook-secret\",\n  \"webhook_auth_header_value\": \"webhook-secret-value\",\n  \"auto_highlights\": true,\n  \"audio_start_from\": 10,\n  \"audio_end_at\": 280,\n  \"filter_profanity\": true,\n  \"redact_pii\": true,\n  \"redact_pii_audio\": true,\n  \"redact_pii_audio_quality\": \"mp3\",\n  \"redact_pii_policies\": [\n    \"us_social_security_number\",\n    \"credit_card_number\"\n  ],\n  \"redact_pii_sub\": \"hash\",\n  \"speaker_labels\": true,\n  \"speakers_expected\": 2,\n  \"content_safety\": true,\n  \"iab_categories\": true,\n  \"custom_spelling\": [],\n  \"disfluencies\": false,\n  \"sentiment_analysis\": true,\n  \"auto_chapters\": false,\n  \"entity_detection\": true,\n  \"speech_threshold\": 0.5,\n  \"summarization\": false,\n  \"summary_model\": null,\n  \"summary_type\": null,\n  \"custom_topics\": true,\n  \"topics\": [],\n  \"remove_audio_tags\": null,\n  \"domain\": null,\n  \"speech_understanding\": {\n    \"request\": {\n      \"translation\": {\n        \"target_languages\": [\n          \"es\",\n          \"de\"\n        ],\n        \"formal\": true,\n        \"match_original_utterance\": true\n      }\n    }\n  },\n  \"audio_url\": \"https://assembly.ai/wildfires.mp3\"\n}"

response = http.request(request)
puts response.read_body

{
  "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,
  "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&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": false,
  "summarization": false,
  "summary_type": null,
  "summary_model": null,
  "custom_topics": true,
  "topics": [],
  "speech_threshold": 0.5,
  "remove_audio_tags": null,
  "domain": null,
  "disfluencies": false,
  "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
}

{
  "error": "This is a sample error message"
}

{
  "error": "Authentication error, API token missing/invalid"
}

{
  "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."
}

Authorizations

Authorization

string

header

required

Body

application/json

Params to create a transcript

The parameters for creating a transcript

audio_url

string<url>

required

The URL of the audio or video file to transcribe.

audio_end_at

integer

The point in time, in milliseconds, to stop transcribing in your media file. See Set the start and end of the transcript for more details.

audio_start_from

integer

The point in time, in milliseconds, to begin transcribing in your media file. See Set the start and end of the transcript for more details.

auto_chapters

boolean

default:false

deprecated

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.

auto_highlights

boolean

default:false

Enable Key Phrases, either true or false

content_safety

boolean

default:false

Enable Content Moderation, can be true or false

content_safety_confidence

integer

default:50

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

default:false

Transcribe Filler Words, like "umm", in your media file; can be true or false. Supported on Universal-3.5 Pro and Universal-2.

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 medical terms such as medications, procedures, conditions, and dosages.

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.

Available options:

medical-v1,

null

entity_detection

boolean

default:false

Enable Entity Detection, can be true or false

filter_profanity

boolean

default:false

Filter profanity from the transcribed text, can be true or false. See Profanity Filtering for more details.

format_text

boolean

default:true

Enable Text Formatting, can be true or false

iab_categories

boolean

default:false

Enable Topic Detection, can be true or false

keyterms_prompt

string[]

Improve accuracy with up to 200 (for Universal-2) or 1000 (for Universal-3.5 Pro) domain-specific words or phrases (maximum 6 words per phrase). See Keyterms Prompting for more details.

language_code

The language of your audio file. Possible values are found in Supported Languages. If you don't specify a language, it's detected automatically. Cannot be used together with language_detection.

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_codes

enum<string>[] | null

The language codes of your audio file. Used for Code switching One of the values specified must be en.

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,

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_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 and routes the request to the best 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.

language_detection_options

object

Specify options for Automatic Language Detection.

Show child attributes

multichannel

boolean

default:false

Enable Multichannel transcription, can be true or false.

prompt

string

Provide natural language prompting of up to 1,500 words of contextual information to the model. See the Prompting Guide for best practices.

Note: This parameter is only supported for the Universal-3.5 Pro model.

punctuate

boolean

default:true

Enable Automatic Punctuation, can be true or false

redact_pii

boolean

default:false

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.

redact_pii_audio_options

object

Specify options for PII redacted audio files.

Show child attributes

redact_pii_audio_quality

enum<string>

default:mp3

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. Supported values: universal-3-5-pro, universal-2. If omitted, defaults to ["universal-3-5-pro", "universal-2"]. See Model Selection for available models and routing behavior.

The speech model to use for the transcription. See Model Selection for available models.

Available options:

universal-3-5-pro,

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.

Required range: 0 <= x <= 1

speech_understanding

object

Enable speech understanding tasks like Translation, Speaker Identification, and Custom Formatting. See the task-specific docs for available options and configuration.

Show child attributes

summarization

boolean

default:false

deprecated

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

Universal-3.5 Pro 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 Universal-3.5 Pro 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 Universal-3.5 Pro 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.

webhook_url

string<url>

The URL to which we send webhook requests.

custom_topics

boolean

default:false

deprecated

This parameter does not currently have any functionality attached to it.

speech_model

enum<string> | null

deprecated

This parameter has been replaced with the speech_models parameter, learn more about the speech_models parameter here.

Available options:

universal-3-5-pro,

universal-2

topics

string[]

deprecated

This parameter does not currently have any functionality attached to it.

Callbacks

POST

{$request.body#/webhook_url}transcriptReadyWebhook

Body

application/json

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

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.

Available options:

queued,

processing,

completed,

error

summarization

boolean

required

deprecated

Whether Summarization is enabled, either true or false. 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.

webhook_auth

boolean

required

Whether webhook authentication details were provided

acoustic_model

string

required

deprecated

This parameter does not currently have any functionality attached to it.

language_model

string

required

deprecated

This parameter does not currently have any functionality attached to it.

speech_model

enum<string> | null

required

deprecated

This parameter has been replaced with the speech_models parameter, learn more about the speech_models parameter here.

Available options:

universal-3-5-pro,

universal-2

audio_channels

integer

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

audio_duration

integer | null

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

audio_end_at

integer | null

The point in time, in milliseconds, in the file at which the transcription was terminated. See Set the start and end of the transcript for more details.

audio_start_from

integer | null

The point in time, in milliseconds, in the file at which the transcription was started. See Set the start and end of the transcript for more details.

auto_chapters

boolean | null

deprecated

Whether Auto Chapters is enabled, can be true or false. 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.

auto_highlights_result

object | null

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

Show child attributes

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 }]
    }
  ]
}

chapters

object[] | null

An array of temporally sequential chapters for the audio file. See Auto Chapters for more information.

Show child attributes

confidence

number<double> | null

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

Required range: 0 <= x <= 1

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.

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

Show child attributes

disfluencies

boolean | null

Transcribe Filler Words, like "umm", in your media file; can be true or false. Supported on Universal-3.5 Pro and Universal-2.

domain

string | null

The domain-specific model applied to the transcript. When set to "medical-v1", Medical Mode was used to improve accuracy for medical terminology.

entities

object[] | null

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

Show child attributes

entity_detection

boolean | null

Whether Entity Detection is enabled, can be true or false

error

string

Error message of why the transcript failed

filter_profanity

boolean | null

Whether Profanity Filtering is enabled, either true or false

format_text

boolean | null

Whether Text Formatting is enabled, either true or false

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.

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 Universal-3.5 Pro) domain-specific words or phrases (maximum 6 words per phrase). See Keyterms Prompting for more details.

language_code

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,

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_codes

enum<string>[] | null

The language codes of your audio file. Used for Code switching One of the values specified must be en.

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,

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

language_detection_options

object

Specify options for Automatic Language Detection.

Show child attributes

multichannel

boolean | null

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

prompt

string

Provide natural language prompting of up to 1,500 words of contextual information to the model. See the Prompting Guide for best practices.

Note: This parameter is only supported for the Universal-3.5 Pro model.

punctuate

boolean | null

Whether Automatic Punctuation 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_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.

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.

Show child attributes

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

universal-3-5-pro,

universal-2

speech_models

enum<string>[] | null

List of speech models that were used (in priority order) to transcribe the audio. If not specified in the request, this defaults to ["universal-3-5-pro", "universal-2"]. See Model Selection for available models and routing behavior.

The speech model to use for the transcription. See Model Selection for available models.

Available options:

universal-3-5-pro,

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.

Required range: 0 <= x <= 1

speech_understanding

object

Speech understanding tasks like Translation, Speaker Identification, and Custom Formatting. See the task-specific docs for available options and configuration.

Show child attributes

summary

string | null

deprecated

The generated summary of the media file, if Summarization is enabled. Deprecated - use LLM Gateway instead for more flexible summaries. See the updated Summarization page for details.

summary_model

string | null

deprecated

The Summarization model used to generate the summary, if Summarization is enabled. Deprecated - use LLM Gateway instead for more flexible summaries. See the updated Summarization page for details.

summary_type

string | null

deprecated

The type of summary generated, if Summarization is enabled. Deprecated - use LLM Gateway instead for more flexible summaries. See the updated Summarization page for details.

remove_audio_tags

enum<string> | null

Note: This parameter is only supported for the Universal-3.5 Pro 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 Universal-3.5 Pro 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

utterances

object[] | null

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

Show child attributes

unredacted_utterances

object[] | null

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

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_url

string<url> | null

The URL to which we send webhook requests.

words

object[] | null

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

Upload a media file

Get a transcript

⌘I

Getting started

Features

API reference

Advanced

Guides

Authorizations

Body

Callbacks

Body

Response

Body

Response

Response