API reference
Eight endpoints. Every request and response uses the shared envelope, and every path below is relative to https://api.ottocut.com.
| Method | Path | Purpose |
|---|---|---|
| POST | /media/upload-url | Create a media record and return a signed URL to upload the file to. |
| POST | /media/{media_id}/finalize | Confirm the upload landed and start the processing pipeline. Idempotent. |
| POST | /media | Submit a source URL for the API to download and process. |
| GET | /media/{media_id} | Poll processing status. Returns the full transcript word list once ready. |
| POST | /clips | Create a clip from start and end markers. Identical requests return the cached clip. |
| GET | /clips/{clip_id} | Fetch an existing clip and refresh its signed download URL. |
| GET | /health | Liveness check. |
| GET | / | Service name, version and environment. |
Authentication
Accounts and API keys ship with v1, so there is nothing to authenticate with yet. Join theearly-access list and we will send you a key when there are keys to send.
Errors
A failed request returns the same envelope with data null and errorpopulated. A start marker that resolves later than the end marker is a 400; a phrase the transcript does not contain is a 404 against that marker.