Providers
Fal
OpenClaw, barındırılan görüntü, video ve müzik üretimi için paketlenmiş bir fal sağlayıcısıyla birlikte gelir.
| Özellik | Değer |
|---|---|
| Sağlayıcı | fal |
| Kimlik doğrulama | FAL_KEY (standart; FAL_API_KEY yedek olarak da ç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
API anahtarını ayarlayın
openclaw onboard --auth-choice fal-api-keyEtkileşimsiz kurulumlar --fal-api-key <key> iletebilir veya FAL_KEY dışa aktarabilir.
İlk katılım, yapılandırılmış bir model olmadığında fal/fal-ai/flux/dev değerini
varsayılan görüntü modeli olarak da ayarlar.
Varsayılan görüntü modelini ayarlayın
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}Görüntü üretimi
Paketlenmiş fal görüntü üretimi sağlayıcısının varsayılanı
fal/fal-ai/flux/dev değeridir.
| Yetenek | Değer |
|---|---|
| En fazla görüntü | İstek başına 4; Krea 2: istek başına 1 |
| Boyut geçersiz kılmaları | 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ı bulunan model bazlı 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ı, etkileyici illüstrasyonlar, anime, resim ve sanatsal
stiller için Medium kullanın. Daha yavaş, fotogerçekçi, ham dokulu, film grenli 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 değil, en-boy oranı sunar.
aspectRatio tercih edin; OpenClaw, size değerini desteklenen en yakın Krea en-boy oranıyla eşler
ve Krea için resolution değerini yok saymak yerine reddeder.
output_format sunan fal modellerinden PNG çıktısı istediğinizde
outputFormat: "png" kullanın. fal, OpenClaw'da açık bir şeffaf arka plan
denetimi bildirmez; bu nedenle background: "transparent", fal modelleri için yok sayılan bir
geçersiz kılma olarak bildirilir.
Krea 2 uç noktaları fal üzerinden bir output_format istek alanı sunmaz; bu nedenle
OpenClaw, Krea isteklerinde 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
Paketlenmiş fal video üretimi sağlayıcısının varsayılanı
fal/fal-ai/minimax/video-01-live değeridir.
| Yetenek | Değer |
|---|---|
| Modlar | Metinden videoya, tek görüntü referansı, Seedance referanstan videoya |
| Çalışma zamanı | 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 |
Kullanılabilir video modelleri
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
bir ses açma/kapatma seçeneğini kabul eder.
Seedance 2.0 yapılandırma örneği
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/text-to-video", }, }, },}Seedance 2.0 referanstan videoya yapılandırma örneği
{ agents: { defaults: { videoGenerationModel: { primary: "fal/bytedance/seedance-2.0/fast/reference-to-video", }, }, },}Referanstan videoya modu, paylaşılan video_generate images, videos ve audioRefs
parametreleri aracılığıyla en fazla 9 görüntü, 3 video ve 3 ses referansını,
toplamda en fazla 12 referans dosyası olacak şekilde kabul eder. Ses referansları, aynı istekte
en az bir görüntü veya video referansı gerektirir.
HeyGen video-agent yapılandırma örneği
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}Müzik üretimi
Paketlenmiş fal plugin'i, paylaşılan
music_generate aracı için bir müzik üretimi sağlayıcısı 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 zamanı | Eşzamanlı istek ve ardından üretilen 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 ş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 ş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ı.