---
read_when:
    - Вы хотите использовать генерацию изображений fal в OpenClaw
    - Вам нужен процесс аутентификации с `FAL_KEY`
    - Вам нужны настройки fal по умолчанию для image_generate, video_generate или music_generate
summary: Настройка генерации изображений, видео и музыки с помощью fal в OpenClaw
title: Fal
x-i18n:
    generated_at: "2026-07-13T18:29:34Z"
    model: gpt-5.6
    postprocess_version: locale-links-v1
    prompt_version: 24
    provider: openai
    source_hash: 9bd868aaf6771f6fa38bb8e2a83133460d150e2a5aa9e5b888e221c07f29e0ad
    source_path: providers/fal.md
    workflow: 16
---

OpenClaw поставляется со встроенным провайдером `fal` для размещённой генерации изображений, видео и музыки.

| Свойство | Значение                                                                           |
| -------- | ------------------------------------------------------------------------------- |
| Провайдер | `fal`                                                                           |
| Аутентификация     | `FAL_KEY` (основной вариант; `FAL_API_KEY` также используется как резервный)                   |
| API      | Конечные точки моделей fal (`https://fal.run`; для заданий генерации видео используется `https://queue.fal.run`) |
| Базовый URL | Переопределяется с помощью `models.providers.fal.baseUrl`                                    |

## Начало работы

<Steps>
  <Step title="Задайте ключ API">
    ```bash
    openclaw onboard --auth-choice fal-api-key
    ```

    При неинтерактивной настройке можно передать `--fal-api-key <key>` или экспортировать `FAL_KEY`.
    Процесс первоначальной настройки также задаёт `fal/fal-ai/flux/dev` как модель изображений по умолчанию, если
    модель не настроена.

  </Step>
  <Step title="Задайте модель изображений по умолчанию">
    ```json5
    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    ```
  </Step>
</Steps>

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

Встроенный провайдер генерации изображений `fal` по умолчанию использует
`fal/fal-ai/flux/dev`.

| Возможность     | Значение                                                              |
| -------------- | ------------------------------------------------------------------ |
| Максимум изображений     | 4 на запрос; Krea 2: 1 на запрос                               |
| Переопределения размера | `1024x1024`, `1024x1536`, `1536x1024`, `1024x1792`, `1792x1024`    |
| Соотношение сторон   | Поддерживается везде, кроме преобразования изображения в изображение в Flux                    |
| Разрешение     | `1K`, `2K`, `4K` (ограничения отдельных моделей приведены ниже)                          |
| Формат вывода  | `png` (по умолчанию) или `jpeg`; Krea 2 отклоняет переопределения `outputFormat` |

Запросы на редактирование (эталонные изображения передаются через общие параметры `image` / `images`)
направляются в отдельную конечную точку редактирования для каждой модели с соответствующими ограничениями на число эталонных изображений:

| Семейство моделей              | Ссылка на модель после `fal/`                 | Конечная точка редактирования     | Максимум эталонных изображений |
| ------------------------- | -------------------------------------- | ----------------- | -------------------- |
| Flux и другие модели fal | `fal-ai/flux/dev` (по умолчанию)            | `/image-to-image` | 1                    |
| GPT Image                 | `openai/gpt-image-*`                   | `/edit`           | 10                   |
| Grok Imagine              | `xai/grok-imagine-image`               | `/edit`           | 3                    |
| Nano Banana (устаревшая версия)      | `fal-ai/nano-banana`                   | `/edit`           | 3                    |
| Nano Banana 2             | `fal-ai/nano-banana-*`                 | `/edit`           | 14                   |
| Nano Banana 2 Lite        | `google/nano-banana-2-lite`            | `/edit`           | 14                   |
| Krea 2                    | `krea/v2/{medium,large}/text-to-image` | отсутствует (эталоны стиля) | 10 эталонов стиля  |

<Warning>
Запросы Flux на преобразование изображения в изображение **не** поддерживают переопределения `aspectRatio`. Запросы
GPT Image и Nano Banana 2 на редактирование используют конечную точку fal `/edit` и принимают
указания соотношения сторон. Nano Banana 2 также поддерживает дополнительные нестандартные широкие и высокие соотношения,
такие как `4:1`, `1:4`, `8:1` и `1:8`; Krea 2 проверяет собственное, более узкое
подмножество соотношений сторон. У Grok Imagine есть собственный список соотношений (включая `2:1`,
`20:9`, `19.5:9` и обратные им), и он принимает только разрешения `1K`/`2K`;
устаревшая версия Nano Banana и Nano Banana 2 Lite отклоняют переопределения `resolution`.
</Warning>

Модели Krea 2 используют собственную схему полезной нагрузки Krea в fal. OpenClaw отправляет
`aspect_ratio`, `creativity` и `image_style_references` вместо
универсальной полезной нагрузки `image_size` / конечной точки редактирования, используемой Flux. Ссылки на модели:

- `fal/krea/v2/medium/text-to-image`
- `fal/krea/v2/large/text-to-image`

Используйте Medium для более быстрой генерации выразительных иллюстраций, аниме, живописи и художественных
стилей. Используйте Large для более медленной генерации фотореалистичных изображений, естественных текстур, плёночной зернистости и детализированного
внешнего вида. По умолчанию Krea использует `fal.creativity: "medium"`; поддерживаемые значения:
`raw`, `low`, `medium` и `high`.

В схеме запроса fal Krea 2 предоставляет соотношение сторон, а не `image_size`. Предпочтительно использовать
`aspectRatio`; OpenClaw сопоставляет `size` с ближайшим поддерживаемым соотношением сторон Krea
и отклоняет `resolution` для Krea, а не игнорирует его.

