Справочник API

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

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

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

Авторизация

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

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

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

У каждого метода — назначение, требуемая авторизация, параметры, пример вызова curl и блок «Структура ответа». Этот блок собран из схемы ответа: он перечисляет поля, типы и ограничения, но не является реальным ответом сервера. Формат ошибок — Errors, лимиты — Rate limits.

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

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

Разделы

• Каталог моделей — Список доступных моделей, их параметры и цены в рублях (1)
• Генерации — Создание задач генерации и проверка статуса (5)
• Загрузка файлов — Presigned URL для входных файлов (3)
• Webhooks — Уведомления о завершении задач (4)
• Оплата и счета — Баланс, пополнение, история операций; для юрлиц — реквизиты, счета, PDF и закрывающие акты (5)
• Аутентификация — Аккаунт, которому принадлежит API-ключ (1)
• Статистика — Сводка расхода и генераций для личного кабинета (1)
• Health — Публичная проверка живости API, ключ не нужен (1)