> ## Documentation Index
> Fetch the complete documentation index at: https://docs.elumenta.ru/llms.txt
> Use this file to discover all available pages before exploring further.

# Генерация изображений

> DALL-E 3, MidJourney, Flux 1.1 Pro, SD 3.5 — руководство с примерами

## Базовый запрос

```bash theme={null}
curl -X POST https://elumenta.ru/api/v2/generate \
  -H "Authorization: Bearer nb_ВАШ_КЛЮЧ" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dall-e-3",
    "prompt": "Минималистичный логотип для AI-стартапа, фиолетовый градиент",
    "params": {"size": "1024x1024", "format": "webp"}
  }'
```

## Модели и стоимость

| Модель             | Лучший для                   | Токенов |
| ------------------ | ---------------------------- | ------- |
| `photon-flash`     | Быстрая генерация            | 1       |
| `dall-e-3`         | Точное следование промпту    | 5–13    |
| `flux-1.1-pro`     | Фотореализм, портреты        | 7       |
| `flux-kontext-pro` | Редактирование изображений   | 7       |
| `midjourney-v6`    | Художественный стиль (Fast)  | 14      |
| `midjourney-turbo` | Художественный стиль (Turbo) | 28      |
| `gpt-image-1.5`    | Высококачественная генерация | 1–21    |
| `sd-3.5-large`     | Разнообразные стили          | 12      |
| `recraft-v3`       | Иллюстрации, SVG             | 7       |
| `photon-1`         | Luma Photon                  | 3       |
| `nano-banana-pro`  | Google Imagen 3.0            | 16–32   |

## Параметры

| Параметр          | Описание                                    |
| ----------------- | ------------------------------------------- |
| `size`            | `1024x1024`, `1024x1792`, `1792x1024` и др. |
| `format`          | `webp` (по умолчанию), `png`, `jpeg`        |
| `quality`         | `standard` / `hd` (DALL-E 3, GPT Image)     |
| `negative_prompt` | Что исключить (Flux, SD)                    |
| `seed`            | Воспроизводимость результата                |
| `aspect_ratio`    | `16:9`, `9:16`, `4:3` (MidJourney)          |
| `resolution`      | `1K`, `2K`, `4K` (Nano Banana Pro)          |
| `input_images`    | Референсные изображения (до 14 шт.)         |

<Warning>
  DALL-E 3 и GPT Image 1.5 берут до 2× токенов за нестандартные соотношения сторон. Используйте `/api/v2/models/{slug}/calculate-price` для проверки стоимости.
</Warning>

## Пример с MidJourney

```json theme={null}
{
  "model": "midjourney-v6",
  "prompt": "Кибернетический самурай в неоновом городе, арт в стиле аниме, кинематографичное освещение",
  "params": {
    "aspect_ratio": "16:9",
    "stylize": 750
  }
}
```

## Обработка ошибок

Если генерация завершается с ошибкой, ответ содержит:

```json theme={null}
{
  "status": "failed",
  "error": "Текст ошибки"
}
```

В веб-интерфейсе различные типы ошибок отображаются с соответствующими сообщениями:

* **Перегрузка модели** — «Модель временно перегружена. Попробуйте через пару минут или выберите другую модель.»
* **Тайм-аут** — «Генерация заняла слишком много времени. Попробуйте ещё раз.»
* **Модерация** — «Запрос отклонён модерацией. Измените описание.»

Сообщения об ошибках отображаются в течение 6 секунд.