Naar hoofdinhoud gaan
OpenClaw levert een gebundelde fal-provider voor gehoste afbeelding-, video- en muziekgeneratie.
EigenschapWaarde
Providerfal
AuthFAL_KEY (canoniek; FAL_API_KEY werkt ook als fallback)
APIfal-modeleindpunten

Aan de slag

1

Stel de API-sleutel in

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

Stel een standaard afbeeldingsmodel in

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

Afbeeldingsgeneratie

De gebundelde fal-provider voor afbeeldingsgeneratie gebruikt standaard fal/fal-ai/flux/dev.
MogelijkheidWaarde
Max. afbeeldingen4 per aanvraag; Krea 2: 1 per aanvraag
BewerkmodusFlux: 1 referentieafbeelding; GPT Image 2: 10; Nano Banana 2: 14
StijlreferentiesKrea 2: tot 10 stijlreferenties via image / images
Grootte-overschrijvingenOndersteund
BeeldverhoudingOndersteund voor genereren, Krea 2 en bewerken met GPT Image 2/Nano Banana 2
ResolutieOndersteund
Uitvoerformaatpng of jpeg
Flux-aanvragen voor afbeelding-naar-afbeelding ondersteunen geen aspectRatio-overschrijvingen. GPT Image 2- en Nano Banana 2-bewerkverzoeken gebruiken het /edit-eindpunt van fal en accepteren hints voor beeldverhouding. Nano Banana 2 accepteert ook extra-native brede/hoge verhoudingen zoals 4:1, 1:4, 8:1 en 1:8; Krea 2 valideert zijn eigen kleinere subset van beeldverhoudingen.
Krea 2-modellen gebruiken het native Krea-payloadschema van fal. OpenClaw verstuurt aspect_ratio, creativity en image_style_references in plaats van de generieke image_size / edit-endpoint-payload 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 illustratie, anime, schilderkunst en artistieke stijlen. Gebruik Large voor tragere fotorealistische beelden, ruwe textuur, filmkorrel en gedetailleerde looks. Krea gebruikt standaard fal.creativity: "medium"; ondersteunde waarden zijn raw, low, medium en high. Krea 2 biedt beeldverhouding, niet image_size, in het aanvraagschema van fal. Geef de voorkeur aan aspectRatio; OpenClaw koppelt size aan de dichtstbijzijnde ondersteunde Krea-beeldverhouding en weigert resolution voor Krea in plaats van die te negeren. Gebruik outputFormat: "png" wanneer je PNG-uitvoer wilt van fal-modellen die output_format aanbieden. fal declareert geen expliciete instelling voor transparante achtergrond in OpenClaw, dus background: "transparent" wordt gerapporteerd als een genegeerde overschrijving voor fal-modellen. Krea 2-eindpunten bieden geen aanvraagveld output_format via fal, dus OpenClaw weigert outputFormat-overschrijvingen voor Krea-aanvragen. Om fal als standaard afbeeldingsprovider te gebruiken:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}
Om Krea 2 Medium te gebruiken:
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

Videogeneratie

De gebundelde fal-provider voor videogeneratie gebruikt standaard fal/fal-ai/minimax/video-01-live.
MogelijkheidWaarde
ModiTekst-naar-video, referentie met één afbeelding, Seedance referentie-naar-video
RuntimeWachtrijgebaseerde submit/status/result-flow voor langlopende taken
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
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}
Referentie-naar-video accepteert tot 9 afbeeldingen, 3 video’s en 3 audioreferenties via de gedeelde video_generate-parameters images, videos en audioRefs, met maximaal 12 referentiebestanden in totaal.
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

Muziekgeneratie

De gebundelde fal-Plugin registreert ook een provider voor muziekgeneratie voor de gedeelde tool music_generate.
MogelijkheidWaarde
Standaardmodelfal/fal-ai/minimax-music/v2.6
Modellenfal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio
RuntimeSynchrone aanvraag plus download van gegenereerde audio
Gebruik fal als standaard muziekprovider:
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}
fal-ai/minimax-music/v2.6 ondersteunt expliciete songteksten en instrumentale modus. ACE-Step en Stable Audio zijn prompt-naar-audio-eindpunten; kies ze met de model-overschrijving wanneer je die modelfamilies wilt.
Gebruik openclaw models list --provider fal om de volledige lijst met beschikbare fal- modellen te bekijken, inclusief recent toegevoegde vermeldingen.

Gerelateerd

Afbeeldingsgeneratie

Gedeelde parameters voor de afbeeldingstool en providerselectie.

Videogeneratie

Gedeelde parameters voor de videotool en providerselectie.

Muziekgeneratie

Gedeelde parameters voor de muziektool en providerselectie.

Configuratiereferentie

Agentstandaarden, inclusief selectie van afbeeldings-, video- en muziekmodellen.