<!-- /docs (ru) -->

# Начало работы с FrankLab API

FrankLab API — программный интерфейс платформы генерации контента. Один партнёрский API-ключ открывает генерацию (видео, изображения, аудио, текст) и все операции биллинга: баланс, транзакции, тарифы, оценку стоимости и выписки.

## Базовый URL

```
https://apergrex.ru/franklab/api
```

Тот же API доступен на `https://franklab.ru/franklab/api`.

## Получите API-ключ

1. Войдите в кабинет apergrex.ru и откройте **Настройки → API**.
2. Нажмите «Создать ключ» — получите значение вида `fl_live_…`.
3. Ключ показывается **один раз** — сохраните его сразу. Храните как пароль: ключ даёт доступ к балансу и операциям партнёра.

Список ключей доступен и программно (`GET /v1/billing/api-keys`, см. [Справочник API → api-keys](/docs/reference)); выпуск и отзыв ключей — только из сессии кабинета, чтобы сам ключ не мог плодить новые.

## Первый запрос

Проверьте баланс:

```bash
curl -H "X-API-Key: $FRANKLAB_KEY" \
  https://apergrex.ru/franklab/api/v1/billing/balance
```

Ответ:

```json
{
  "available": 413.5,
  "total": 500,
  "used": 86.5,
  "reserved": 0,
  "isLow": false,
  "updatedAt": "2026-09-04T12:00:00.000Z"
}
```

## Стоимость до запуска

Прежде чем запускать генерацию, запросите точную квоту по своему тарифу:

```bash
curl -X POST -H "X-API-Key: $FRANKLAB_KEY" -H "Content-Type: application/json" \
  -d '{"modelId":"mars-v1-5","duration":5,"resolution":"720p"}' \
  https://apergrex.ru/franklab/api/v1/billing/pricing/estimate
```

Оценка не списывает средства и не запускает задачи.

## Дальше

- [Аутентификация](/docs/authentication) — ключи, заголовки, лимиты
- [Биллинг](/docs/billing) — баланс, резервы, транзакции, тарифы
- [Справочник API](/docs/reference) — все эндпоинты
- [Цены](/docs/pricing) — базовый прайс-лист