> ## 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`。 Krea 2 在 fal 的請求結構描述中公開的是長寬比，而不是 `image_size`。建議使用 `aspectRatio`；OpenClaw 會將 `size` 對應至最接近且受支援的 Krea 長寬比， 並且會拒絕 Krea 的 `resolution`，而不是將其捨棄。 當你希望從公開 `output_format` 的 fal 模型取得 PNG 輸出時，請使用 `outputFormat: "png"`。 fal 未在 OpenClaw 中宣告明確的透明背景控制，因此對 fal 模型而言， `background: "transparent"` 會被回報為已忽略的覆寫。 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` 使用一張參考圖片）。 ## 相關 共用圖片工具參數與提供者選擇。 共用影片工具參數與提供者選擇。 共用音樂工具參數與提供者選擇。 Agent 預設值，包含圖片、影片與音樂模型選擇。