Fal

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

開始使用

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

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

圖片生成

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

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

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。

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

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

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

音樂生成

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

將 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 同時拒絕 歌詞和純音樂模式。

相關內容