Accessibility

Chapters

View Markdown

Overview

The chapters task generates chapter markers for video and audio files using AI. Chapters divide long-form content into logical sections with timestamps and titles.

Chapters are output as WebVTT (.vtt) or SRT (.srt) files.

Creating a chapters task

curl -X POST "https://api.ittybit.com/tasks" \
-H "Authorization: Bearer ITTYBIT_API_KEY" \
-H "Content-Type: application/json" \
-d '{
  "url": "https://example.com/video.mp4",
  "kind": "chapters"
}'

Options

OptionTypeDescription
formatstringOutput format: vtt (default) or srt
{
  "url": "https://example.com/video.mp4",
  "kind": "chapters",
  "options": {
    "format": "vtt"
  }
}

Output

When the task succeeds, the output is a chapter file accessible via the outputs array:

{
  "id": "task_abcdefgh12345678",
  "object": "task",
  "kind": "chapters",
  "status": "succeeded",
  "inputs": [...],
  "outputs": [
    {
      "kind": "track",
      "type": "text/vtt",
      "url": "https://store.ittybit.net/..."
    }
  ],
  "created_at": 1735689825,
  "updated_at": 1735689886
}

Common use cases

  • Navigation for long-form content (tutorials, lectures, podcasts)
  • YouTube-style chapter markers
  • Table of contents for video libraries
  • Improved viewer engagement with skip-to-section navigation

Subtitles

Outline

Subtitles

Previous Page

Thumbnails

Next Page

On this page