Overview

Base URL: https://api.aircaps.com/v1
Auth: Authorization: Bearer aircaps_sk_... on every request (API keys)
Format: JSON request and response bodies; timestamps are RFC 3339 UTC; audio times are seconds.
IDs: tr_... transcripts, file_... uploads, req_... request IDs (also in the x-request-id header).
Errors: one envelope for all errors (Errors).
Idempotency: send Idempotency-Key with POST /v1/transcripts to make retries safe.
Language: English only today: language_code (batch) and language (streaming) accept en and regional variants (en-US, en-GB, …); anything else returns unsupported_language. Multilingual support is planned.
Pagination: list endpoints return has_more and next_before; pass it as before for the next page.

Endpoint	Purpose
`POST /v1/transcripts`	Create a transcript
`GET /v1/transcripts/{id}`	Get status and result
`GET /v1/transcripts`	List transcripts
`DELETE /v1/transcripts/{id}`	Cancel or delete
`GET /v1/transcripts/{id}/subtitles`	SRT or VTT captions
`POST /v1/files/upload-url`	Presigned upload (≤ 5 GB)
`POST /v1/files`	Direct upload (≤ 1 GB)
`WSS /v1/realtime`	Live streaming
`GET /v1/models`	Available models
`GET /v1/account`	Account and limits
`GET /v1/usage`	Daily usage

Objects: Transcript, Utterance, Word, File, Error, Webhook event. The full OpenAPI 3.1 spec is at /openapi.json.