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

# API reference

> Base URL, authentication, and conventions.

The Askr API is OpenAI-compatible and organised around REST. All requests use
JSON and require authentication.

## Base URL

```
https://api.heyaskr.ai
```

## Authentication

Send your API key as a Bearer token:

```
Authorization: Bearer ASKR_API_KEY
```

## Endpoints at a glance

| Endpoint                                                 | Purpose                           |
| -------------------------------------------------------- | --------------------------------- |
| `POST /chat/completions`                                 | Text & chat (streaming supported) |
| `GET /v1/models`                                         | List models and prices            |
| `POST /v1/images/generations`                            | Generate images                   |
| `POST /v1/videos` · `GET /v1/videos/{id}`                | Generate video (async)            |
| `POST /accounts/create`                                  | Create an account                 |
| `POST /credits/balance`                                  | Read balance                      |
| `POST /topup/create/{method}` · `GET /topup/status/{id}` | Crypto top-ups                    |
| `GET /queries/history`                                   | Itemised usage                    |

## Conventions

* All request and response bodies are JSON.
* Money values are in USD.
* Timestamps are ISO 8601 (UTC).