# Старт

> Первый запрос к API CyHUB.

## <a id="begin"></a>С чего начать

Один ключ открывает все модели CyHUB, доступные через API. Выберите модель, отправьте задачу и заберите результат: те же модели и цены, что у ботов.

1. [Создайте ключ](https://cyhub.ai/cabinet/keys): В кабинете, после подтверждения почты.
2. [Выберите модель](https://api.cyhub.ai/models): Параметры и примеры на странице модели.
3. [Отправьте задачу](https://api.cyhub.ai/docs/generations.md?lang=ru): Модель и её настройки в POST /v1/tasks.
4. [Заберите результат](https://api.cyhub.ai/docs/tasks.md?lang=ru): Статус задачи и файлы, они хранятся 7 дней.

## <a id="first-request"></a>Первый запрос

Замените YOUR_API_KEY своим ключом. Запрос проверяет ключ и показывает баланс, генерацию не запускает.

```bash
curl "https://api.cyhub.ai/v1/me" \
  -H "Authorization: Bearer YOUR_API_KEY"
```

```python
import requests

API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}

response = requests.get(f"{API}/me", headers=HEADERS, timeout=30)
response.raise_for_status()
me = response.json()
for wallet in me["wallets"]:
    print(wallet["currency"], wallet["available_minor"])
```

В ответе wallets: доступная новым задачам сумма в available_minor, для RUB в копейках.

## <a id="next"></a>Дальше

Общие разделы описывают подключение, запуск, задачи, файлы и ошибки. У каждой модели своя страница с параметрами, правилами файлов и примером запроса. Формальное описание (OpenAPI) и консоль для запросов: /v1/docs.

Для ИИ-агентов: оглавление документации лежит в /llms.txt, а у каждой страницы есть версия в Markdown, достаточно добавить .md к адресу. Схемы всех моделей одним запросом отдаёт GET /v1/models/schemas.

[Настроить подключение](https://api.cyhub.ai/docs/connection.md?lang=ru)