--- 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` | ## Начало работы ```bash openclaw onboard --auth-choice fal-api-key ``` При неинтерактивной настройке можно передать `--fal-api-key ` или экспортировать `FAL_KEY`. Процесс первоначальной настройки также задаёт `fal/fal-ai/flux/dev` как модель изображений по умолчанию, если модель не настроена. ```json5 { 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: ```json5 { 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 секунд и переключатель звука. ```json5 { agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, }, } ``` ```json5 { agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, }, } ``` Преобразование эталонов в видео принимает до 9 изображений, 3 видео и 3 звуковых эталонов через общие параметры `video_generate` `images`, `videos` и `audioRefs`, при этом общее число эталонных файлов не должно превышать 12. Для звуковых эталонов в том же запросе требуется как минимум один эталон изображения или видео. ```json5 { 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 { 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`). ## Связанные материалы Общие параметры инструмента изображений и выбор провайдера. Общие параметры инструмента видео и выбор провайдера. Общие параметры инструмента музыки и выбор провайдера. Значения агентов по умолчанию, включая выбор моделей изображений, видео и музыки.