Quickstart

В этом руководстве вы создадите API-ключ, проверите баланс в личном кабинете и сделаете первый запрос на генерацию изображения.

1. Создайте API-ключ

Перейдите в раздел Личный кабинет → API-ключи (/api-keys) и нажмите «Создать ключ». Скопируйте значение — оно показывается один раз. Ключ имеет формат:

isk_live_<prefix>_<secret>

Все запросы к API авторизуются заголовком:

Authorization: Bearer isk_live_<prefix>_<secret>

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

Текущий баланс отображается в шапке личного кабинета и на странице Оплата (/billing). Пополнение баланса доступно только в личном кабинете — через API оплата не производится.

3. Сделайте первый запрос

Сгенерируем картинку моделью GPT Image 2 (6 ₽ за изображение 1K). Размер задаётся через params.aspect_ratio + params.resolution — см. Generations API.

curl -X POST https://api.iskragen.ru/v1/generations \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "modelSlug": "gpt-image-2-text-to-image",
    "prompt": "Кот-космонавт на фоне Сатурна, фотореализм",
    "params": { "aspect_ratio": "1:1", "resolution": "1K" }
  }'

Ответ (HTTP 202):

{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "PENDING",
  "costRub": 6
}

4. Дождитесь результата

Опросите статус задачи:

curl https://api.iskragen.ru/v1/generations/0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90 \
  -H "Authorization: Bearer $ISKRAGEN_API_KEY"

Когда status станет SUCCEEDED, в outputUrls будет ссылка на S3:

{
  "id": "0192f0c4-8a1e-7b3d-9f21-2c5e6a4b7d90",
  "status": "SUCCEEDED",
  "outputUrls": ["https://s3.twcstorage.ru/.../image.webp"],
  "costRub": 6,
  "finishedAt": "2026-07-01T12:00:42Z"
}

Подсказка: для длинных задач (видео 30+ сек, музыка) лучше использовать webhooks или WebSocket вместо polling.

Что дальше

• Authentication — как устроены API-ключи и сессии.
• Errors — формат ошибок и коды.
• Interactive API Reference — все endpoint'ы с примерами и тестированием в браузере.
• Models — каталог моделей с ценами и параметрами.