Accessibility

Subtitles

View Markdown

Overview

The subtitles task generates subtitle tracks from video or audio files using AI-powered speech recognition.

Subtitles are output as WebVTT (.vtt) or SRT (.srt) files that can be used directly in video players.

Creating a subtitles 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": "subtitles"
}'

Options

OptionTypeDescription
formatstringOutput format: vtt (default) or srt
labelstringA label for the subtitle track (e.g. "English")
{
  "url": "https://example.com/video.mp4",
  "kind": "subtitles",
  "options": {
    "format": "srt",
    "label": "English"
  }
}

Output

When the task succeeds, the output is a subtitle file (VTT or SRT) accessible via the outputs array:

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

Supported inputs

  • Audio files: .mp3, .m4a, .wav, .ogg, .aac, .flac
  • Video files with audio: .mp4, .mov, .webm

Common use cases

  • Adding captions to videos for accessibility
  • Multi-language subtitle generation
  • Making video content searchable by transcript
  • Compliance with accessibility requirements

Speech

Chapters

Audio

Previous Page

Chapters

Next Page

On this page