# Ключ, которым сделан запрос

`GET https://api.souz.ai/v1/key`

Сам ключ: его потолок трат (`spend_limit`), как потолок обновляется
(`spend_limit_reset`) и сколько потрачено (`spent`), пресет роутинга и потолок цены по
умолчанию и сроки хранения — то, что агенту полезно знать до первого запроса. Баланс и история аккаунта —
`GET /v1/balance` и `GET /v1/balance/history` ключом управления (тег `account`); не
хватает баланса или исчерпан лимит — запрос получит `402`. Ключи создаются и
настраиваются в кабинете или ключом управления.

## Авторизация

- `BearerAuth`: API-ключ из кабинета souz.ai — запускает модели. Ключ управления здесь не подходит: `403 forbidden` с `detail[].reason: requires_api_key`.

## Пример запроса

```bash
curl -X GET 'https://api.souz.ai/v1/key' \
  -H "Authorization: Bearer $SOUZ_API_KEY"
```

```python
import os
import requests

response = requests.get(
    "https://api.souz.ai/v1/key",
    headers={"Authorization": f"Bearer {os.environ['SOUZ_API_KEY']}"},
)
print(response.json())
```

```ts
const response = await fetch("https://api.souz.ai/v1/key", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.SOUZ_API_KEY}` },
});
console.log(await response.json());
```

## Ответы

### 200

Ключ.

- `application/json`, схема `APIKey`

### 401

Нет ключа или ключ недействителен.

- `application/json`, схема `Error`

### 429

Слишком часто — повторите через `Retry-After` секунд. Запуск моделей, задачи и файлы результатов частотой не ограничены (их ограничивают баланс и лимиты трат); здесь 429 — на поток запросов с ключом, который сервер не знает, с одного адреса, и на потоки сверх 1000 одновременных на аккаунт (события задачи, чат с `stream: true`). Пределы — раздел «Лимиты» руководства.

- `application/json`, схема `Error`

---

Оглавление документации: https://souz.ai/llms.txt. Всё руководство одним файлом: https://souz.ai/llms-full.txt. Справочник методов: https://souz.ai/docs/api-reference.md.