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

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

    Etkileş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

    json5
    {  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-image
    • fal/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:

    json5
    {  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-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

    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
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",      },    },  },}
    Seedance 2.0 reference-to-video config example
    json5
    {  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
    json5
    {  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:

    json5
    {  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

    Was this useful?
    On this page

    On this page