Providers

Fal

OpenClaw include un provider fal integrato per la generazione ospitata di immagini e video.

Proprietà Valore
Provider fal
Auth FAL_KEY (canonico; anche FAL_API_KEY funziona come fallback)
API endpoint dei modelli fal

Per iniziare

  • Imposta la chiave API

    openclaw onboard --auth-choice fal-api-key
    
  • Imposta un modello immagine predefinito

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    
  • Generazione di immagini

    Il provider di generazione immagini fal integrato usa per impostazione predefinita fal/fal-ai/flux/dev.

    Capacità Valore
    Immagini max 4 per richiesta
    Modalità modifica Abilitata, 1 immagine di riferimento
    Override dimensioni Supportati
    Rapporto d'aspetto Supportato
    Risoluzione Supportata
    Formato output png o jpeg

    Usa outputFormat: "png" quando vuoi output PNG. fal non dichiara un controllo esplicito dello sfondo trasparente in OpenClaw, quindi background: "transparent" viene segnalato come override ignorato per i modelli fal.

    Per usare fal come provider di immagini predefinito:

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

    Generazione di video

    Il provider di generazione video fal integrato usa per impostazione predefinita fal/fal-ai/minimax/video-01-live.

    Capacità Valore
    Modalità Da testo a video, riferimento con immagine singola, Seedance reference-to-video
    Runtime Flusso submit/status/result supportato da coda per job di lunga durata
    Modelli video disponibili

    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
    Esempio di configurazione di Seedance 2.0
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
          },
        },
      },
    }
    
    Esempio di configurazione reference-to-video di Seedance 2.0
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
          },
        },
      },
    }
    

    reference-to-video accetta fino a 9 immagini, 3 video e 3 riferimenti audio tramite i parametri condivisi images, videos e audioRefs di video_generate, con al massimo 12 file di riferimento totali.

    Esempio di configurazione di HeyGen video-agent
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/fal-ai/heygen/v2/video-agent",
          },
        },
      },
    }
    

    Correlati