Providers
Fal
OpenClaw zawiera wbudowanego dostawcę fal do hostowanego generowania obrazów, filmów i muzyki.
| Właściwość | Wartość |
|---|---|
| Dostawca | fal |
| Uwierzytelnianie | FAL_KEY (kanoniczna; FAL_API_KEY działa również jako wartość zapasowa) |
| API | punkty końcowe modeli fal (https://fal.run; zadania wideo używają https://queue.fal.run) |
| Bazowy adres URL | Zastąp za pomocą models.providers.fal.baseUrl |
Pierwsze kroki
Ustaw klucz API
openclaw onboard --auth-choice fal-api-keyKonfiguracje nieinteraktywne mogą przekazać --fal-api-key <key> lub wyeksportować FAL_KEY.
Proces wdrażania ustawia również fal/fal-ai/flux/dev jako domyślny model obrazu, jeśli
żaden nie został skonfigurowany.
Ustaw 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ść |
|---|---|
| Maksymalna liczba obrazów | 4 na żądanie; Krea 2: 1 na żądanie |
| Zastępowanie rozmiaru | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| Proporcje obrazu | Obsługiwane wszędzie z wyjątkiem przekształcania obrazu w obraz Flux |
| Rozdzielczość | 1K, 2K, 4K (ograniczenia poszczególnych modeli poniżej) |
| Format wyjściowy | png (domyślnie) lub jpeg; Krea 2 odrzuca zastąpienia outputFormat |
Żądania edycji (obrazy referencyjne przekazywane przez współdzielone parametry image / images)
są kierowane do punktu końcowego edycji odpowiedniego modelu, z limitami obrazów referencyjnych zależnymi od modelu:
| Rodzina modeli | Odwołanie do modelu po fal/ |
Punkt końcowy edycji | Maks. liczba obrazów referencyjnych |
|---|---|---|---|
| Flux i inne modele fal | fal-ai/flux/dev (domyślny) |
/image-to-image |
1 |
| GPT Image | openai/gpt-image-* |
/edit |
10 |
| Grok Imagine | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana (starszy) | 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 |
brak (referencje stylu) | 10 referencji stylu |
Modele Krea 2 używają natywnego schematu ładunku Krea w fal. OpenClaw wysyła
aspect_ratio, creativity oraz image_style_references zamiast
ogólnego ładunku image_size / punktu końcowego edycji używanego przez Flux. Odwołania do 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 obrazów, surowych tekstur, ziarna
filmowego i szczegółowego wyglądu. Domyślną wartością Krea jest fal.creativity: "medium"; obsługiwane wartości to
raw, low, medium oraz 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", jeśli chcesz uzyskać dane wyjściowe PNG z modeli fal udostępniających
output_format. fal nie deklaruje w OpenClaw jawnej opcji sterowania przezroczystym tłem,
dlatego background: "transparent" jest zgłaszane jako zignorowane
zastąpienie dla modeli fal.
Punkty końcowe Krea 2 nie udostępniają pola żądania output_format przez fal, dlatego
OpenClaw odrzuca zastąpienia outputFormat w żądaniach Krea.
Aby użyć 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, pojedynczy obraz referencyjny, referencja na wideo Seedance |
| Środowisko wykonawcze | Przepływ wysyłania, sprawdzania stanu i pobierania wyniku oparty na kolejce dla długotrwałych zadań |
| Limit czasu | Domyślnie 20 minut na zadanie; stan sprawdzany co 5 sekund |
Dostępne modele wideo
MiniMax (domyślny):
fal/fal-ai/minimax/video-01-live
Agent wideo HeyGen:
fal/fal-ai/heygen/v2/video-agent
Kling i Wan:
fal/fal-ai/kling-video/v2.1/master/text-to-videofal/fal-ai/wan/v2.2-a14b/text-to-videofal/fal-ai/wan/v2.2-a14b/image-to-video
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
Żądania MiniMax Live i HeyGen wysyłają wyłącznie prompt oraz opcjonalny
pojedynczy obraz referencyjny; inne zastąpienia nie są przekazywane. Modele Seedance
przyjmują aspectRatio, size, resolution, czas trwania od 4 do 15 sekund oraz
przełącznik dźwięku.
Przykład konfiguracji Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Przykład konfiguracji referencji na wideo Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Tryb referencji na wideo przyjmuje do 9 obrazów, 3 filmów i 3 referencji audio
przez współdzielone parametry images, videos i audioRefs narzędzia video_generate,
przy czym łączna liczba plików referencyjnych nie może przekraczać 12. Referencje audio wymagają
co najmniej jednej referencji obrazu lub wideo w tym samym żądaniu.
Przykład konfiguracji agenta wideo HeyGen
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Generowanie muzyki
Wbudowany plugin fal rejestruje również dostawcę generowania muzyki dla
współdzielonego narzędzia music_generate.
| Możliwość | Wartość |
|---|---|
| Domyślny model | fal/fal-ai/minimax-music/v2.6 |
| Modele | fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav) |
| Maksymalny czas trwania | 240 sekund |
| Środowisko wykonawcze | Żądanie synchroniczne oraz pobranie wygenerowanego dźwięku |
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 jawnie podany tekst utworu oraz tryb instrumentalny,
ale nie oba jednocześnie w tym samym żądaniu. ACE-Step i Stable Audio to
punkty końcowe przekształcające prompt w dźwięk; wybierz je za pomocą zastąpienia model, gdy chcesz
użyć tych rodzin modeli. ACE-Step odrzuca jawnie podany tekst utworu; Stable Audio odrzuca
zarówno tekst utworu, jak i tryb instrumentalny.
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.
Ustawienia domyślne agenta, w tym wybór modeli obrazu, wideo i muzyki.