Providers
Fal
OpenClaw постачається з вбудованим провайдером fal для хостингової генерації зображень, відео та музики.
| Властивість | Значення |
|---|---|
| Провайдер | fal |
| Автентифікація | FAL_KEY (канонічний; FAL_API_KEY також працює як fallback) |
| API | кінцеві точки моделей fal |
Початок роботи
Установіть ключ API
openclaw onboard --auth-choice fal-api-keyУстановіть стандартну модель зображень
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Генерація зображень
Вбудований провайдер генерації зображень fal за замовчуванням використовує
fal/fal-ai/flux/dev.
| Можливість | Значення |
|---|---|
| Макс. зображень | 4 на запит; Krea 2: 1 на запит |
| Режим редагування | Flux: 1 еталонне зображення; GPT Image 2: 10; Nano Banana 2: 14 |
| Еталони стилю | Krea 2: до 10 еталонів стилю через image / images |
| Перевизначення розміру | Підтримується |
| Співвідношення сторін | Підтримується для generate, Krea 2, а також редагування GPT Image 2/Nano Banana 2 |
| Роздільна здатність | Підтримується |
| Формат виводу | png або jpeg |
Моделі Krea 2 використовують нативну схему payload Krea від fal. OpenClaw надсилає
aspect_ratio, creativity та image_style_references замість
загального image_size / payload кінцевої точки редагування, який використовує Flux. Посилання на моделі:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Використовуйте Medium для швидшої виразної ілюстрації, аніме, живопису та художніх
стилів. Використовуйте Large для повільнішого фотореалізму, сирої текстури, зернистості плівки та деталізованого
вигляду. Для Krea стандартне значення fal.creativity: "medium"; підтримувані значення:
raw, low, medium і high.
Krea 2 у схемі запиту fal надає співвідношення сторін, а не 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.
Щоб використовувати fal як стандартного провайдера зображень:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Щоб використовувати Krea 2 Medium:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Генерація відео
Вбудований провайдер генерації відео fal за замовчуванням використовує
fal/fal-ai/minimax/video-01-live.
| Можливість | Значення |
|---|---|
| Режими | Text-to-video, еталон одного зображення, Seedance reference-to-video |
| Середовище виконання | Потік submit/status/result на основі черги для довготривалих завдань |
Доступні моделі відео
HeyGen video-agent:
fal/fal-ai/heygen/v2/video-agent
Seedance 2.0:
fal/bytedance/seedance-2.0/fast/text-to-videofal/bytedance/seedance-2.0/fast/image-to-videofal/bytedance/seedance-2.0/fast/reference-to-videofal/bytedance/seedance-2.0/text-to-videofal/bytedance/seedance-2.0/image-to-videofal/bytedance/seedance-2.0/reference-to-video
Приклад конфігурації Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Приклад конфігурації Seedance 2.0 reference-to-video
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Reference-to-video приймає до 9 зображень, 3 відео та 3 аудіоеталонів
через спільні параметри video_generate images, videos і audioRefs,
із загальною кількістю не більше 12 еталонних файлів.
Приклад конфігурації HeyGen video-agent
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Генерація музики
Вбудований Plugin fal також реєструє провайдера генерації музики для
спільного інструмента music_generate.
| Можливість | Значення |
|---|---|
| Стандартна модель | fal/fal-ai/minimax-music/v2.6 |
| Моделі | fal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio |
| Середовище виконання | Синхронний запит плюс завантаження згенерованого аудіо |
Використовуйте fal як стандартного провайдера музики:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6 підтримує явний текст пісні та інструментальний режим.
ACE-Step і Stable Audio є кінцевими точками prompt-to-audio; вибирайте їх за допомогою
перевизначення model, коли потрібні ці сімейства моделей.
Пов’язане
Спільні параметри інструмента зображень і вибір провайдера.
Спільні параметри інструмента відео та вибір провайдера.
Спільні параметри інструмента музики та вибір провайдера.
Стандартні налаштування агента, включно з вибором моделей зображень, відео та музики.