> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aircaps.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Overview

> Base URL, authentication and conventions.

* **Base URL:** `https://api.aircaps.com/v1`
* **Auth:** `Authorization: Bearer aircaps_sk_...` on every request ([API keys](/authentication))
* **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](/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](/api-reference/objects/transcript), [Utterance](/api-reference/objects/utterance), [Word](/api-reference/objects/word), [File](/api-reference/objects/file), [Error](/api-reference/objects/error), [Webhook event](/api-reference/objects/webhook-event).

The full OpenAPI 3.1 spec is at [`/openapi.json`](/openapi.json).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.