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

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

    Les 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

    json5
    {  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-image
    • fal/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 :

    json5
    {  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-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

    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
    json5
    {  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
    json5
    {  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
    json5
    {  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 :

    json5
    {  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

    Was this useful?
    On this page

    On this page