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

# Генерация и редактирование изображений FLUX

> Семейство моделей FLUX от Black Forest Labs — от субсекундной FLUX.2 [klein] до флагманской [max] с 4 МП, с поддержкой генерации изображений по тексту, редактирования по нескольким референсам, типографики и точного управления HEX-цветом. Совместимая с OpenAI замена без доработок.

## Обзор

**FLUX** — флагманская семейство моделей генерации изображений от Black Forest Labs (BFL), базирующейся в Германии. Последнее поколение **FLUX.2** охватывает 5 уровней — от качества за доли секунды до флагманского качества 4MP — а также предыдущее поколение **FLUX.1 Kontext** для редактирования изображений, всего 7 активных моделей. Наследуемые модели FLUX.1 \[pro] также по-прежнему доступны для вызова. Шлюз APIYI оборачивает асинхронный polling API BFL в синхронный OpenAI Images API (`/v1/images/generations` и `/v1/images/edits`), так что вы можете подключить OpenAI SDK, изменив лишь `base_url`.

<Note>
  **🎨 Основные преимущества**: FLUX.2 \[max] уникально поддерживает **grounding search** для получения знаний из веба в реальном времени. Нативный вывод 4MP (2048×2048) + до 8 изображений-референсов + промпты до 32K token + точное управление hex-цветами + лучшая в классе типографика. **Идеально подходит для флагманского качества, согласованности между несколькими изображениями, точной передачи фирменных цветов и профессиональных макетов** в продакшене.
</Note>

<Info>
  Все image API являются **синхронными** — здесь нет task ID для опроса, и если ваш клиент отключится, результат будет потерян, хотя запрос все равно будет тарифицирован. Установите для этой модели щедрый timeout; см. [Основы и лучшие практики Image API](/ru/api-capabilities/image-api-best-practices).
</Info>

<CardGroup cols={2}>
  <Card title="API преобразования текста в изображение" icon="wand-sparkles" href="/ru/api-capabilities/flux/text-to-image">
    `/v1/images/generations`, генерируйте изображения из текстовых prompt во всех 5 моделях FLUX.2.
  </Card>

  <Card title="API редактирования изображений" icon="image" href="/ru/api-capabilities/flux/image-edit">
    Поля JSON `input_image` (до 8 reference для fusion через `/generations`), а также совместимый с OpenAI multipart `/edits` путь для одного изображения. Работает для FLUX.2 + FLUX.1 Kontext.
  </Card>

  <Card title="Исторические версии" icon="history" href="/ru/api-capabilities/flux/historical-versions">
    Спецификации, примечания по миграции и тарификация для FLUX.1 \[pro] / \[pro] 1.1 / \[pro] 1.1 Ultra / \[dev].
  </Card>
</CardGroup>

## Почему стоит выбрать FLUX от APIYI?

Прямая замена официального канала BFL, оптимизированная по **стабильности**, **стоимости** и **удобству интеграции** для production:

