> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gladia.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Chapterization

> The Chapterization model segments the audio into distinct chapters, each with a descriptive headline and summaries

<Badge color="blue" size="lg" icon="file-audio">
  Pre-recorded
</Badge>

<Badge color="green" icon="tower-broadcast" size="lg">
  Live
</Badge>

<Note>
  This feature is in **Alpha** state.<br />
  Breaking changes may still be introduced to this API, but advance notice will be sent.

  We're looking for feedback to improve this feature, [share yours on Discord](https://discord.gg/T22a4ETUQp).
</Note>

The chapterization model segments the audio
into logical chapters based on the audio and content, and makes it easier to navigate long audios such as meeting recordings.

Each chapter will contain its start and end time, as well as a summary, headline, bottom line "gist" and keywords.

## Usage

Enable chapterization by setting the appropriate flag:

<CodeGroup>
  ```json Pre-recorded theme={"system"}
  {
    "chapterization": true
  }
  ```

  ```json Live theme={"system"}
  {
    "post_processing": {
      "chapterization": true
    },
    "messages_config": {
      "receive_post_processing_events": true
    }
  }
  ```
</CodeGroup>

## Result

The transcription result will contain a `"chapterization"` key with the output of the model:

<CodeGroup>
  ```json Pre-recorded theme={"system"}
  {
    "transcription":{...},
    "chapterization": {
      "success": true,
      "is_empty": false,
      "results": [
            {
              "summary": "In a world where minimalism is valued, yet excess is desired, hope for the future remains. The past predicts the present, which is yet to be determined.",
              "headline": "Headline: \"Embracing Hope: The Interconnectedness of Past, Present, and Future\"",
              "gist": "Embracing Hope: Past, Present, Future Interconnected",
              "keywords": [
                "Split infinity",
                "less is more",
                "too much",
                "hope",
                "present"
              ],
              "start": 0.0,
              "end": 19.83977,
          }],
      "exec_time": 5.078396797180176,
      "error": null
    }
  }
  ```

  ```json Live theme={"system"}
  {
    "session_id": "550e8400-e29b-41d4-a716-446655440000",
    "created_at": "2025-09-19T12:46:00Z",
    "type": "post_chapterization",
    "error": null,
    "data": {
      "results": [
        {
          "headline": "Project kickoff",
          "start": 0,
          "end": 60,
          "keywords": [
            "timeline",
            "owner"
          ]
        }
      ]
    }
  }
  ```
</CodeGroup>