Intelligence

Summary

View Markdown

Overview

The summary task kind uses AI to generate a title, description, tags, and language detection for your media files.

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

The summary task has no configurable options — all fields are generated automatically.

Output

When the task succeeds, the result includes:

FieldTypeDescription
titlestringAn AI-generated title for the media
descriptionstringA natural language description of the content
tagsstring[]Relevant tags extracted from the content
languagesstring[]Detected languages in the media
{
  "id": "task_abcdefgh12345678",
  "object": "task",
  "kind": "summary",
  "status": "succeeded",
  "title": "Mountain Hiking Adventure",
  "description": "A group of hikers trekking through alpine meadows with snow-capped peaks in the background...",
  "tags": ["hiking", "mountains", "outdoors", "adventure", "nature"],
  "languages": ["en"],
  "inputs": [...],
  "outputs": [...],
  "created_at": 1735689825,
  "updated_at": 1735689886
}

Use cases

  • SEO optimization — Automatically generate titles and descriptions for uploaded media
  • Content moderation — Tag and categorize user-uploaded content
  • Search — Make media searchable by generated tags and descriptions
  • Cataloging — Automatically organize large media libraries

Speech

Outline

NSFW

Thumbnails

Previous Page

Speech

Next Page

On this page