<CardGroup cols={2}>
  <Card title="OpenAI-совместимая обёртка · Миграция без кода" icon="shield-check">
    Нативный BFL использует асинхронный опрос, а APIYI оборачивает его в синхронный **OpenAI Images API**. Укажите здесь `base_url` OpenAI SDK — не нужно писать собственный цикл `polling_url`.
  </Card>

  <Card title="Без ограничения на параллельные запросы · Более 24 активных задач" icon="infinity">
    BFL ограничивает каждый аккаунт **24 активными задачами** (`flux-kontext-max` — только 6). APIYI распределяет запросы на уровне шлюза, поэтому корпоративные пользователи масштабируются линейно без ограничения на один аккаунт.
  </Card>

  <Card title="Та же цена или скидка до 17%" icon="percent">
    FLUX.2 \[pro/max/flex] соответствуют официальной цене при 1MP, klein 4B/9B примерно на 28% дешевле, FLUX.1 \[pro] 1.1 Ultra экономит 17%, а суммирование [бонусов за пополнение](/ru/faq/recharge-promotions) дает **до 15% дополнительной скидки**.
  </Card>

  <Card title="Глобальный доступ без лишних сложностей" icon="globe">
    **Не требуется зарубежный сервер или proxy**. Дата-центры материкового Китая, домашние сети и глобальные узлы могут напрямую обращаться к `api.apiyi.com` со стабильной задержкой.
  </Card>

  <Card title="Полная экосистема моделей" icon="layers">
    Сочетайте с [gpt-image-2](/ru/api-capabilities/gpt-image-2/overview), [Seedream](/ru/api-capabilities/seedream-image/overview), [Nano Banana](/ru/api-capabilities/nano-banana-image/overview) и другими на одном и том же шлюзе — комбинируйте под каждый сценарий.
  </Card>

  <Card title="Профессиональный сервис · Корпоративная поддержка" icon="handshake">
    Наша команда обладает глубоким опытом внедрения генерации изображений — от выбора моделей и настройки до поддержки интеграции от PoC до production.
  </Card>
</CardGroup>

## Ключевые возможности

<CardGroup cols={2}>
  <Card title="Полный спектр скорости" icon="bolt">
    klein 4B/9B **меньше секунды** на потребительских GPU, pro **\< 10s**, max **\< 15s**, flex медленнее для более высокой точности. Одна линейка — от работы в реальном времени до флагманского уровня.
  </Card>

  <Card title="Нативный вывод 4MP" icon="expand">
    До 2048×2048 (\~4MP), в 2.5 раза больше, чем предел 1.6MP у FLUX.1. Любое соотношение сторон (размеры должны быть кратны 16), минимум 64×64.
  </Card>

  <Card title="Слияние нескольких референсов" icon="layers">
    Поля JSON `input_image` \~ `input_image_8` содержат несколько референсов (URL или base64 data URL): FLUX.2 \[pro/max/flex] — до **8**, \[klein] — до 4. Ссылайтесь на них в prompt как «image 1 / image 2».
  </Card>

  <Card title="Поисковая привязка" icon="globe">
    Доступно только в FLUX.2 \[max]: prompts могут запускать поиск в web в реальном времени, чтобы воспроизводить «счет вчерашнего матча», «погода в реальном времени», «воссоздание исторического события» и многое другое.
  </Card>
</CardGroup>

<CardGroup cols={2}>
  <Card title="Точный контроль hex-цветов" icon="palette">
    Пишите hex-коды вроде `#02eb3c` / `#ff0088` напрямую в prompt. Модель воспроизводит точные цвета — постобработка не нужна для задач, критичных к бренду.
  </Card>

  <Card title="Длинные промпты на 32K token" icon="type">
    Поддерживает до **32K tokens**, включая структурированные описания JSON (subject / background / lighting / style). Идеально подходит для автоматизации в production.
  </Card>

  <Card title="Оптимизировано для типографики" icon="type">
    FLUX.2 \[flex] создан специально для типографики. Заголовки постеров, макеты UI, инфографика — точность мелкого текста лидирует в индустрии. max / pro тоже хорошо справляются.
  </Card>

  <Card title="OpenAI SDK Drop-in" icon="plug">
    Установите `base_url` в `https://api.apiyi.com/v1` и вызывайте `client.images.generate(model="flux-2-pro", ...)` напрямую — без изменений кода.
  </Card>
</CardGroup>

## Цены

Тарификация за изображение — см. столбец **Цена APIYI**. Официальная тарификация BFL указана за **MP (megapixel)**, с базовой ценой в пределах 1 MP и дополнительной стоимостью за каждый следующий MP. Фиксированная тарификация APIYI за изображение более предсказуема.

### Серия FLUX.2 (последнее поколение)

