Providers
Fal
OpenClaw zawiera wbudowanego dostawcę fal do hostowanego generowania obrazów, wideo i muzyki.
| Właściwość | Wartość |
|---|---|
| Dostawca | fal |
| Auth | FAL_KEY (kanoniczny; FAL_API_KEY działa też jako opcja awaryjna) |
| API | punkty końcowe modeli fal |
Pierwsze kroki
Ustaw klucz API
openclaw onboard --auth-choice fal-api-keyUstaw domyślny model obrazu
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Generowanie obrazów
Wbudowany dostawca generowania obrazów fal domyślnie używa
fal/fal-ai/flux/dev.
| Możliwość | Wartość |
|---|---|
| Maks. liczba obrazów | 4 na żądanie; Krea 2: 1 na żądanie |
| Tryb edycji | Flux: 1 obraz referencyjny; GPT Image 2: 10; Nano Banana 2: 14 |
| Referencje stylu | Krea 2: do 10 referencji stylu przez image / images |
| Nadpisania rozmiaru | Obsługiwane |
| Proporcje obrazu | Obsługiwane dla generowania, Krea 2 oraz edycji GPT Image 2/Nano Banana 2 |
| Rozdzielczość | Obsługiwana |
| Format wyjściowy | png lub jpeg |
Modele Krea 2 używają natywnego schematu ładunku Krea w fal. OpenClaw wysyła
aspect_ratio, creativity i image_style_references zamiast
ogólnego ładunku image_size / punktu końcowego edycji używanego przez Flux. Referencje modeli to:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Użyj Medium do szybszych ekspresyjnych ilustracji, anime, malarstwa i stylów
artystycznych. Użyj Large do wolniejszych fotorealistycznych ujęć, surowych tekstur, ziarna filmowego i szczegółowych
wyglądów. Krea domyślnie używa fal.creativity: "medium"; obsługiwane wartości to
raw, low, medium i high.
Krea 2 udostępnia proporcje obrazu, a nie image_size, w schemacie żądania fal. Preferuj
aspectRatio; OpenClaw mapuje size na najbliższe obsługiwane proporcje obrazu Krea
i odrzuca resolution dla Krea zamiast je pomijać.
Użyj outputFormat: "png", gdy chcesz uzyskać wyjście PNG z modeli fal, które udostępniają
output_format. fal nie deklaruje w OpenClaw jawnej kontroli przezroczystego tła,
więc background: "transparent" jest zgłaszane jako ignorowane
nadpisanie dla modeli fal.
Punkty końcowe Krea 2 nie udostępniają pola żądania output_format przez fal, więc
OpenClaw odrzuca nadpisania outputFormat dla żądań Krea.
Aby używać fal jako domyślnego dostawcy obrazów:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Aby używać Krea 2 Medium:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Generowanie wideo
Wbudowany dostawca generowania wideo fal domyślnie używa
fal/fal-ai/minimax/video-01-live.
| Możliwość | Wartość |
|---|---|
| Tryby | Tekst na wideo, referencja z pojedynczego obrazu, Seedance reference-to-video |
| Runtime | Przepływ submit/status/result oparty na kolejce dla długotrwałych zadań |
Dostępne modele wideo
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
Przykład konfiguracji Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Przykład konfiguracji Seedance 2.0 reference-to-video
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Reference-to-video akceptuje do 9 obrazów, 3 wideo i 3 referencje audio
przez współdzielone parametry video_generate images, videos i audioRefs,
z limitem maksymalnie 12 plików referencyjnych łącznie.
Przykład konfiguracji HeyGen video-agent
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Generowanie muzyki
Wbudowany Plugin fal rejestruje też dostawcę generowania muzyki dla
współdzielonego narzędzia music_generate.
| Możliwość | Wartość |
|---|---|
| Model domyślny | fal/fal-ai/minimax-music/v2.6 |
| Modele | fal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio |
| Runtime | Żądanie synchroniczne oraz pobieranie wygenerowanego audio |
Użyj fal jako domyślnego dostawcy muzyki:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6 obsługuje jawne teksty utworów i tryb instrumentalny.
ACE-Step i Stable Audio to punkty końcowe prompt-to-audio; wybierz je przy użyciu
nadpisania model, gdy chcesz użyć tych rodzin modeli.
Powiązane
Współdzielone parametry narzędzia obrazów i wybór dostawcy.
Współdzielone parametry narzędzia wideo i wybór dostawcy.
Współdzielone parametry narzędzia muzyki i wybór dostawcy.
Domyślne ustawienia agentów, w tym wybór modeli obrazów, wideo i muzyki.