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

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

    Konfiguracje 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

    json5
    {  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-image
    • fal/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:

    json5
    {  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-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

    Żą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
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",      },    },  },}
    Przykład konfiguracji referencji na wideo Seedance 2.0
    json5
    {  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
    json5
    {  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:

    json5
    {  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

    Was this useful?
    On this page

    On this page