| ID модели         | Цена APIYI | Официально   | Скорость       | Лучше всего подходит для                                     |
| ----------------- | ---------- | ------------ | -------------- | ------------------------------------------------------------ |
| `flux-2-max`      | \$0.0700   | от \$0.07/MP | \< 15s         | Флагманское качество + grounding search                      |
| `flux-2-pro`      | \$0.0300   | от \$0.03/MP | \< 10s         | Масштабное производство, лучшее соотношение цены и качества  |
| `flux-2-flex`     | \$0.0600   | \$0.06/MP    | Медленнее      | Оптимизировано под типографику, настраиваемые steps/guidance |
| `flux-2-klein-9b` | \$0.0100   | от \$0.015   | Меньше секунды | Сбалансированные качество и скорость                         |
| `flux-2-klein-4b` | \$0.0100   | от \$0.014   | Меньше секунды | Самый быстрый, подходит для consumer-GPU                     |

### Серия FLUX.1 Kontext (специалист по редактированию изображений)

| ID модели          | Цена APIYI | Официально | Экономия | Лучше всего подходит для                                         |
| ------------------ | ---------- | ---------- | -------- | ---------------------------------------------------------------- |
| `flux-kontext-max` | \$0.0700   | \$0.08     | 12.5%    | Наивысшее качество редактирования, тонкая типографика            |
| `flux-kontext-pro` | \$0.0350   | \$0.04     | 12.5%    | Оптимальный выбор по цене для редактирования, генерация за 5–6 с |

### FLUX.1 \[pro] Устаревшая версия (историческая, по-прежнему доступна для вызова)

| ID модели            | Цена APIYI | Официально | Экономия    |
| -------------------- | ---------- | ---------- | ----------- |
| `flux-pro-1.1-ultra` | \$0.0500   | \$0.06     | 17%         |
| `flux-pro-1.1`       | \$0.0350   | \$0.04     | 12.5%       |
| `flux-pro`           | \$0.0400   | \$0.04     | То же самое |
| `flux-dev`           | \$0.0200   | —          | —           |

Подробные спецификации и рекомендации по миграции см. на странице [Исторические версии](/ru/api-capabilities/flux/historical-versions).

<Info>
  **Примечания к тарификации**:

  * APIYI использует фиксированную тарификацию за изображение — стоимость одинакова независимо от MP результата
  * Официальные цены зависят от MP: базовая цена за первый MP плюс дополнительная стоимость за каждый следующий MP
  * Запросы на редактирование стоят столько же, сколько text-to-image (в отличие от OpenAI gpt-image-2, где редактирование тарифицируется через Vision tokens)
  * Открытые веса klein 4B / klein 9B доступны на Hugging Face для self-hosting (Apache 2.0 / FLUX NCL)
  * Неудачные запросы (4xx / moderation blocks) не тарифицируются
</Info>

## Технические характеристики

| Параметр                    | Значение                                                                                                 |
| --------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Рекомендуемые основные**  | `flux-2-pro` / `flux-2-pro-preview` (общее назначение) + `flux-kontext-max` (редактирование типографики) |
| **Скорость**                | менее секунды (klein) / \< 10s (pro) / \< 15s (max) / медленнее (flex)                                   |
| **Разрешение вывода**       | До 4MP (2048×2048), любое соотношение сторон, размеры должны быть кратны 16                              |
| **Разрешение входа**        | Мин. 64×64, макс. 4MP (только эндпоинт редактирования)                                                   |
| **Референсные изображения** | 8 (FLUX.2 \[pro/max/flex]) / 4 (FLUX.2 \[klein]) / 1 (FLUX.1 Kontext)                                    |
| **Длина prompt**            | До 32K tokens                                                                                            |
| **Формат вывода**           | `jpeg` (по умолчанию) / `png`                                                                            |
| **Moderation**              | `safety_tolerance` 0–6 (0 = самый строгий, 6 = самый лояльный, по умолчанию 2)                           |
| **Grounding search**        | Только `flux-2-max`                                                                                      |
| **Поле ответа**             | `data[0].url` (**действительно 10 минут**, скачайте сразу)                                               |
| **Изображений на запрос**   | 1 (`n=1`)                                                                                                |
| **prompt\_upsampling**      | Поддерживается в FLUX.2 \[pro/max/flex], не поддерживается в \[klein]                                    |

