Providers

Fal

OpenClaw dostarcza dołączonego dostawcę fal do hostowanego generowania obrazów i wideo.

Właściwość Wartość
Dostawca fal
Auth FAL_KEY (kanoniczne; FAL_API_KEY działa również jako fallback)
API endpointy modeli fal

Pierwsze kroki

  • Ustaw klucz API

    openclaw onboard --auth-choice fal-api-key
    
  • Ustaw domyślny model obrazu

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    
  • Generowanie obrazów

    Dołączony dostawca generowania obrazów fal domyślnie używa fal/fal-ai/flux/dev.

    Możliwość Wartość
    Maks. liczba obrazów 4 na żądanie
    Tryb edycji Włączony, 1 obraz referencyjny
    Nadpisania rozmiaru Obsługiwane
    Aspect ratio Obsługiwane
    Rozdzielczość Obsługiwana
    Format wyjściowy png albo jpeg

    Użyj outputFormat: "png", gdy chcesz uzyskać wyjście PNG. fal nie deklaruje jawnej kontroli przezroczystego tła w OpenClaw, więc background: "transparent" jest zgłaszane jako zignorowane nadpisanie dla modeli fal.

    Aby używać fal jako domyślnego dostawcy obrazów:

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    

    Generowanie wideo

    Dołączony 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, 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-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
    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 images, videos i audioRefs narzędzia video_generate, przy maksymalnie 12 plikach referencyjnych łącznie.

    Przykład konfiguracji HeyGen video-agent
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/fal-ai/heygen/v2/video-agent",
          },
        },
      },
    }
    

    Powiązane