Используйте `outputFormat: "png"`, если нужен вывод PNG из моделей fal, предоставляющих
`output_format`. fal не объявляет в OpenClaw явный параметр управления прозрачным фоном,
поэтому `background: "transparent"` указывается как проигнорированное
переопределение для моделей fal.
Конечные точки Krea 2 не предоставляют поле запроса `output_format` через fal, поэтому
OpenClaw отклоняет переопределения `outputFormat` для запросов Krea.

Чтобы использовать Krea 2 Medium:

```json5
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}
```

## Генерация видео

Встроенный провайдер генерации видео `fal` по умолчанию использует
`fal/fal-ai/minimax/video-01-live`.

| Возможность | Значение                                                              |
| ---------- | ------------------------------------------------------------------ |
| Режимы      | Преобразование текста в видео, одно эталонное изображение, преобразование эталонов в видео в Seedance |
| Выполнение    | Поддерживаемая очередью последовательность отправки, проверки состояния и получения результата для длительных заданий       |
| Время ожидания    | По умолчанию 20 минут на задание; состояние опрашивается каждые 5 секунд       |

<AccordionGroup>
  <Accordion title="Доступные модели видео">
    **MiniMax (по умолчанию):**

    - `fal/fal-ai/minimax/video-01-live`

    **Видеoагент HeyGen:**

    - `fal/fal-ai/heygen/v2/video-agent`

    **Kling и Wan:**

    - `fal/fal-ai/kling-video/v2.1/master/text-to-video`
    - `fal/fal-ai/wan/v2.2-a14b/text-to-video`
    - `fal/fal-ai/wan/v2.2-a14b/image-to-video`

    **Seedance 2.0:**

    - `fal/bytedance/seedance-2.0/fast/text-to-video`
    - `fal/bytedance/seedance-2.0/fast/image-to-video`
    - `fal/bytedance/seedance-2.0/fast/reference-to-video`
    - `fal/bytedance/seedance-2.0/text-to-video`
    - `fal/bytedance/seedance-2.0/image-to-video`
    - `fal/bytedance/seedance-2.0/reference-to-video`

    Запросы MiniMax Live и HeyGen отправляют только подсказку и необязательное
    единственное эталонное изображение; другие переопределения не передаются. Модели Seedance
    принимают `aspectRatio`, `size`, `resolution`, длительность от 4 до 15 секунд и
    переключатель звука.

  </Accordion>

  <Accordion title="Пример конфигурации Seedance 2.0">
    ```json5
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
          },
        },
      },
    }
    ```
  </Accordion>

  <Accordion title="Пример конфигурации преобразования эталонов в видео в Seedance 2.0">
    ```json5
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
          },
        },
      },
    }
    ```

    Преобразование эталонов в видео принимает до 9 изображений, 3 видео и 3 звуковых эталонов
    через общие параметры `video_generate` `images`, `videos` и `audioRefs`,
    при этом общее число эталонных файлов не должно превышать 12. Для звуковых эталонов
    в том же запросе требуется как минимум один эталон изображения или видео.

  </Accordion>

  <Accordion title="Пример конфигурации видеоагента HeyGen">
    ```json5
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/fal-ai/heygen/v2/video-agent",
          },
        },
      },
    }
    ```
  </Accordion>
</AccordionGroup>

## Генерация музыки

Встроенный плагин `fal` также регистрирует провайдер генерации музыки для
общего инструмента `music_generate`.

| Возможность    | Значение                                                                                                                    |
| ------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Модель по умолчанию | `fal/fal-ai/minimax-music/v2.6`                                                                                          |
| Модели        | `fal-ai/minimax-music/v2.6` (mp3), `fal-ai/ace-step/prompt-to-audio` (wav), `fal-ai/stable-audio-25/text-to-audio` (wav) |
| Максимальная длительность  | 240 секунд                                                                                                              |
| Выполнение       | Синхронный запрос с последующей загрузкой сгенерированного аудио                                                                        |

Чтобы использовать fal как провайдер музыки по умолчанию:

```json5
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}
```

`fal-ai/minimax-music/v2.6` поддерживает явное указание текста песни и инструментальный режим,
но не одновременно в одном запросе. ACE-Step и Stable Audio — это конечные точки
преобразования подсказки в аудио; выберите их с помощью переопределения `model`, если нужны
эти семейства моделей. ACE-Step отклоняет явно указанный текст песни; Stable Audio отклоняет
и текст песни, и инструментальный режим.

<Tip>
Таблицы и раскрывающиеся разделы выше охватывают семейства моделей, которые встроенный провайдер fal
обрабатывает особым образом. Другие идентификаторы конечных точек изображений fal также можно выбирать
в качестве модели изображений; они обрабатываются как Flux (универсальная полезная нагрузка `image_size`, одно
эталонное изображение через `/image-to-image`).
</Tip>

## Связанные материалы

<CardGroup cols={2}>
  <Card title="Генерация изображений" href="/ru/tools/image-generation" icon="image">
    Общие параметры инструмента изображений и выбор провайдера.
  </Card>
  <Card title="Генерация видео" href="/ru/tools/video-generation" icon="video">
    Общие параметры инструмента видео и выбор провайдера.
  </Card>
  <Card title="Генерация музыки" href="/ru/tools/music-generation" icon="music">
    Общие параметры инструмента музыки и выбор провайдера.
  </Card>
  <Card title="Справочник по конфигурации" href="/ru/gateway/config-agents#agent-defaults" icon="gear">
    Значения агентов по умолчанию, включая выбор моделей изображений, видео и музыки.
  </Card>
</CardGroup>
