Providers

Fal

OpenClaw enthält einen gebündelten fal-Provider für die gehostete Bild-, Video- und Musikgenerierung.

Eigenschaft Wert
Provider fal
Authentifizierung FAL_KEY (kanonisch; FAL_API_KEY funktioniert ebenfalls als Fallback)
API fal-Modellendpunkte (https://fal.run; Videoaufträge verwenden https://queue.fal.run)
Basis-URL Mit models.providers.fal.baseUrl überschreiben

Erste Schritte

  • API-Schlüssel festlegen

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

    Nicht interaktive Einrichtungen können --fal-api-key <key> übergeben oder FAL_KEY exportieren. Das Onboarding legt außerdem fal/fal-ai/flux/dev als Standardbildmodell fest, wenn keines konfiguriert ist.

  • Standardbildmodell festlegen

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

    Der gebündelte fal-Provider für die Bildgenerierung verwendet standardmäßig fal/fal-ai/flux/dev.

    Funktion Wert
    Maximale Bildanzahl 4 pro Anfrage; Krea 2: 1 pro Anfrage
    Größenüberschreibungen 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024
    Seitenverhältnis Überall außer bei Flux-Bild-zu-Bild unterstützt
    Auflösung 1K, 2K, 4K (modellspezifische Grenzen unten)
    Ausgabeformat png (Standard) oder jpeg; Krea 2 lehnt outputFormat-Überschreibungen ab

    Bearbeitungsanfragen (Referenzbilder über die gemeinsamen Parameter image / images) werden an einen modellspezifischen Bearbeitungsendpunkt mit modellspezifischen Referenzgrenzen weitergeleitet:

    Modellfamilie Modellreferenz nach fal/ Bearbeitungsendpunkt Maximale Referenzbilder
    Flux und andere fal-Modelle fal-ai/flux/dev (Standard) /image-to-image 1
    GPT Image openai/gpt-image-* /edit 10
    Grok Imagine xai/grok-imagine-image /edit 3
    Nano Banana (veraltet) 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 keiner (Stilreferenzen) 10 Stilreferenzen

    Krea-2-Modelle verwenden das native Krea-Nutzdatenschema von fal. OpenClaw sendet aspect_ratio, creativity und image_style_references anstelle des generischen image_size- bzw. Bearbeitungsendpunkt-Nutzdatenformats, das Flux verwendet. Die Modellreferenzen lauten:

    • fal/krea/v2/medium/text-to-image
    • fal/krea/v2/large/text-to-image

    Verwenden Sie Medium für schnellere ausdrucksstarke Illustrationen, Anime, Gemälde und künstlerische Stile. Verwenden Sie Large für langsamere fotorealistische Darstellungen, rohe Texturen, Filmkörnung und detaillierte Optiken. Krea verwendet standardmäßig fal.creativity: "medium"; unterstützte Werte sind raw, low, medium und high.

    Krea 2 stellt im Anfrageschema von fal das Seitenverhältnis und nicht image_size bereit. Bevorzugen Sie aspectRatio; OpenClaw ordnet size dem nächstgelegenen unterstützten Krea-Seitenverhältnis zu und lehnt resolution für Krea ab, anstatt es zu verwerfen.

    Verwenden Sie outputFormat: "png", wenn Sie eine PNG-Ausgabe von fal-Modellen wünschen, die output_format bereitstellen. fal deklariert in OpenClaw keine explizite Steuerung für transparente Hintergründe, daher wird background: "transparent" bei fal-Modellen als ignorierte Überschreibung gemeldet. Krea-2-Endpunkte stellen über fal kein output_format-Anfragefeld bereit, daher lehnt OpenClaw outputFormat-Überschreibungen für Krea-Anfragen ab.

    So verwenden Sie Krea 2 Medium:

    json5
    {  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/krea/v2/medium/text-to-image",      },    },  },}

    Videogenerierung

    Der gebündelte fal-Provider für die Videogenerierung verwendet standardmäßig fal/fal-ai/minimax/video-01-live.

    Funktion Wert
    Modi Text-zu-Video, Einzelbildreferenz, Seedance-Referenz-zu-Video
    Laufzeit Warteschlangengestützter Ablauf für Übermittlung, Status und Ergebnis bei lang laufenden Aufträgen
    Zeitüberschreitung Standardmäßig 20 Minuten pro Auftrag; Statusabfrage alle 5 Sekunden
    Verfügbare Videomodelle

    MiniMax (Standard):

    • fal/fal-ai/minimax/video-01-live

    HeyGen-Video-Agent:

    • fal/fal-ai/heygen/v2/video-agent

    Kling und 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

    MiniMax-Live- und HeyGen-Anfragen senden nur den Prompt und optional ein einzelnes Referenzbild; andere Überschreibungen werden nicht weitergeleitet. Seedance-Modelle akzeptieren aspectRatio, size, resolution, Dauern von 4-15 Sekunden und einen Audio-Umschalter.

    Seedance-2.0-Konfigurationsbeispiel
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",      },    },  },}
    Seedance-2.0-Konfigurationsbeispiel für Referenz-zu-Video
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",      },    },  },}

    Referenz-zu-Video akzeptiert über die gemeinsamen video_generate-Parameter images, videos und audioRefs bis zu 9 Bilder, 3 Videos und 3 Audioreferenzen, mit insgesamt höchstens 12 Referenzdateien. Audioreferenzen erfordern in derselben Anfrage mindestens eine Bild- oder Videoreferenz.

    HeyGen-Video-Agent-Konfigurationsbeispiel
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/fal-ai/heygen/v2/video-agent",      },    },  },}

    Musikgenerierung

    Das gebündelte fal-Plugin registriert außerdem einen Provider für die Musikgenerierung für das gemeinsame Werkzeug music_generate.

    Funktion Wert
    Standardmodell fal/fal-ai/minimax-music/v2.6
    Modelle fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav)
    Maximale Dauer 240 Sekunden
    Laufzeit Synchrone Anfrage mit anschließendem Download des generierten Audios

    So verwenden Sie fal als Standard-Provider für Musik:

    json5
    {  agents: {    defaults: {      musicGenerationModel: {        primary: "fal/fal-ai/minimax-music/v2.6",      },    },  },}

    fal-ai/minimax-music/v2.6 unterstützt explizite Liedtexte und einen Instrumentalmodus, jedoch nicht beides in derselben Anfrage. ACE-Step und Stable Audio sind Prompt-zu-Audio-Endpunkte; wählen Sie sie mit der model-Überschreibung aus, wenn Sie diese Modellfamilien verwenden möchten. ACE-Step lehnt explizite Liedtexte ab; Stable Audio lehnt sowohl Liedtexte als auch den Instrumentalmodus ab.

    Verwandte Themen

    Was this useful?
    On this page

    On this page