Ittybit

Get started

Get an API key

Create your free account and get an API key when you set up your project.

Make your first API call

You can use the terminal, an API client like Postman, or any HTTP library to make your first API call.

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

This creates a new task that generates an AI-powered title, description, and tags for the video.

Check the result

Poll the task to see when it finishes:

curl "https://api.ittybit.com/tasks/task_abcdefgh12345678" \
-H "Authorization: Bearer ITTYBIT_API_KEY"

When the task status changes to succeeded, the result is ready.

{
  "id": "task_abcdefgh12345678",
  "object": "task",
  "kind": "summary",
  "status": "succeeded",
  "title": "Sunset over the ocean",
  "description": "A timelapse video capturing a vibrant sunset...",
  "tags": ["sunset", "ocean", "timelapse", "nature"],
  "languages": ["en"],
  "inputs": [...],
  "outputs": [...],
  "created_at": 1735689825,
  "updated_at": 1735689886
}

Explore the docs

Now that you've made your first API call, explore the docs, browse the API reference, or check out the guides for common use cases.

Tasks

Tasks let you do powerful things with media files in just a few lines of code. Use tasks to transcode videos, generate thumbnails, extract audio, create subtitles, and more.

Videos

Images

Audio

Subtitles

Chapters

Thumbnails

Summary

NSFW

Speech

Outline

AI & LLMs

All docs pages include a button to copy the page as markdown, and a button to view the page as markdown (you can also add .md to the end of URLs).

View llms.txt

Resources

API Reference

Changelog

Glossary

Error Codes

Get Support

Questions

We're constantly adding and updating these docs, but they're not exhaustive yet.

If you have any questions, please don't hesitate to contact us.

We're always happy to help!

Quickstart Guide