Providers

Onwaar

OpenClaw levert een meegeleverde fal-aanbieder voor gehoste generatie van afbeeldingen, video en muziek.

Eigenschap Waarde
Aanbieder fal
Authenticatie FAL_KEY (canoniek; FAL_API_KEY werkt ook als terugvaloptie)
API fal-modeleindpunten (https://fal.run; videotaken gebruiken https://queue.fal.run)
Basis-URL Overschrijf met models.providers.fal.baseUrl

Aan de slag

  • Set the API key

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

    Niet-interactieve configuraties kunnen --fal-api-key <key> doorgeven of FAL_KEY exporteren. Het configuratieproces stelt ook fal/fal-ai/flux/dev in als het standaardafbeeldingsmodel wanneer er geen model is geconfigureerd.

  • Set a default image model

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

    De meegeleverde fal-aanbieder voor afbeeldingsgeneratie gebruikt standaard fal/fal-ai/flux/dev.

    Mogelijkheid Waarde
    Maximaal aantal afbeeldingen 4 per aanvraag; Krea 2: 1 per aanvraag
    Formaatoverschrijvingen 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024
    Beeldverhouding Overal ondersteund, behalve bij Flux image-to-image
    Resolutie 1K, 2K, 4K (modelspecifieke limieten hieronder)
    Uitvoerindeling png (standaard) of jpeg; Krea 2 weigert overschrijvingen van outputFormat

    Bewerkingsaanvragen (referentieafbeeldingen via de gedeelde parameters image / images) worden doorgestuurd naar een modelspecifiek bewerkingseindpunt met modelspecifieke referentielimieten:

    Modelfamilie Modelreferentie na fal/ Bewerkingseindpunt Maximaal aantal referentieafbeeldingen
    Flux en andere fal-modellen fal-ai/flux/dev (standaard) /image-to-image 1
    GPT Image openai/gpt-image-* /edit 10
    Grok Imagine xai/grok-imagine-image /edit 3
    Nano Banana (verouderd) 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 geen (stijlreferenties) 10 stijlreferenties

    Krea 2-modellen gebruiken het systeemeigen Krea-payloadschema van fal. OpenClaw verzendt aspect_ratio, creativity en image_style_references in plaats van de algemene image_size-payload of payload voor het bewerkingseindpunt die Flux gebruikt. De modelreferenties zijn:

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

    Gebruik Medium voor snellere expressieve illustraties, anime, schilderijen en artistieke stijlen. Gebruik Large voor tragere fotorealistische resultaten, ruwe texturen, filmkorrel en gedetailleerde vormgeving. Krea gebruikt standaard fal.creativity: "medium"; ondersteunde waarden zijn raw, low, medium en high.

    Krea 2 stelt in het aanvraagschema van fal een beeldverhouding beschikbaar, niet image_size. Gebruik bij voorkeur aspectRatio; OpenClaw koppelt size aan de dichtstbijzijnde ondersteunde Krea-beeldverhouding en weigert resolution voor Krea in plaats van deze parameter weg te laten.

    Gebruik outputFormat: "png" wanneer je PNG-uitvoer wilt van fal-modellen die output_format beschikbaar stellen. fal definieert in OpenClaw geen expliciete instelling voor een transparante achtergrond, dus background: "transparent" wordt voor fal-modellen gemeld als een genegeerde overschrijving. Krea 2-eindpunten stellen via fal geen aanvraagveld output_format beschikbaar, dus OpenClaw weigert overschrijvingen van outputFormat voor Krea-aanvragen.

    Krea 2 Medium gebruiken:

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

    Video genereren

    De meegeleverde fal-aanbieder voor videogeneratie gebruikt standaard fal/fal-ai/minimax/video-01-live.

    Mogelijkheid Waarde
    Modi Tekst-naar-video, één afbeeldingsreferentie, Seedance referentie-naar-video
    Uitvoering Wachtrijgestuurde stroom voor indienen/status/resultaat van langlopende taken
    Time-out Standaard 20 minuten per taak; status wordt elke 5 seconden opgevraagd
    Available video models

    MiniMax (standaard):

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

    HeyGen-videoagent:

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

    Kling en 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- en HeyGen-aanvragen verzenden alleen de prompt plus een optionele enkele referentieafbeelding; andere overschrijvingen worden niet doorgestuurd. Seedance-modellen accepteren aspectRatio, size, resolution, een duur van 4–15 seconden en een audioschakelaar.

    Seedance 2.0 config example
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",      },    },  },}
    Seedance 2.0 reference-to-video config example
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",      },    },  },}

    Referentie-naar-video accepteert maximaal 9 afbeeldingen, 3 video's en 3 audioreferenties via de gedeelde parameters images, videos en audioRefs van video_generate, met maximaal 12 referentiebestanden in totaal. Audioreferenties vereisen ten minste één afbeeldings- of videoreferentie in dezelfde aanvraag.

    HeyGen video-agent config example
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/fal-ai/heygen/v2/video-agent",      },    },  },}

    Muziek genereren

    De meegeleverde fal-Plugin registreert ook een aanbieder voor muziekgeneratie voor het gedeelde hulpmiddel music_generate.

    Mogelijkheid Waarde
    Standaardmodel fal/fal-ai/minimax-music/v2.6
    Modellen 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 duur 240 seconden
    Uitvoering Synchrone aanvraag plus download van de gegenereerde audio

    fal als standaardaanbieder voor muziek gebruiken:

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

    fal-ai/minimax-music/v2.6 ondersteunt expliciete songteksten en een instrumentale modus, maar niet beide in dezelfde aanvraag. ACE-Step en Stable Audio zijn prompt-naar-audio-eindpunten; selecteer ze met de overschrijving model wanneer je die modelfamilies wilt gebruiken. ACE-Step weigert expliciete songteksten; Stable Audio weigert zowel songteksten als de instrumentale modus.

    Gerelateerd

    Was this useful?
    On this page

    On this page