API Reference
Base URL: https://api.ittybit.com
Process video, audio, and images via HTTP. Create jobs for full pipelines, or compose individual tasks for custom workflows. For local processing, see the CLI.
Authentication
Authorization: Bearer ittybit_live_...All requests require an API key. Requests without a valid key return 401.
Endpoints
| Method | Path | Description |
|---|---|---|
POST | /jobs | Create a processing job |
GET | /jobs | List jobs |
GET | /jobs/{id} | Get job with tasks |
POST | /tasks | Create a standalone task |
Responses
Success returns the resource directly. Errors return kind + message:
{ "kind": "invalid_input", "message": "input must use http://, https://, or s3:// scheme" }Pagination
List endpoints like GET /jobs support cursor-based pagination.
| Param | Description |
|---|---|
limit | 1–100 (default 20) |
after | Return items after this ID |
before | Return items before this ID |
order | asc or desc (default desc) |
Idempotency
POST endpoints accept Idempotency-Key header. Same key within 24h returns the original response with 200. Useful for safely retrying requests without creating duplicate jobs.
Timestamps
All timestamps are Unix milliseconds (integers).
See also
- CLI Reference — process files locally with the same options
- Convert uploads for web playback
- Extract thumbnails from video
- Extract audio from video