## Эндпоинты API

| Эндпоинт                      | Назначение                                                                                                                                                               | Тип содержимого       |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------- |
| `POST /v1/images/generations` | Генерация изображений по тексту + редактирование изображений / слияние нескольких референсов (JSON `input_image` \~ `input_image_8`, **рекомендуется**, все модели FLUX) | `application/json`    |
| `POST /v1/images/edits`       | Совместимое с OpenAI редактирование одного изображения (`client.images.edit()` drop-in; проверено на серии Kontext)                                                      | `multipart/form-data` |

Для слияния нескольких референсов используйте `/generations` (JSON `input_image_N`). Эндпоинт `/edits` принимает только один файл `image` — лучше всего подходит для переноса существующего кода редактирования OpenAI SDK.

<Tip>
  **Варианты домена**: `api.apiyi.com` — основной домен. Альтернативные домены шлюза, такие как `b.apiyi.com` / `vip.apiyi.com`, работают идентично.
</Tip>

## Размер (ширина / высота) в деталях

### Типовые размеры

| Size        | Aspect           | Pixels  | Best For                              |
| ----------- | ---------------- | ------- | ------------------------------------- |
| `1024x1024` | Квадрат 1:1      | \~1MP   | Общие задачи, аватары в соцсетях      |
| `1024x1536` | Портретный 2:3   | \~1.6MP | Постеры, портреты                     |
| `1536x1024` | Альбомный 3:2    | \~1.6MP | Пейзажи, рабочий стол                 |
| `1440x2048` | Портретный \~3:4 | \~2.9MP | Вертикальный кинематографичный формат |
| `1920x1080` | Альбомный 16:9   | \~2MP   | Миниатюры для видео                   |
| `2048x2048` | Квадрат 1:1      | 4MP     | Флагманская печать (лимит FLUX.2)     |

### Ограничения пользовательского размера

FLUX.2 принимает произвольные размеры, если выполняются **все** следующие условия:

1. **ширина / высота должны быть кратны 16**
2. **Минимум 64×64**
3. **Максимум \~4MP** (например, 2048×2048 / 1920×2048 / 2048×1920)
4. **Рекомендуемый итоговый размер ≤ 2MP**, чтобы сбалансировать скорость и стоимость

**Допустимые примеры**: `1280x720`, `1920x1080`, `2048x1024`, `1456x1920`
**Недопустимые примеры**: `1000x1000` (не кратно 16), `3840x2160` (превышает 4MP), `32x32` (ниже 64×64)

<Warning>
  **API: width/height vs OpenAI-compatible size**: BFL нативно использует целые `width` / `height`. APIYI также принимает строку `size: "1024x1024"` в стиле OpenAI. Оба варианта эквивалентны — выберите любой.
</Warning>

## Лучшие практики

