Providers
Fal
OpenClaw, barındırılan görüntü, video ve müzik üretimi için paketle birlikte gelen bir fal sağlayıcısı sunar.
| Özellik | Değer |
|---|---|
| Sağlayıcı | fal |
| Kimlik doğrulama | FAL_KEY (kanonik; FAL_API_KEY de geri dönüş seçeneği olarak çalışır) |
| API | fal model uç noktaları (https://fal.run; video işleri https://queue.fal.run kullanır) |
| Temel URL | models.providers.fal.baseUrl ile geçersiz kılın |
Başlarken
Set the API key
openclaw onboard --auth-choice fal-api-keyEtkileşimsiz kurulumlarda --fal-api-key <key> geçirilebilir veya FAL_KEY dışa aktarılabilir.
İlk katılım işlemi, herhangi bir model yapılandırılmamışsa varsayılan görüntü modeli olarak
fal/fal-ai/flux/dev değerini de ayarlar.
Set a default image model
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Görüntü üretimi
Paketle birlikte gelen fal görüntü üretimi sağlayıcısının varsayılanı
fal/fal-ai/flux/dev modelidir.
| Yetenek | Değer |
|---|---|
| En fazla görüntü | İstek başına 4; Krea 2: istek başına 1 |
| Boyut geçersiz kılma | 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024 |
| En-boy oranı | Flux görüntüden görüntüye dışında her yerde desteklenir |
| Çözünürlük | 1K, 2K, 4K (model başına sınırlar aşağıdadır) |
| Çıktı biçimi | png (varsayılan) veya jpeg; Krea 2, outputFormat geçersiz kılmalarını reddeder |
Düzenleme istekleri (paylaşılan image / images parametreleri aracılığıyla referans görüntüler),
model başına referans sınırlarıyla model başına ayrı bir düzenleme uç noktasına yönlendirilir:
| Model ailesi | fal/ sonrasındaki model başvurusu |
Düzenleme uç noktası | En fazla referans görüntü |
|---|---|---|---|
| Flux ve diğer fal modelleri | fal-ai/flux/dev (varsayılan) |
/image-to-image |
1 |
| GPT Image | openai/gpt-image-* |
/edit |
10 |
| Grok Imagine | xai/grok-imagine-image |
/edit |
3 |
| Nano Banana (eski) | 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 |
yok (stil referansları) | 10 stil referansı |
Krea 2 modelleri fal'ın yerel Krea yük şemasını kullanır. OpenClaw, Flux tarafından
kullanılan genel image_size / düzenleme uç noktası yükü yerine aspect_ratio,
creativity ve image_style_references gönderir. Model başvuruları şunlardır:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
Daha hızlı ve etkileyici illüstrasyon, anime, resim ve sanatsal stiller için Medium
kullanın. Daha yavaş fotogerçekçi görünümler, ham dokular, film greni ve ayrıntılı
görünümler için Large kullanın. Krea'nın varsayılanı fal.creativity: "medium" değeridir;
desteklenen değerler raw, low, medium ve high değerleridir.
Krea 2, fal'ın istek şemasında image_size yerine en-boy oranını sunar. aspectRatio
kullanmayı tercih edin; OpenClaw, size değerini desteklenen en yakın Krea en-boy oranına
eşler ve Krea için resolution değerini yok saymak yerine reddeder.
output_format sunan fal modellerinden PNG çıktısı almak istediğinizde
outputFormat: "png" kullanın. fal, OpenClaw içinde açık bir şeffaf arka plan
denetimi bildirmediğinden background: "transparent", fal modelleri için yok sayılan
bir geçersiz kılma olarak bildirilir.
Krea 2 uç noktaları fal aracılığıyla bir output_format istek alanı sunmadığından
OpenClaw, Krea istekleri için outputFormat geçersiz kılmalarını reddeder.
Krea 2 Medium'u kullanmak için:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}Video üretimi
Paketle birlikte gelen fal video üretimi sağlayıcısının varsayılanı
fal/fal-ai/minimax/video-01-live modelidir.
| Yetenek | Değer |
|---|---|
| Modlar | Metinden videoya, tek görüntü referansı, Seedance referanstan videoya |
| Çalışma şekli | Uzun süren işler için kuyruk destekli gönderme/durum/sonuç akışı |
| Zaman aşımı | Varsayılan olarak iş başına 20 dakika; durum her 5 saniyede bir sorgulanır |
Available video models
MiniMax (varsayılan):
fal/fal-ai/minimax/video-01-live
HeyGen video-agent:
fal/fal-ai/heygen/v2/video-agent
Kling ve Wan:
fal/fal-ai/kling-video/v2.1/master/text-to-videofal/fal-ai/wan/v2.2-a14b/text-to-videofal/fal-ai/wan/v2.2-a14b/image-to-video
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
MiniMax Live ve HeyGen istekleri yalnızca istemi ve isteğe bağlı tek bir
referans görüntüyü gönderir; diğer geçersiz kılmalar iletilmez. Seedance modelleri
aspectRatio, size, resolution, 4-15 saniyelik süreler ve ses açma/kapatma
seçeneğini kabul eder.
Seedance 2.0 config example
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Seedance 2.0 reference-to-video config example
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Referanstan videoya modu, paylaşılan video_generate aracının images, videos
ve audioRefs parametreleri üzerinden en fazla 9 görüntü, 3 video ve 3 ses
referansını kabul eder; toplam referans dosyası sayısı en fazla 12 olabilir.
Ses referansları, aynı istekte en az bir görüntü veya video referansı gerektirir.
HeyGen video-agent config example
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Müzik üretimi
Paketle birlikte gelen fal Plugin'i, paylaşılan music_generate aracı için
bir müzik üretimi sağlayıcısını da kaydeder.
| Yetenek | Değer |
|---|---|
| Varsayılan model | fal/fal-ai/minimax-music/v2.6 |
| Modeller | fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav) |
| En fazla süre | 240 saniye |
| Çalışma şekli | Eşzamanlı istek ve ardından oluşturulan sesin indirilmesi |
fal'ı varsayılan müzik sağlayıcısı olarak kullanın:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}fal-ai/minimax-music/v2.6, açıkça belirtilen şarkı sözlerini ve enstrümantal modu
destekler ancak ikisini aynı istekte desteklemez. ACE-Step ve Stable Audio,
istemden sese uç noktalarıdır; bu model ailelerini istediğinizde model geçersiz
kılmasıyla bunları seçin. ACE-Step açıkça belirtilen şarkı sözlerini reddeder;
Stable Audio ise hem şarkı sözlerini hem de enstrümantal modu reddeder.
İlgili içerikler
Paylaşılan görüntü aracı parametreleri ve sağlayıcı seçimi.
Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.
Paylaşılan müzik aracı parametreleri ve sağlayıcı seçimi.
Görüntü, video ve müzik modeli seçimi dâhil agent varsayılanları.