> ## Documentation Index
> Fetch the complete documentation index at: https://aircaps.ai/docs/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](https://aircaps.ai/docs/authentication.md))
* **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](https://aircaps.ai/docs/errors.md)).
* **Idempotency:** send `Idempotency-Key` with `POST /v1/transcripts` to make retries safe.
* **Language:** English only today: `language_code` (batch) takes `en` or a regional English code such as `en-US`, `en-GB` or `en-IN`, and `language` (streaming) takes `en`. 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](https://aircaps.ai/docs/api-reference/objects/transcript.md), [Utterance](https://aircaps.ai/docs/api-reference/objects/utterance.md), [Word](https://aircaps.ai/docs/api-reference/objects/word.md), [File](https://aircaps.ai/docs/api-reference/objects/file.md), [Error](https://aircaps.ai/docs/api-reference/objects/error.md), [Webhook event](https://aircaps.ai/docs/api-reference/objects/webhook-event.md).

The full OpenAPI 3.1 spec is at [`/openapi.json`](https://aircaps.ai/docs/openapi.json).


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