API Reference
Base URL: https://api.ittybit.com
Process video, audio, and images via HTTP. Create tasks for full pipelines, or compose individual steps 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 | /tasks | Create a processing task |
GET | /tasks | List tasks |
GET | /tasks/{id} | Get task with steps |
POST | /steps | Create a standalone step |
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 /tasks 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 tasks.
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