Providers

Fal

OpenClaw 內建隨附 fal 提供者,用於託管式圖片與影片生成。

屬性
提供者 fal
驗證 FAL_KEY(標準;FAL_API_KEY 也可作為備援使用)
API fal 模型端點

開始使用

  • Set the API key

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

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    
  • 圖片生成

    內建隨附的 fal 圖片生成提供者預設使用 fal/fal-ai/flux/dev

    功能
    圖片數量上限 每次請求 4 張
    編輯模式 已啟用,1 張參考圖片
    尺寸覆寫 支援
    長寬比 支援
    解析度 支援
    輸出格式 pngjpeg

    若要輸出 PNG,請使用 outputFormat: "png"。fal 未在 OpenClaw 中宣告明確的透明背景控制項,因此對於 fal 模型,background: "transparent" 會回報為已忽略的覆寫。

    若要將 fal 作為預設圖片提供者:

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

    影片生成

    內建隨附的 fal 影片生成提供者預設使用 fal/fal-ai/minimax/video-01-live

    功能
    模式 文字轉影片、單張圖片參考、Seedance 參考轉影片
    執行階段 適用於長時間執行工作的佇列式提交/狀態/結果流程
    Available video models

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

    參考轉影片最多接受 9 張圖片、3 支影片,以及 3 個音訊參考, 透過共用的 video_generate imagesvideosaudioRefs 參數傳入,且參考檔案總數最多為 12 個。

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

    相關