Auto Chapters

The Auto Chapters model summarizes audio data over time into chapters. Chapters makes it easy for users to navigate and find specific information.

Each chapter contains the following:

  • Summary
  • One-line gist
  • Headline
  • Start and end timestamps
Auto Chapters and Summarization

You can only enable one of the Auto Chapters and Summarization models in the same transcription.

Quickstart

Enable Auto Chapters by setting auto_chapters to true in the transcription config. punctuate must be enabled to use Auto Chapters (punctuate is enabled by default).

1import assemblyai as aai
2
3aai.settings.api_key = "<YOUR_API_KEY>"
4
5# audio_file = "./local_file.mp3"
6audio_file = "https://assembly.ai/wildfires.mp3"
7
8config = aai.TranscriptionConfig(auto_chapters=True)
9
10transcript = aai.Transcriber().transcribe(audio_file, config)
11
12for chapter in transcript.chapters:
13  print(f"{chapter.start}-{chapter.end}: {chapter.headline}")

Open In Colab

Example output

1250-28840: Smoke from hundreds of wildfires in Canada is triggering air quality alerts across US
229610-280340: High particulate matter in wildfire smoke can lead to serious health problems
Auto Chapters Using LeMUR

Check out this cookbook Creating Chapter Summaries for an example of how to leverage LeMUR’s custom text input parameter for chapter summaries.

API reference

Request

$curl https://api.assemblyai.com/v2/transcript \
>--header "Authorization: <YOUR_API_KEY>" \
>--header "Content-Type: application/json" \
>--data '{
>  "audio_url": "YOUR_AUDIO_URL",
>  "auto_chapters": true
>}'
KeyTypeDescription
auto_chaptersbooleanEnable Auto Chapters.

Response

KeyTypeDescription
chaptersarrayAn array of temporally sequential chapters for the audio file.
chapters[i].giststringAn short summary in a few words of the content spoken in the i-th chapter.
chapters[i].headlinestringA single sentence summary of the content spoken during the i-th chapter.
chapters[i].summarystringA one paragraph summary of the content spoken during the i-th chapter.
chapters[i].startnumberThe starting time, in milliseconds, for the i-th chapter.
chapters[i].endnumberThe ending time, in milliseconds, for the i-th chapter.

The response also includes the request parameters used to generate the transcript.

Frequently asked questions

No, the number of chapters generated by the Auto Chapters model isn’t configurable by the user. The model automatically segments the audio file into logical chapters as the topic of conversation changes.

Troubleshooting

One possible reason is that the audio file doesn’t contain enough variety in topic or tone for the model to identify separate chapters. Another reason could be due to background noise or low-quality audio interfering with the model’s analysis.

Built with