Providers
Fal
OpenClaw menyertakan provider fal bawaan untuk pembuatan gambar, video, dan musik
yang dihosting.
| Properti | Nilai |
|---|---|
| Provider | fal |
| Auth | FAL_KEY (kanonis; FAL_API_KEY juga berfungsi sebagai fallback) |
| API | endpoint model fal |
Memulai
Tetapkan kunci API
openclaw onboard --auth-choice fal-api-keyTetapkan model gambar default
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Pembuatan gambar
Provider pembuatan gambar fal bawaan menggunakan default
fal/fal-ai/flux/dev.
| Kapabilitas | Nilai |
|---|---|
| Gambar maks | 4 per permintaan; Krea 2: 1 per permintaan |
| Mode edit | Flux: 1 gambar referensi; GPT Image 2: 10; Nano Banana 2: 14 |
| Referensi gaya | Krea 2: hingga 10 referensi gaya melalui image / images |
| Override ukuran | Didukung |
| Rasio aspek | Didukung untuk generate, Krea 2, dan edit GPT Image 2/Nano Banana 2 |
| Resolusi | Didukung |
| Format output | png atau jpeg |
Model Krea 2 menggunakan skema payload Krea native milik fal. OpenClaw mengirim
aspect_ratio, creativity, dan image_style_references, bukan payload
generik image_size / endpoint edit yang digunakan oleh Flux. Ref modelnya adalah:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Gunakan Medium untuk ilustrasi ekspresif, anime, lukisan, dan gaya artistik
yang lebih cepat. Gunakan Large untuk tampilan fotorealistis, tekstur mentah, grain film, dan detail
yang lebih lambat. Default Krea adalah fal.creativity: "medium"; nilai yang didukung adalah
raw, low, medium, dan high.
Krea 2 mengekspos rasio aspek, bukan image_size, dalam skema permintaan fal. Utamakan
aspectRatio; OpenClaw memetakan size ke rasio aspek Krea terdekat yang didukung
dan menolak resolution untuk Krea alih-alih mengabaikannya.
Gunakan outputFormat: "png" saat Anda menginginkan output PNG dari model fal yang mengekspos
output_format. fal tidak mendeklarasikan kontrol latar belakang transparan
eksplisit di OpenClaw, jadi background: "transparent" dilaporkan sebagai override yang diabaikan
untuk model fal.
Endpoint Krea 2 tidak mengekspos field permintaan output_format melalui fal, jadi
OpenClaw menolak override outputFormat untuk permintaan Krea.
Untuk menggunakan fal sebagai provider gambar default:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Untuk menggunakan Krea 2 Medium:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Pembuatan video
Provider pembuatan video fal bawaan menggunakan default
fal/fal-ai/minimax/video-01-live.
| Kapabilitas | Nilai |
|---|---|
| Mode | Text-to-video, referensi satu gambar, Seedance reference-to-video |
| Runtime | Alur submit/status/result berbasis antrean untuk pekerjaan berjalan lama |
Model video yang tersedia
Agen video HeyGen:
fal/fal-ai/heygen/v2/video-agent
Seedance 2.0:
fal/bytedance/seedance-2.0/fast/text-to-videofal/bytedance/seedance-2.0/fast/image-to-videofal/bytedance/seedance-2.0/fast/reference-to-videofal/bytedance/seedance-2.0/text-to-videofal/bytedance/seedance-2.0/image-to-videofal/bytedance/seedance-2.0/reference-to-video
Contoh konfigurasi Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Contoh konfigurasi reference-to-video Seedance 2.0
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Reference-to-video menerima hingga 9 gambar, 3 video, dan 3 referensi audio
melalui parameter bersama video_generate images, videos, dan audioRefs,
dengan total maksimal 12 file referensi.
Contoh konfigurasi agen video HeyGen
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Pembuatan musik
Plugin fal bawaan juga mendaftarkan provider pembuatan musik untuk tool
bersama music_generate.
| Kapabilitas | Nilai |
|---|---|
| Model default | fal/fal-ai/minimax-music/v2.6 |
| Model | fal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio |
| Runtime | Permintaan sinkron ditambah unduhan audio yang dihasilkan |
Gunakan fal sebagai provider musik default:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6 mendukung lirik eksplisit dan mode instrumental.
ACE-Step dan Stable Audio adalah endpoint prompt-to-audio; pilih keduanya dengan override
model saat Anda menginginkan keluarga model tersebut.