# Справочник API

Все методы REST API IskraGen: параметры, пример вызова, структура ответа и коды ошибок

REST API IskraGen — агрегатор AI-генерации медиа: изображения, видео, голос (TTS), музыка.

## Базовый адрес

`https://api.iskragen.ru` — все пути в справочнике указаны от него.

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

Передавайте ключ в заголовке `Authorization: Bearer <ключ>`, где ключ — API-ключ, выданный в личном кабинете (`isk_live_<prefix>_<secret>`).

Без ключа работают только публичные методы: `GET /health`, `GET /v1/catalog/`. Подробнее — [Authentication](/docs/authentication).

## Как читать справочник

У каждого метода — назначение, требуемая авторизация, параметры, пример вызова `curl` и блок «Структура ответа». Этот блок собран из схемы ответа: он перечисляет поля, типы и ограничения, но не является реальным ответом сервера. У части методов под структурой есть блок «Пример ответа» — типичный ответ сервера с синтетическими значениями. Формат ошибок — [Errors](/docs/errors), лимиты — [Rate limits](/docs/rate-limits).

## Спецификация OpenAPI

Машиночитаемая спецификация OpenAPI 3.1 — [/api/openapi.json](/api/openapi.json). Её можно отдать генератору SDK или агенту.

## Разделы

- [Каталог моделей](/docs/api-katalog-modeley) — Список доступных моделей, их параметры и цены в рублях (1)
- [Генерации](/docs/api-generatsii) — Создание задач генерации и проверка статуса (5)
- [Загрузка файлов](/docs/api-zagruzka-faylov) — Presigned URL для входных файлов (3)
- [Webhooks](/docs/api-webhooks) — Уведомления о завершении задач (4)
- [Оплата и счета](/docs/api-oplata-i-scheta) — Баланс, пополнение, история операций; для юрлиц — реквизиты, счета, PDF и закрывающие акты (5)
- [Аутентификация](/docs/api-autentifikatsiya) — Аккаунт, которому принадлежит API-ключ (1)
- [Статистика](/docs/api-statistika) — Сводка расхода и генераций для личного кабинета (1)
- [Health](/docs/api-health) — Публичная проверка живости API, ключ не нужен (1)