<Steps>
  <Step title="Выбирайте модель по сценарию">
    Флагманская финальная версия + нужна информация в реальном времени → `flux-2-max`. Пакетная обработка в production → `flux-2-pro`. Постеры / инфографика с типографикой → `flux-2-flex`. Реальное время с высокой пропускной способностью → `flux-2-klein-9b`. Редактирование изображений → `flux-kontext-max` или `flux-kontext-pro`.
  </Step>

  <Step title="По умолчанию используйте ≤ 2MP">
    Оптимальный баланс скорости и стоимости — 1MP–2MP. К 4MP стоит прибегать только при реальной необходимости (печать, экраны 4K). При высоком разрешении klein заметно увеличивает стоимость каждого вызова.
  </Step>

  <Step title="Указывайте референсные изображения по индексу в prompt">
    Нумерация `input_image` / `input_image_2` / `input_image_3` — это в точности индекс «image 1 / image 2 / image 3» в вашем prompt. Скажите «человек с изображения 1 в сцене изображения 2 с цветовой палитрой изображения 3» — это гораздо надежнее, чем заставлять model угадывать.
  </Step>

  <Step title="Сразу скачивайте URLs результата">
    `data[0].url` **действителен только 10 минут**, размещен на `delivery-eu.bfl.ai` / `delivery-us.bfl.ai`, при отключенном CORS. В production необходимо скачивать их на стороне сервера в свой CDN.
  </Step>

  <Step title="Фиксируйте типографику на flex или max">
    Подписи, постеры, скриншоты UI — отдавайте предпочтение `flux-2-flex` (специалист по типографике) или `flux-2-max` (наивысшее общее качество). Другие модели по-прежнему могут размывать мелкий текст.
  </Step>

  <Step title="Используйте max для grounding-поиска">
    Знания в реальном времени («погода сегодня», «матч прошлой ночи») поддерживаются только на `flux-2-max`. Остальные модели опираются на данные обучения и не могут получать актуальную информацию.
  </Step>

  <Step title="Тайм-аут клиента 60–120s">
    APIYI обрабатывает polling внутри, а pro / max возвращают результат менее чем за 15 s, но с учетом очередей и сетевого jitter установите тайм-аут клиента на 60–120 s. flex может доходить до 180 s.
  </Step>

  <Step title="Фиксируйте seed для воспроизводимости">
    Один и тот же `seed` + одинаковые остальные параметры = стабильные результаты, полезно для A/B-тестов и проверки клиентом. klein не поддерживает `prompt_upsampling`; у pro/max/flex он отключен по умолчанию — включайте при необходимости.
  </Step>
</Steps>

## Коды ошибок и повторные попытки

| Статус  | Значение                                                                                         | Рекомендуемое действие                                                        |
| ------- | ------------------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------- |
| `400`   | Недопустимые параметры (ширина/высота не кратны 16, превышен лимит 4MP, prompt более 32K tokens) | Проверьте соответствие ограничениям по размеру, особенно правилу кратности 16 |
| `401`   | Недопустимый token                                                                               | Проверьте Bearer token                                                        |
| `403`   | Блокировка модерацией                                                                            | Измените prompt или увеличьте `safety_tolerance` (макс. 6)                    |
| `429`   | Превышен лимит запросов / баланс исчерпан / превышено число активных задач                       | Повтор с экспоненциальной задержкой                                           |
| `5xx`   | Ошибка шлюза / backend                                                                           | Повторите 1–2 раза                                                            |
| Timeout | Длинный хвост                                                                                    | Тайм-аут клиента ≥ **60s** (с возможностью увеличения до 180s)                |

<Info>
  **Рекомендуемая конфигурация клиента**:

  * Тайм-аут запроса **60–120s** (с возможностью увеличения до 180s)
  * Экспоненциальная задержка повторов для 5xx и 429 (рекомендуется 2 повтора)
  * Как только получен `data[0].url`, **сразу скачивайте асинхронно** — не ждите клика пользователя
  * Логируйте заголовок ответа `x-request-id` для поддержки
</Info>

## Часто задаваемые вопросы

