Fal

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

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

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

{  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/fal-ai/flux/dev",      },    },  },}

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

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

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

Модели 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.

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

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

{  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/fal-ai/heygen/v2/video-agent",      },    },  },}

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

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

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

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