Providers

Fal

OpenClaw menyertakan provider bawaan fal untuk hosted image dan video generation.

Properti Nilai
Provider fal
Auth FAL_KEY (kanonis; FAL_API_KEY juga berfungsi sebagai fallback)
API endpoint model fal

Memulai

  • Atur API key

    openclaw onboard --auth-choice fal-api-key
    
  • Atur model image default

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

    Provider image-generation fal bawaan default ke fal/fal-ai/flux/dev.

    Capability Nilai
    Max images 4 per permintaan
    Edit mode Aktif, 1 gambar referensi
    Size overrides Didukung
    Aspect ratio Didukung
    Resolution Didukung
    Output format png atau jpeg

    Gunakan outputFormat: "png" saat Anda menginginkan output PNG. fal tidak mendeklarasikan kontrol latar belakang transparan eksplisit di OpenClaw, jadi background: "transparent" dilaporkan sebagai override yang diabaikan untuk model fal.

    Untuk menggunakan fal sebagai provider image default:

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

    Video generation

    Provider video-generation fal bawaan default ke fal/fal-ai/minimax/video-01-live.

    Capability Nilai
    Modes Text-to-video, referensi gambar tunggal, Seedance reference-to-video
    Runtime Alur submit/status/result berbasis antrean untuk job yang berjalan lama
    Model video yang tersedia

    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
    Contoh config Seedance 2.0
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
          },
        },
      },
    }
    
    Contoh config Seedance 2.0 reference-to-video
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
          },
        },
      },
    }
    

    Reference-to-video menerima hingga 9 gambar, 3 video, dan 3 referensi audio melalui parameter bersama video_generate yaitu images, videos, dan audioRefs, dengan total maksimal 12 file referensi.

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

    Terkait