Fal

OpenClaw 隨附內建的 fal 提供者，用於託管式圖片、影片和音樂 生成。

屬性	值
提供者	fal
驗證	FAL_KEY（標準；FAL_API_KEY 也可作為備援）
API	fal 模型端點（https://fal.run；影片工作使用 https://queue.fal.run）
基底 URL	使用 models.providers.fal.baseUrl 覆寫

​

開始使用

1. 設定 API 金鑰

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

   非互動式設定可傳入 --fal-api-key <key> 或匯出 FAL_KEY。 若未設定圖片模型，初始設定也會將 fal/fal-ai/flux/dev 設為預設 圖片模型。

2. 設定預設圖片模型

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

​

圖片生成

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

功能	值
圖片上限	每個請求 4 張；Krea 2：每個請求 1 張
尺寸覆寫	1024x1024、1024x1536、1536x1024、1024x1792、1792x1024
長寬比	除 Flux 圖生圖以外皆支援
解析度	1K、2K、4K（各模型限制如下）
輸出格式	png（預設）或 jpeg；Krea 2 拒絕 outputFormat 覆寫

編輯請求（透過共用的 image / images 參數提供參考圖片） 會路由至各模型的編輯端點，而各模型的參考圖片限制如下：

模型系列	fal/ 之後的模型參照	編輯端點	參考圖片上限
Flux 和其他 fal 模型	fal-ai/flux/dev（預設）	/image-to-image	1
GPT Image	openai/gpt-image-*	/edit	10
Grok Imagine	xai/grok-imagine-image	/edit	3
Nano Banana（舊版）	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	無（風格參考）	10 個風格參考

Flux 圖生圖請求不支援 aspectRatio 覆寫。GPT Image 和 Nano Banana 2 編輯請求使用 fal 的 /edit 端點，並接受 長寬比提示。Nano Banana 2 也接受額外的原生寬版／長版比例， 例如 4:1、1:4、8:1 和 1:8；Krea 2 會驗證自身較小的 長寬比子集。Grok Imagine 有自己的比例清單（包括 2:1、 20:9、19.5:9 及其反向比例），且僅接受 1K/2K 解析度； 舊版 Nano Banana 和 Nano Banana 2 Lite 拒絕 resolution 覆寫。

Krea 2 模型使用 fal 原生的 Krea 承載資料結構描述。OpenClaw 傳送 aspect_ratio、creativity 和 image_style_references，而非 Flux 使用的 通用 image_size / 編輯端點承載資料。模型參照為：

• fal/krea/v2/medium/text-to-image
• fal/krea/v2/large/text-to-image

若要更快速地生成富有表現力的插畫、動漫、繪畫和藝術 風格，請使用 Medium。若要較慢速地生成擬真、原始紋理、膠片顆粒和細緻 效果，請使用 Large。Krea 預設為 fal.creativity: "medium"；支援的值為 raw、low、medium 和 high。

在 fal 的請求結構描述中，Krea 2 公開的是長寬比，而非 image_size。建議使用 aspectRatio；OpenClaw 會將 size 對應至最接近的 Krea 支援長寬比， 且會拒絕 Krea 的 resolution，而非將其捨棄。

若要從公開 output_format 的 fal 模型取得 PNG 輸出， 請使用 outputFormat: "png"。fal 未在 OpenClaw 中宣告明確的透明背景 控制項，因此 background: "transparent" 會回報為 fal 模型忽略的 覆寫。 Krea 2 端點未透過 fal 公開 output_format 請求欄位，因此 OpenClaw 會拒絕 Krea 請求的 outputFormat 覆寫。

若要使用 Krea 2 Medium：

{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

​

影片生成

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

功能	值
模式	文字轉影片、單一圖片參考、Seedance 參考轉影片
執行機制	長時間執行工作的佇列式提交／狀態／結果流程
逾時	每項工作預設 20 分鐘；每 5 秒輪詢一次狀態

可用的影片模型

MiniMax（預設）：

• fal/fal-ai/minimax/video-01-live

HeyGen video-agent：

• fal/fal-ai/heygen/v2/video-agent

Kling 和 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

MiniMax Live 和 HeyGen 請求只會傳送提示詞及選用的 單一參考圖片；不會轉送其他覆寫。Seedance 模型 接受 aspectRatio、size、resolution、4 至 15 秒的時長，以及 音訊切換選項。

Seedance 2.0 設定範例

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

Seedance 2.0 參考轉影片設定範例

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}

參考轉影片可透過共用的 video_generate、images、videos 和 audioRefs 參數接受最多 9 張圖片、3 部影片和 3 個音訊參考， 參考檔案總數最多為 12 個。音訊參考要求同一請求中 至少包含一個圖片或影片參考。

HeyGen video-agent 設定範例

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

​

音樂生成

內建的 fal 外掛也會為共用的 music_generate 工具註冊 音樂生成提供者。

功能	值
預設模型	fal/fal-ai/minimax-music/v2.6
模型	fal-ai/minimax-music/v2.6（mp3）、fal-ai/ace-step/prompt-to-audio（wav）、fal-ai/stable-audio-25/text-to-audio（wav）
時長上限	240 秒
執行機制	同步請求並下載生成的音訊

將 fal 設為預設音樂提供者：

{
  agents: {
    defaults: {
      musicGenerationModel: {
        primary: "fal/fal-ai/minimax-music/v2.6",
      },
    },
  },
}

fal-ai/minimax-music/v2.6 支援明確歌詞和純音樂模式， 但無法在同一請求中同時使用。ACE-Step 和 Stable Audio 是 提示詞轉音訊端點；若要使用這些模型系列，請透過 model 覆寫選擇。 ACE-Step 拒絕明確歌詞；Stable Audio 同時拒絕 歌詞和純音樂模式。

上方表格和摺疊區段涵蓋內建 fal 提供者會特殊處理的模型系列。其他 fal 圖片端點 ID 仍可選為 圖片模型；這些端點會像 Flux 一樣處理（通用 image_size 承載資料，透過 /image-to-image 提供一張參考圖片）。

​

相關內容

圖片生成

共用圖片工具參數和提供者選擇。

影片生成

共用影片工具參數和提供者選擇。

音樂生成

共用音樂工具參數和提供者選擇。

設定參考

代理程式預設值，包括圖片、影片和音樂模型選擇。