Providers

Fal

OpenClaw cung cấp sẵn provider fal để tạo hình ảnh, video và âm nhạc trên dịch vụ lưu trữ.

Thuộc tính Giá trị
Provider fal
Xác thực FAL_KEY (chuẩn; FAL_API_KEY cũng hoạt động như phương án dự phòng)
API Các endpoint mô hình fal (https://fal.run; tác vụ video dùng https://queue.fal.run)
URL cơ sở Ghi đè bằng models.providers.fal.baseUrl

Bắt đầu

  • Đặt khóa API

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

    Thiết lập không tương tác có thể truyền --fal-api-key <key> hoặc xuất FAL_KEY. Quá trình hướng dẫn ban đầu cũng đặt fal/fal-ai/flux/dev làm mô hình hình ảnh mặc định khi chưa có mô hình nào được cấu hình.

  • Đặt mô hình hình ảnh mặc định

    json5
    {  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/fal-ai/flux/dev",      },    },  },}
  • Tạo hình ảnh

    Provider tạo hình ảnh fal đi kèm mặc định sử dụng fal/fal-ai/flux/dev.

    Khả năng Giá trị
    Số hình ảnh tối đa 4 cho mỗi yêu cầu; Krea 2: 1 cho mỗi yêu cầu
    Ghi đè kích thước 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024
    Tỷ lệ khung hình Được hỗ trợ ở mọi nơi ngoại trừ chuyển hình ảnh thành hình ảnh bằng Flux
    Độ phân giải 1K, 2K, 4K (các giới hạn theo mô hình ở bên dưới)
    Định dạng đầu ra png (mặc định) hoặc jpeg; Krea 2 từ chối ghi đè outputFormat

    Các yêu cầu chỉnh sửa (hình ảnh tham chiếu qua tham số dùng chung image / images) được định tuyến tới endpoint chỉnh sửa riêng của từng mô hình với giới hạn tham chiếu theo mô hình:

    Dòng mô hình Tham chiếu mô hình sau fal/ Endpoint chỉnh sửa Số hình ảnh tham chiếu tối đa
    Flux và các mô hình fal khác fal-ai/flux/dev (mặc định) /image-to-image 1
    GPT Image openai/gpt-image-* /edit 10
    Grok Imagine xai/grok-imagine-image /edit 3
    Nano Banana (cũ) 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 không có (tham chiếu phong cách) 10 tham chiếu phong cách

    Các mô hình Krea 2 sử dụng lược đồ payload Krea gốc của fal. OpenClaw gửi aspect_ratio, creativityimage_style_references thay cho payload image_size / endpoint chỉnh sửa dùng chung mà Flux sử dụng. Các tham chiếu mô hình là:

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

    Dùng Medium để tạo nhanh hơn các phong cách minh họa giàu biểu cảm, anime, hội họa và nghệ thuật. Dùng Large để tạo chậm hơn các phong cách chân thực như ảnh, kết cấu thô, hạt phim và hình ảnh chi tiết. Krea mặc định dùng fal.creativity: "medium"; các giá trị được hỗ trợ là raw, low, mediumhigh.

    Krea 2 cung cấp tỷ lệ khung hình, không phải image_size, trong lược đồ yêu cầu của fal. Nên ưu tiên aspectRatio; OpenClaw ánh xạ size sang tỷ lệ khung hình Krea được hỗ trợ gần nhất và từ chối resolution đối với Krea thay vì bỏ qua giá trị này.

    Dùng outputFormat: "png" khi bạn muốn đầu ra PNG từ các mô hình fal có cung cấp output_format. fal không khai báo cơ chế điều khiển nền trong suốt rõ ràng trong OpenClaw, vì vậy background: "transparent" được báo cáo là một ghi đè bị bỏ qua đối với các mô hình fal. Các endpoint Krea 2 không cung cấp trường yêu cầu output_format thông qua fal, vì vậy OpenClaw từ chối ghi đè outputFormat cho các yêu cầu Krea.

    Để sử dụng Krea 2 Medium:

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

    Tạo video

    Provider tạo video fal đi kèm mặc định sử dụng fal/fal-ai/minimax/video-01-live.

    Khả năng Giá trị
    Chế độ Văn bản thành video, tham chiếu một hình ảnh, tham chiếu thành video bằng Seedance
    Thời gian chạy Quy trình gửi/trạng thái/kết quả dựa trên hàng đợi cho các tác vụ chạy lâu
    Thời gian chờ Mặc định 20 phút cho mỗi tác vụ; truy vấn trạng thái mỗi 5 giây
    Các mô hình video có sẵn

    MiniMax (mặc định):

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

    Tác nhân video HeyGen:

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

    Kling và 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

    Các yêu cầu MiniMax Live và HeyGen chỉ gửi câu lệnh cùng một hình ảnh tham chiếu tùy chọn; các ghi đè khác không được chuyển tiếp. Các mô hình Seedance chấp nhận aspectRatio, size, resolution, thời lượng từ 4 đến 15 giây và tùy chọn bật/tắt âm thanh.

    Ví dụ cấu hình Seedance 2.0
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",      },    },  },}
    Ví dụ cấu hình tham chiếu thành video bằng Seedance 2.0
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",      },    },  },}

    Chế độ tham chiếu thành video chấp nhận tối đa 9 hình ảnh, 3 video và 3 tham chiếu âm thanh thông qua các tham số dùng chung images, videosaudioRefs của video_generate, với tổng cộng tối đa 12 tệp tham chiếu. Tham chiếu âm thanh yêu cầu ít nhất một hình ảnh hoặc video tham chiếu trong cùng yêu cầu.

    Ví dụ cấu hình tác nhân video HeyGen
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/fal-ai/heygen/v2/video-agent",      },    },  },}

    Tạo âm nhạc

    Plugin fal đi kèm cũng đăng ký một provider tạo âm nhạc cho công cụ dùng chung music_generate.

    Khả năng Giá trị
    Mô hình mặc định fal/fal-ai/minimax-music/v2.6
    Các mô hình fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav)
    Thời lượng tối đa 240 giây
    Thời gian chạy Yêu cầu đồng bộ kết hợp tải xuống âm thanh đã tạo

    Dùng fal làm provider âm nhạc mặc định:

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

    fal-ai/minimax-music/v2.6 hỗ trợ lời bài hát rõ ràng và chế độ không lời, nhưng không hỗ trợ cả hai trong cùng một yêu cầu. ACE-Step và Stable Audio là các endpoint chuyển câu lệnh thành âm thanh; chọn chúng bằng ghi đè model khi bạn muốn sử dụng các dòng mô hình đó. ACE-Step từ chối lời bài hát rõ ràng; Stable Audio từ chối cả lời bài hát lẫn chế độ không lời.

    Liên quan

    Was this useful?
    On this page

    On this page