Providers
Fal
OpenClaw fournit un fournisseur fal intégré pour la génération hébergée
d’images, de vidéos et de musique.
| Propriété | Valeur |
|---|---|
| Fournisseur | fal |
| Auth | FAL_KEY (canonique ; FAL_API_KEY fonctionne aussi comme solution de repli) |
| API | Points de terminaison des modèles fal (https://fal.run ; les tâches vidéo utilisent https://queue.fal.run) |
| URL de base | À remplacer avec models.providers.fal.baseUrl |
Bien démarrer
Définir la clé API
openclaw onboard --auth-choice fal-api-keyLes configurations non interactives peuvent transmettre --fal-api-key <key> ou exporter FAL_KEY.
L’intégration initiale définit également fal/fal-ai/flux/dev comme modèle d’image par défaut
lorsqu’aucun n’est configuré.
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 intégré de génération d’images fal utilise par défaut
fal/fal-ai/flux/dev.
| Fonctionnalité | Valeur |
|---|---|
| Nombre maximal d’images | 4 par requête ; Krea 2 : 1 par requête |
| Remplacements de taille | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| Format d’image | Pris en charge partout sauf pour la transformation image-à-image de Flux |
| Résolution | 1K, 2K, 4K (limites par modèle ci-dessous) |
| Format de sortie | png (par défaut) ou jpeg ; Krea 2 refuse les remplacements de outputFormat |
Les requêtes de modification (images de référence via les paramètres partagés image / images)
sont acheminées vers un point de terminaison de modification propre à chaque modèle, avec des limites
de références spécifiques :
| Famille de modèles | Référence du modèle après fal/ |
Point de terminaison de modification | Nombre maximal d’images de référence |
|---|---|---|---|
| Flux et autres modèles fal | fal-ai/flux/dev (par défaut) |
/image-to-image |
1 |
| GPT Image | openai/gpt-image-* |
/edit |
10 |
| Grok Imagine | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana (ancien) | 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 |
aucun (références de style) | 10 références de style |
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 / du point de terminaison de modification utilisée par Flux. Les références de modèles sont :
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Utilisez Medium pour des illustrations expressives, des animes, des peintures et des styles artistiques
générés plus rapidement. Utilisez Large pour des rendus photoréalistes plus lents, des textures brutes,
du grain cinématographique et des apparences détaillées. Krea utilise par défaut
fal.creativity: "medium" ; les valeurs prises en charge sont raw, low, medium et high.
Krea 2 expose le format d’image, et non image_size, dans le schéma de requête de fal. Privilégiez
aspectRatio ; OpenClaw associe size au format Krea pris en charge le plus proche et refuse
resolution pour Krea au lieu de l’ignorer.
Utilisez outputFormat: "png" lorsque vous souhaitez une sortie PNG avec 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 refuse donc les remplacements de outputFormat pour les requêtes Krea.
Pour utiliser Krea 2 Medium :
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Génération de vidéos
Le fournisseur intégré de génération de vidéos fal utilise par défaut
fal/fal-ai/minimax/video-01-live.
| Fonctionnalité | Valeur |
|---|---|
| Modes | Texte-vers-vidéo, référence à une seule image, référence-vers-vidéo Seedance |
| Exécution | Flux de soumission/état/résultat reposant sur une file d’attente pour les tâches longues |
| Délai maximal | 20 minutes par tâche par défaut ; état interrogé toutes les 5 secondes |
Modèles vidéo disponibles
MiniMax (par défaut) :
fal/fal-ai/minimax/video-01-live
Agent vidéo HeyGen :
fal/fal-ai/heygen/v2/video-agent
Kling et Wan :
fal/fal-ai/kling-video/v2.1/master/text-to-videofal/fal-ai/wan/v2.2-a14b/text-to-videofal/fal-ai/wan/v2.2-a14b/image-to-video
Seedance 2.0 :
fal/bytedance/seedance-2.0/fast/text-to-videofal/bytedance/seedance-2.0/fast/image-to-videofal/bytedance/seedance-2.0/fast/reference-to-videofal/bytedance/seedance-2.0/text-to-videofal/bytedance/seedance-2.0/image-to-videofal/bytedance/seedance-2.0/reference-to-video
Les requêtes MiniMax Live et HeyGen envoient uniquement l’invite, ainsi qu’une image de référence
unique facultative ; les autres remplacements ne sont pas transmis. Les modèles Seedance acceptent
aspectRatio, size, resolution, des durées de 4 à 15 secondes et une option audio.
Exemple de configuration de Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Exemple de configuration référence-vers-vidéo de Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Le mode référence-vers-vidéo accepte jusqu’à 9 images, 3 vidéos et 3 références audio
au moyen des paramètres partagés images, videos et audioRefs de video_generate,
avec un maximum de 12 fichiers de référence au total. Les références audio nécessitent
au moins une référence d’image ou de vidéo dans la même requête.
Exemple de configuration de l’agent vidéo HeyGen
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Génération de musique
Le Plugin intégré fal enregistre également un fournisseur de génération de musique pour l’outil
partagé music_generate.
| Fonctionnalité | Valeur |
|---|---|
| Modèle par défaut | fal/fal-ai/minimax-music/v2.6 |
| Modèles | fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav) |
| Durée maximale | 240 secondes |
| Exécution | Requête synchrone suivie du 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,
mais pas les deux dans la même requête. ACE-Step et Stable Audio sont des points de terminaison
invite-vers-audio ; sélectionnez-les avec le remplacement model lorsque vous souhaitez utiliser
ces familles de modèles. ACE-Step refuse les paroles explicites ; Stable Audio refuse à la fois
les paroles et le mode instrumental.
Ressources associées
Paramètres partagés de l’outil d’image et sélection du fournisseur.
Paramètres partagés de l’outil vidéo et sélection du fournisseur.
Paramètres partagés de l’outil musical et sélection du fournisseur.
Valeurs par défaut des agents, notamment la sélection des modèles d’image, de vidéo et de musique.