Fal

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

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

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

Задайте ключ API

openclaw onboard --auth-choice fal-api-key

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

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

{
  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 эталонов стиля

Запросы 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:

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

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

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

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

Доступные модели видео

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 секунд и переключатель звука.

Пример конфигурации Seedance 2.0

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

Пример конфигурации преобразования эталонов в видео в Seedance 2.0

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}

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

Пример конфигурации видеоагента HeyGen

{
  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 как провайдер музыки по умолчанию:

{
  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 отклоняет и текст песни, и инструментальный режим.

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

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

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

Общие параметры инструмента изображений и выбор провайдера.

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

Общие параметры инструмента видео и выбор провайдера.

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

Общие параметры инструмента музыки и выбор провайдера.

Справочник по конфигурации

Значения агентов по умолчанию, включая выбор моделей изображений, видео и музыки.

Overview

Concepts and configuration

Providers

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

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

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

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

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

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

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

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

Справочник по конфигурации

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

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

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

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

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

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

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

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

Справочник по конфигурации

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

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

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

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

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