> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Fal OpenClaw 隨附內建的 `fal` 提供者，用於託管式圖片、影片和音樂 生成。 | 屬性 | 值 | | ------ | ---------------------------------------------------------- | | 提供者 | `fal` | | 驗證 | `FAL_KEY`（標準；`FAL_API_KEY` 也可作為備援） | | API | fal 模型端點（`https://fal.run`；影片工作使用 `https://queue.fal.run`） | | 基底 URL | 使用 `models.providers.fal.baseUrl` 覆寫 | ## 開始使用 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw onboard --auth-choice fal-api-key ``` 非互動式設定可傳入 `--fal-api-key ` 或匯出 `FAL_KEY`。 若未設定圖片模型，初始設定也會將 `fal/fal-ai/flux/dev` 設為預設 圖片模型。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 秒的時長，以及 音訊切換選項。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, }, } ``` ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, }, } ``` 參考轉影片可透過共用的 `video_generate`、`images`、`videos` 和 `audioRefs` 參數接受最多 9 張圖片、3 部影片和 3 個音訊參考， 參考檔案總數最多為 12 個。音訊參考要求同一請求中 至少包含一個圖片或影片參考。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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 設為預設音樂提供者： ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { 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` 提供一張參考圖片）。 ## 相關內容 共用圖片工具參數和提供者選擇。 共用影片工具參數和提供者選擇。 共用音樂工具參數和提供者選擇。 代理程式預設值，包括圖片、影片和音樂模型選擇。