<AccordionGroup>
  <Accordion title="Почему поле url истекает через 10 минут?">
    BFL хранит результаты на `delivery-eu.bfl.ai` / `delivery-us.bfl.ai` с подписанными URL, действительными 10 минут, **и CORS отключен**. Производственные сервисы должны на стороне сервера загружать их в ваш собственный OSS / CDN. Не передавайте исходный URL в браузеры и не рассчитывайте, что пользователи смогут открыть его позже.

    APIYI наследует тот же механизм URL — поведение совпадает с официальным каналом.
  </Accordion>

  <Accordion title="Официальный API использует асинхронный опрос — как APIYI делает его синхронным?">
    Шлюз APIYI берет опрос на себя: вы отправляете стандартный запрос OpenAI Images API, шлюз внутри отправляет POST в BFL, опрашивает `polling_url` до `Ready`, затем оборачивает итоговый URL `result.sample` как `data[0].url` и возвращает его. С точки зрения клиента это один запрос-ответ — идентично OpenAI / GPT-Image / Nano Banana.
  </Accordion>

  <Accordion title="Сколько референсных изображений я могу отправить? Как писать prompt?">
    * **FLUX.2 \[pro/max/flex]**: до **8**
    * **FLUX.2 \[klein]**: до **4**
    * **FLUX.1 Kontext \[pro/max]**: один референс (для нескольких изображений нужна склейка на стороне клиента)

    Ссылайтесь на них по индексу («изображение 1 / изображение 2 / изображение 3») в prompt, например: «поместите человека из изображения 1 в сцену из изображения 2, применив цветовую палитру изображения 3». Также работают ссылки на естественном языке — модель хорошо понимает входные изображения.
  </Accordion>

  <Accordion title="Что делает prompt_upsampling? Стоит ли его включать?">
    `prompt_upsampling=true` автоматически расширяет и уточняет ваш prompt (особенно полезно для коротких prompt). Но **это меняет исходный замысел** — держите его выключенным для брендовых задач и включенным для свободного эксперимента.

    **Ограничение**: FLUX.2 \[klein] это не поддерживает (если передать, будет молча проигнорировано).
  </Accordion>

  <Accordion title="Как использовать grounding search?">
    Это поддерживает только `flux-2-max`. **Никаких специальных параметров не нужно** — если вашему prompt нужны знания в реальном времени, модель автоматически выполнит поиск в сети перед генерацией. Пример:

    > «Сгенерируйте новостное фото снежной бури, накрывшей Нью-Йорк 15 декабря 2025 года»

    Отлично подходит для «счета вчерашнего матча», «погоды в реальном времени», «воссоздания исторического события», «последних трендов». Prompt без чувствительного ко времени контента не запустит поиск и будет тарифицироваться как обычная генерация.
  </Accordion>

  <Accordion title="Как эффективнее всего использовать hex-цвета?">
    Пишите hex-коды напрямую в prompt с явными маркерами «color» или «hex»:

    ```
    A vase on a table, the color of the vase is gradient from #02eb3c to #edfa3c, the flowers have color #ff0088
    ```

    Или для брендовых задач с несколькими цветами:

    ```
    Luxury eyeshadow palette with 6 pans: top row #B76E79, #E8D5B7, #8B4789; bottom row #CD7F32, #F8F6F0, #800020
    ```

    Точность на уровне лидеров отрасли — постобработка и коррекция цвета не нужны.
  </Accordion>

  <Accordion title="Что такое структурированный JSON prompting?">
    FLUX.2 поддерживает prompt в формате JSON:

    ```json theme={null}
    {
      "subject": "Mona Lisa painting by Leonardo da Vinci",
      "background": "museum gallery wall, ornate gold frame",
      "lighting": "soft gallery lighting",
      "style": "digital art, high contrast",
      "camera_angle": "eye level view",
      "composition": "centered, portrait orientation"
    }
    ```

    Передавайте JSON-строку в поле `prompt`. Идеально для производственной автоматизации и пакетной генерации по шаблону.
  </Accordion>

  <Accordion title="Какой endpoint мне использовать для редактирования изображений?">
    Два варианта:

    * **Вариант A (рекомендуется)**: JSON + `input_image` (\~ `input_image_8`) в `/v1/images/generations` — работает для всех моделей FLUX и поддерживает слияние нескольких референсов
    * **Вариант B**: `multipart/form-data` в `/v1/images/edits` — имя поля файла должно быть `image` (одно изображение), напрямую совместимо с `client.images.edit()` OpenAI SDK, проверено на серии Kontext

    См. [API редактирования изображений](/ru/api-capabilities/flux/image-edit) для параметров и примеров.

    **Примечание**: FLUX.1 Kontext нативно поддерживает только один референс; FLUX.2 поддерживает до 8 референсов (через Вариант A).
  </Accordion>

  <Accordion title="Могу ли я напрямую использовать официальный SDK OpenAI?">
    Да, без изменения кода. Установите `base_url` в `https://api.apiyi.com/v1`:

    ```python theme={null}
    from openai import OpenAI
    client = OpenAI(api_key="sk-your-key", base_url="https://api.apiyi.com/v1")
    resp = client.images.generate(
        model="flux-2-pro",
        prompt="...",
        size="1024x1024"
    )
    ```

    То же самое для пакета Node.js `openai`. Все модели FLUX используют формат ответа OpenAI Images API с `data[0].url`.
  </Accordion>

  <Accordion title="Могу ли я отменить выполняющуюся задачу?">
    **Не поддерживается**. Если клиент отключится, сервер все равно завершит генерацию и тарифицирует ее как обычно. Задавайте таймауты на стороне клиента и не полагайтесь на «отключение = нет тарификации».
  </Accordion>

  <Accordion title="Каковы лимиты запросов и ограничения на параллельные запросы?">
    BFL ограничивает каждый аккаунт **24 активными задачами**, а `flux-kontext-max` отдельно ограничивает до **6**.

    APIYI агрегирует нагрузку на шлюзе, поэтому корпоративные параллельные запросы не ограничены потолком на уровне аккаунта. Для явных обязательств по SLA / RPM свяжитесь с нашей командой, чтобы получить выделенную квоту.
  </Accordion>

  <Accordion title="Работают ли callback через webhook?">
    BFL нативно поддерживает `webhook_url` + `webhook_secret`, но обертка APIYI, совместимая с OpenAI, ожидает синхронно и **не передает поля webhook** — вам не нужно опрашивать систему, цикл запрос-ответ выполняется за один раз. Если вашему бизнесу действительно нужны webhook, свяжитесь с нами, чтобы включить нативный асинхронный канал.
  </Accordion>

  <Accordion title="Тарифицируются ли неудачные запросы?">
    **Нет**. `400` (ошибка параметра), `403` (блокировка модерацией), `429` (превышен лимит запросов) все возвращают ошибки и не тарифицируются. **Тарифицируются только запросы, которые фактически вошли в генерацию (200 + `data[0].url`)**.
  </Accordion>
</AccordionGroup>

## Похожие документы

* [Песочница Text-to-Image](/ru/api-capabilities/flux/text-to-image) — интерактивный отладчик `/v1/images/generations`
* [Песочница редактирования изображений](/ru/api-capabilities/flux/image-edit) — слияние нескольких референсов + редактирование
* [Исторические версии и миграция](/ru/api-capabilities/flux/historical-versions) — FLUX.1 \[pro] / \[pro] 1.1 / Ultra / \[dev]
* [Руководство по API](/ru/api-manual) — общая спецификация использования
* [Обзор GPT-Image-2](/ru/api-capabilities/gpt-image-2/overview) — флагман OpenAI, поддерживает 4K
* [Обзор Seedream](/ru/api-capabilities/seedream-image/overview) — партнерский канал BytePlus

<Info>
  FLUX — это собственная семейство моделей BFL, которое лидирует в отрасли по точности hex color, fidelity typography и пониманию длинных prompt. Если для вас важна совместимость с экосистемой OpenAI, см. [GPT-Image-2](/ru/api-capabilities/gpt-image-2/overview); для сценариев на китайском языке см. [Seedream](/ru/api-capabilities/seedream-image/overview).
</Info>