# Media tools for developers (and agents)

[View original](https://ittybit.com/docs/about)

<Player
  media={{
id: 'med_55cms472B2ek6bPx',
object: 'media',
kind: 'video',
title: 'Ittybit Homepage Video',
width: 3840,
height: 2160,
duration: 72,
files: [
  {
    id: 'file_57fkKM75hMLo1j5V',
    object: 'source',
    kind: 'video',
    type: "video/mp4; codecs='avc1.6440, mp4a.40.2'",
    codec: 'h264',
    container: 'mp4',
    width: 1920,
    height: 1080,
    orientation: 'landscape',
    duration: 72,
    fps: 24,
    filesize: 14168502,
    bitrate: 1574278,
    ref: null,
    folder: null,
    filename: 'ittybit_homepage_20250816_h264_1080p.mp4',
    url: 'https://webapp.ittybit.net/ittybit_homepage_20250816_h264_1080p.mp4',
    metadata: {},
    created_by: null,
    created: '2025-08-16T20:46:48.769Z',
    updated: '2025-08-16T20:46:48.769Z',
  },
  {
    id: 'file_57fkKy764f6pRbyG',
    object: 'source',
    kind: 'video',
    type: "video/mp4; codecs='avc1.6431, mp4a.40.2'",
    codec: 'h264',
    container: 'mp4',
    width: 1280,
    height: 720,
    orientation: 'landscape',
    duration: 72,
    fps: 24,
    filesize: 7534107,
    bitrate: 837123,
    ref: null,
    folder: null,
    filename: 'ittybit_homepage_20250816_h264_720p.mp4',
    url: 'https://webapp.ittybit.net/ittybit_homepage_20250816_h264_720p.mp4',
    metadata: {},
    created_by: null,
    created: '2025-08-16T20:46:34.780Z',
    updated: '2025-08-16T20:46:34.780Z',
  },
  {
    id: 'file_57flkp480AJH47Iq',
    object: 'source',
    kind: 'video',
    type: "video/mp4; codecs='avc1.6430, mp4a.40.2'",
    codec: 'h264',
    container: 'mp4',
    width: 640,
    height: 360,
    orientation: 'landscape',
    duration: 72,
    fps: 24,
    filesize: 3445987,
    bitrate: 382887,
    ref: null,
    folder: null,
    filename: 'ittybit_homepage_20250816_h264_360p.mp4',
    url: 'https://webapp.ittybit.net/ittybit_homepage_20250816_h264_360p.mp4',
    metadata: {},
    created_by: null,
    created: '2025-08-16T21:20:25.504Z',
    updated: '2025-08-16T21:20:25.504Z',
  },
  {
    id: 'file_55d0gv99qjn2wRLV',
    object: 'source',
    kind: 'image',
    type: 'image/png',
    width: 1280,
    height: 720,
    orientation: 'landscape',
    duration: 0,
    fps: 0,
    filesize: 693075,
    bitrate: 0,
    ref: 'poster',
    folder: null,
    filename: 'ittybit-demo-20250613-poster.png',
    url: 'https://webapp.ittybit.net/ittybit-demo-20250613-poster.png',
    metadata: {},
    created_by: null,
    created: '2025-06-14T00:16:32.358Z',
    updated: '2025-06-14T00:16:32.358Z',
  },
  {
    id: 'file_55d0Jc62RJagZ7NL',
    object: 'track',
    kind: 'subtitles',
    type: 'text/vtt',
    filesize: '1778',
    language: 'en',
    label: 'English',
    ref: 'subtitles',
    folder: null,
    filename: 'ittybit-demo-20250613-subtitles.vtt',
    url: 'https://webapp.ittybit.net/ittybit-demo-20250613-subtitles.vtt',
    metadata: {},
    created_by: null,
    created: '2025-06-14T00:45:13.985Z',
    updated: '2025-06-14T00:45:13.985Z',
  },
  {
    id: 'file_55d0IV82NrlPOhOz',
    object: 'track',
    kind: 'thumbnails',
    type: 'text/vtt',
    filesize: '114002',
    label: null,
    ref: 'thumbnails',
    folder: null,
    filename: 'ittybit-demo-20250613-thumbnails.vtt',
    url: 'https://webapp.ittybit.net/ittybit-demo-20250613-thumbnails.vtt',
    metadata: {},
    created_by: null,
    created: '2025-06-14T00:45:15.956Z',
    updated: '2025-06-14T00:45:15.956Z',
  },
  {
    id: 'file_55dkQX74uxnsVV7e',
    object: 'track',
    kind: 'chapters',
    type: 'text/vtt',
    filesize: '183',
    language: 'en',
    label: null,
    ref: 'chapters',
    folder: null,
    filename: 'ittybit-demo-20250613-chapters.vtt',
    url: 'https://webapp.ittybit.net/ittybit-demo-20250613-chapters.vtt',
    metadata: {},
    created_by: null,
    created: '2025-06-14T20:53:01.829Z',
    updated: '2025-06-14T20:53:01.829Z',
  },
],
urls: {
  placeholder:
    'data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAQAAAACCAIAAADwyuo0AAAACXBIWXMAAAAIAAAACQCg8x8WAAAABGNJQ1ABAQABlXPCVgAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAABGdBTUEAAMcyx0lwRAAAACJJREFUeJxjiHPxTPHyz3SWLg/UZDBVVdORlnFVZGiKMwcAVTkGAbHCfgEAAAAASUVORK5CYII=',
},
background: '#5b3c2a',
metadata: {},
created: '2025-06-13T22:28:04.727Z',
updated: '2025-08-16T23:05:14.001Z',
}}
/>

***

### Transformations

* Convert files to more compatible formats
* Compress files to save bandwidth and storage
* Trim audio and video files to create clips
* Resize and crop images and videos to fit your design

***

### Intelligence

* Get descriptions, tags, and titles for images and videos
* Transcribe speech with speaker detection
* Check for explicit or NSFW content
* Or craft your own prompt to ask anything about your media

***

### Tracks

* Generate subtitles for audio and video files
* Generate thumbnail preview tracks for videos
* Add chapter markers and helpful chapter titles

***

## How does it work?

You can start using the APIs in seconds.

Pass a file and a few lines of code -> get a response with your new file.

We provide easy-to-use upload endpoints, or work seamlessly with your existing object store (just pass a public or signed URL from S3, Supabase, Vercel, Cloudflare, *etc*).

***

### Tasks

Get an API key, then a task looks like this:

```typescript
const task = {
  url: 'https://your.storage.bucket/video.mp4',
  kind: 'speech',
  speakers: true,
};

const response = await fetch('https://api.ittybit.com/tasks', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer ITTYBIT_API_KEY' },
  body: JSON.stringify(task)
});
```

***

### Workflows

You can use workflows to run multiple tasks in parallel or connect tasks in a sequence.

For example to describe and resize a video, then create a thumbnail track:

```typescript
const url = 'https://your.storage.bucket/video.mp4';

const workflow = [
  {
    kind: 'description'
  },
  {
    kind: 'video',
    height: 720,
    next: [
      {
        kind: 'thumbnails'
      }
    ]
  }
];

const response = await fetch('https://api.ittybit.com/workflows', {
  method: 'POST',
  headers: { 'Authorization': 'Bearer ITTYBIT_API_KEY' },
  body: JSON.stringify({ url, workflow })
});
```

***

### Automations

You can encapsulate your workflows into automations that run for every new media file.

We listen for events and process them in real-time.

Ittybit handles all the infrastructure as you scale so you can focus on your product's unique value.

***

## Integrations

You can use ittybit alongside your existing tools and services.

* Amazon S3
* Google Cloud Storage
* Supabase Storage
* Cloudflare R2
* *and many more...*

***

## Who is it for?

### Developers

Developers love our carefully-crafted REST API and SDKs for typescript, python, go, ruby, and php.

### AI Agents

Their AI agents can call all our tools as well, especially when paired with our MCP server.

### Serverless Apps

Ittybit is an especially good fit for serverless architectures. Lambdas and edge functions can't handle the heavy-lifting and long-running tasks needed for media processing, so we provide the backend for you.

### Magnificent Monoliths

Video processing can also lock up your server resources, especially when you need concurrent tasks. We help monoliths offload media processing to a dedicated service.

### Customers

Our customers include AI startups, social platforms, media websites, chat apps, large education providers, conference organizers, personalized sales platforms. There's also many more awesome projects using our forever free, and pay-as-you-go plans.