Creating summarized chapters from podcasts
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:
- One-line gist
- Start and end timestamps
In this step-by-step guide, you'll learn how to apply the model. You'll send the
auto_chapters parameter in your request, and then use
chapters property from the response.
Before we begin, make sure you have an AssemblyAI account and an API key. You can sign up for a free account and get your API key from your dashboard.
The entire source code of this guide can be viewed here.
Here's an audio example for this guide:
Create a new file and import the necessary libraries for making an HTTP request.
Set up the API endpoint and headers. The headers should include your API token.
Upload your local file to the AssemblyAI API.
upload_urlreturned by the AssemblyAI API to create a JSON payload containing the
audio_urlparameter and the
auto_chaptersparameter set to
POSTrequest to the AssemblyAI API endpoint with the payload and headers.
After making the request, you'll receive an ID for the transcription. Use it to poll the API every few seconds to check the status of the transcript job. Once the status is
completed, you can retrieve the transcript from the API response, using the
chapterskey to access the results.
Understanding the response
Your automatic chapters are located in the
chapters key of the API response. Each entry contains a
summary of the chapter, a one-line
gist and a chapter
Creating text summaries using our Auto Chapters functionality works on all kinds of different input sources, not just podcasts. For example, you can use it to summarize lecture videos or other long-form content.
If you need more fine-grained control than Auto Chapters offers, you can use AssemblyAI's Summarization model to customize the complexity of your summary.