Passer au contenu principal
OpenClaw inclut un fournisseur fal groupé pour la génération hébergée d’images, de vidéos et de musique.
PropriétéValeur
Fournisseurfal
AuthentificationFAL_KEY (canonique ; FAL_API_KEY fonctionne aussi comme solution de repli)
APIpoints de terminaison de modèles fal

​
Premiers pas

1

Définir la clé API

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

Définir un modèle d’image par défaut

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

​
Génération d’images

Le fournisseur de génération d’images fal groupé utilise par défaut fal/fal-ai/flux/dev.
CapacitéValeur
Images max.4 par requête ; Krea 2 : 1 par requête
Mode éditionFlux : 1 image de référence ; GPT Image 2 : 10 ; Nano Banana 2 : 14
Références de styleKrea 2 : jusqu’à 10 références de style via image / images
Remplacements de taillePris en charge
Rapport d’aspectPris en charge pour la génération, Krea 2, et l’édition GPT Image 2/Nano Banana 2
RésolutionPrise en charge
Format de sortiepng ou jpeg
Les requêtes image-à-image Flux ne prennent pas en charge les remplacements aspectRatio. Les requêtes d’édition GPT Image 2 et Nano Banana 2 utilisent le point de terminaison /edit de fal et acceptent les indications de rapport d’aspect. Nano Banana 2 accepte aussi des rapports natifs supplémentaires larges/hauts comme 4:1, 1:4, 8:1 et 1:8 ; Krea 2 valide son propre sous-ensemble plus réduit de rapports d’aspect.
Les modèles Krea 2 utilisent le schéma de charge utile Krea natif de fal. OpenClaw envoie aspect_ratio, creativity et image_style_references au lieu de la charge utile générique image_size / point de terminaison d’édition utilisée par Flux. Les références de modèle sont :
  • fal/krea/v2/medium/text-to-image
  • fal/krea/v2/large/text-to-image
Utilisez Medium pour des illustrations expressives, de l’anime, de la peinture et des styles artistiques plus rapides. Utilisez Large pour des rendus photoréalistes plus lents, des textures brutes, du grain de film et des aspects détaillés. Krea utilise par défaut fal.creativity: "medium" ; les valeurs prises en charge sont raw, low, medium et high. Krea 2 expose le rapport d’aspect, et non image_size, dans le schéma de requête de fal. Préférez aspectRatio ; OpenClaw mappe size au rapport d’aspect Krea pris en charge le plus proche et rejette resolution pour Krea au lieu de l’ignorer. Utilisez outputFormat: "png" lorsque vous voulez une sortie PNG depuis les modèles fal qui exposent output_format. fal ne déclare pas de contrôle explicite de l’arrière-plan transparent dans OpenClaw ; background: "transparent" est donc signalé comme un remplacement ignoré pour les modèles fal. Les points de terminaison Krea 2 n’exposent pas de champ de requête output_format via fal ; OpenClaw rejette donc les remplacements outputFormat pour les requêtes Krea. Pour utiliser fal comme fournisseur d’images par défaut : 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}
Pour utiliser Krea 2 Medium : 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

​
Génération de vidéos

Le fournisseur de génération de vidéos fal groupé utilise par défaut fal/fal-ai/minimax/video-01-live.
FonctionnalitéValeur
ModesTexte-vers-vidéo, référence à image unique, référence-vers-vidéo Seedance
RuntimeFlux de soumission/statut/résultat adossé à une file d’attente pour les tâches de longue durée
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",
      },
    },
  },
}
Le référence-vers-vidéo accepte jusqu’à 9 images, 3 vidéos et 3 références audio via les paramètres partagés video_generate images, videos et audioRefs, avec au maximum 12 fichiers de référence au total.
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

​
Génération de musique

Le Plugin fal inclus enregistre également un fournisseur de génération de musique pour l’outil partagé music_generate.
FonctionnalitéValeur
Modèle par défautfal/fal-ai/minimax-music/v2.6
Modèlesfal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio
RuntimeRequête synchrone plus téléchargement de l’audio généré
Utilisez fal comme fournisseur de musique par défaut : 
{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}
fal-ai/minimax-music/v2.6 prend en charge les paroles explicites et le mode instrumental. ACE-Step et Stable Audio sont des points de terminaison prompt-to-audio ; choisissez-les avec le remplacement model lorsque vous voulez ces familles de modèles.
Utilisez openclaw models list --provider fal pour voir la liste complète des modèles fal disponibles, y compris les entrées ajoutées récemment.

​
Connexe

Génération d’images

Paramètres de l’outil d’image partagé et sélection du fournisseur.

Génération de vidéo

Paramètres de l’outil vidéo partagé et sélection du fournisseur.

Génération de musique

Paramètres de l’outil de musique partagé et sélection du fournisseur.

Référence de configuration

Valeurs par défaut de l’agent, y compris la sélection des modèles d’image, de vidéo et de musique.