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

# Fal

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

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

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

**1. Задайте ключ API**

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --auth-choice fal-api-key
```

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

**2. Задайте модель изображений по умолчанию**

```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}
```

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

Встроенный провайдер генерации изображений `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`.

Модели 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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}
```

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

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

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

> [accordion] Доступные модели видео
>
> **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] Пример конфигурации Seedance 2.0
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       videoGenerationModel: {
>         primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
>       },
>     },
>   },
> }
> ```

> [accordion] Пример конфигурации преобразования эталонов в видео в Seedance 2.0
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       videoGenerationModel: {
>         primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
>       },
>     },
>   },
> }
> ```
>
> Преобразование эталонов в видео принимает до 9 изображений, 3 видео и 3 звуковых эталонов
> через общие параметры `video_generate` `images`, `videos` и `audioRefs`,
> при этом общее число эталонных файлов не должно превышать 12. Для звуковых эталонов
> в том же запросе требуется как минимум один эталон изображения или видео.

> [accordion] Пример конфигурации видеоагента HeyGen
>
> ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
> {
>   agents: {
>     defaults: {
>       videoGenerationModel: {
>         primary: "fal/fal-ai/heygen/v2/video-agent",
>       },
>     },
>   },
> }
> ```

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

Встроенный плагин `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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  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`).

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

> [card] [Генерация изображений](https://docs2.openclaw.ai/ru/tools/image-generation.md)
>
> Общие параметры инструмента изображений и выбор провайдера.

> [card] [Генерация видео](https://docs2.openclaw.ai/ru/tools/video-generation.md)
>
> Общие параметры инструмента видео и выбор провайдера.

> [card] [Генерация музыки](https://docs2.openclaw.ai/ru/tools/music-generation.md)
>
> Общие параметры инструмента музыки и выбор провайдера.

> [card] [Справочник по конфигурации](https://docs2.openclaw.ai/ru/gateway/config-agents.md#agent-defaults)
>
> Значения агентов по умолчанию, включая выбор моделей изображений, видео и музыки.