Chuyển đến nội dung chính
OpenClaw cung cấp một provider fal được đóng gói sẵn để tạo hình ảnh, video và nhạc được lưu trữ.
Thuộc tínhGiá trị
Providerfal
Xác thựcFAL_KEY (chuẩn; FAL_API_KEY cũng hoạt động như phương án dự phòng)
APIendpoint mô hình fal

​
Bắt đầu

1

Đặt API key

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

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

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

​
Tạo hình ảnh

Provider tạo hình ảnh fal được đóng gói sẵn mặc định là fal/fal-ai/flux/dev.
Khả năngGiá trị
Số hình ảnh tối đa4 mỗi yêu cầu; Krea 2: 1 mỗi yêu cầu
Chế độ chỉnh sửaFlux: 1 hình ảnh tham chiếu; GPT Image 2: 10; Nano Banana 2: 14
Tham chiếu phong cáchKrea 2: tối đa 10 tham chiếu phong cách qua image / images
Ghi đè kích thướcĐược hỗ trợ
Tỷ lệ khung hìnhĐược hỗ trợ cho tạo mới, Krea 2 và chỉnh sửa GPT Image 2/Nano Banana 2
Độ phân giảiĐược hỗ trợ
Định dạng đầu rapng hoặc jpeg
Các yêu cầu hình-ảnh-sang-hình-ảnh của Flux không hỗ trợ ghi đè aspectRatio. Các yêu cầu chỉnh sửa GPT Image 2 và Nano Banana 2 dùng endpoint /edit của fal và chấp nhận gợi ý tỷ lệ khung hình. Nano Banana 2 cũng chấp nhận các tỷ lệ rộng/cao native bổ sung như 4:1, 1:4, 8:1 và 1:8; Krea 2 xác thực tập con tỷ lệ khung hình nhỏ hơn của riêng nó.
Các mô hình Krea 2 dùng schema payload Krea native của fal. OpenClaw gửi aspect_ratio, creativity và image_style_references thay vì payload image_size / endpoint chỉnh sửa chung mà Flux 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 minh họa biểu cảm, anime, tranh vẽ và phong cách nghệ thuật nhanh hơn. Dùng Large cho hình ảnh photoreal chậm hơn, texture thô, hạt phim và diện mạo chi tiết. Krea mặc định là fal.creativity: "medium"; các giá trị được hỗ trợ là raw, low, medium và high. Krea 2 hiển thị tỷ lệ khung hình, không phải image_size, trong schema yêu cầu của fal. Ưu tiên aspectRatio; OpenClaw ánh xạ size tới tỷ lệ khung hình Krea được hỗ trợ gần nhất và từ chối resolution cho Krea thay vì bỏ qua nó. Dùng outputFormat: "png" khi bạn muốn đầu ra PNG từ các mô hình fal có output_format. fal không khai báo điều khiển nền trong suốt rõ ràng trong OpenClaw, nên background: "transparent" được báo cáo là một ghi đè bị bỏ qua cho các mô hình fal. Các endpoint Krea 2 không hiển thị trường yêu cầu output_format qua fal, nên OpenClaw từ chối ghi đè outputFormat cho các yêu cầu Krea. Để dùng fal làm provider hình ảnh mặc định: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/fal-ai/flux/dev",
      },
    },
  },
}
Để dùng Krea 2 Medium: 
{
  agents: {
    defaults: {
      imageGenerationModel: {
        primary: "fal/krea/v2/medium/text-to-image",
      },
    },
  },
}

​
Tạo video

Provider tạo video fal được đóng gói sẵn mặc định là fal/fal-ai/minimax/video-01-live.
Khả năngGiá trị
Chế độText-to-video, tham chiếu một hình ảnh, Seedance reference-to-video
RuntimeLuồng gửi/trạng thái/kết quả dựa trên hàng đợi cho tác vụ chạy lâu
HeyGen video-agent:
  • fal/fal-ai/heygen/v2/video-agent
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
{
  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",
      },
    },
  },
}
Reference-to-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ố images, videos và audioRefs dùng chung của video_generate, với tổng cộng tối đa 12 tệp tham chiếu.
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

​
Tạo nhạc

Plugin fal được đóng gói sẵn cũng đăng ký một provider tạo nhạc cho công cụ music_generate dùng chung.
Khả năngGiá trị
Mô hình mặc địnhfal/fal-ai/minimax-music/v2.6
Mô hìnhfal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio
RuntimeYêu cầu đồng bộ cộng với tải xuống âm thanh đã tạo
Dùng fal làm provider nhạc mặc định: 
{
  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ế độ nhạc không lời. ACE-Step và Stable Audio là các endpoint prompt-to-audio; chọn chúng bằng ghi đè model khi bạn muốn dùng các họ mô hình đó.
Dùng openclaw models list --provider fal để xem danh sách đầy đủ các mô hình fal có sẵn, bao gồm mọi mục được thêm gần đây.

​
Liên quan

Tạo hình ảnh

Tham số công cụ hình ảnh dùng chung và lựa chọn provider.

Tạo video

Tham số công cụ video dùng chung và lựa chọn provider.

Tạo nhạc

Tham số công cụ nhạc dùng chung và lựa chọn provider.

Tham chiếu cấu hình

Mặc định của agent bao gồm lựa chọn mô hình hình ảnh, video và nhạc.