# Quickstart

Сделайте первую генерацию через API за 5 минут

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

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

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

```
isk_live_<prefix>_<secret>
```

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

```
Authorization: Bearer isk_live_<prefix>_<secret>
```

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

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

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

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

```bash
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):

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

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

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

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

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

```json
{
  "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](/docs/webhooks) или WebSocket вместо polling.

## Что дальше

- **[Authentication](/docs/authentication)** — как устроены API-ключи и сессии.
- **[Errors](/docs/errors)** — формат ошибок и коды.
- **[Interactive API Reference](/reference)** — все endpoint'ы с примерами и тестированием в браузере.
- **[Models](/models)** — каталог моделей с ценами и параметрами.