OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Providers

Salah

OpenClaw menyertakan provider fal bawaan untuk pembuatan gambar, video, dan musik yang dihosting.

Properti Nilai
Provider fal
Autentikasi FAL_KEY (kanonis; FAL_API_KEY juga berfungsi sebagai cadangan)
API Endpoint model fal (https://fal.run; tugas video menggunakan https://queue.fal.run)
URL dasar Timpa dengan models.providers.fal.baseUrl

Memulai

  • Tetapkan kunci API

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

    Penyiapan noninteraktif dapat meneruskan --fal-api-key <key> atau mengekspor FAL_KEY. Proses orientasi juga menetapkan fal/fal-ai/flux/dev sebagai model gambar default jika belum ada yang dikonfigurasi.

  • Tetapkan model gambar default

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

    • Pembuatan gambar

    Provider pembuatan gambar fal bawaan menggunakan fal/fal-ai/flux/dev secara default.

    Kemampuan Nilai
    Gambar maksimum 4 per permintaan; Krea 2: 1 per permintaan
    Penimpaan ukuran 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024
    Rasio aspek Didukung di semua tempat kecuali gambar-ke-gambar Flux
    Resolusi 1K, 2K, 4K (batas per model di bawah)
    Format keluaran png (default) atau jpeg; Krea 2 menolak penimpaan outputFormat

    Permintaan pengeditan (gambar referensi melalui parameter bersama image / images) diarahkan ke endpoint pengeditan per model dengan batas referensi per model:

    Keluarga model Referensi model setelah fal/ Endpoint pengeditan Gambar referensi maksimum
    Flux dan model fal lainnya fal-ai/flux/dev (default) /image-to-image 1
    GPT Image openai/gpt-image-* /edit 10
    Grok Imagine xai/grok-imagine-image /edit 3
    Nano Banana (lama) 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 tidak ada (referensi gaya) 10 referensi gaya

    Model Krea 2 menggunakan skema payload Krea native milik fal. OpenClaw mengirim aspect_ratio, creativity, dan image_style_references, bukan payload image_size / endpoint pengeditan generik yang digunakan oleh Flux. Referensi modelnya adalah:

    • fal/krea/v2/medium/text-to-image
    • fal/krea/v2/large/text-to-image

    Gunakan Medium untuk ilustrasi ekspresif, anime, lukisan, dan gaya artistik yang lebih cepat. Gunakan Large untuk hasil fotorealistis, tekstur mentah, butiran film, dan tampilan mendetail yang lebih lambat. Krea menggunakan fal.creativity: "medium" secara default; 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" ketika Anda menginginkan keluaran PNG dari model fal yang mengekspos output_format. fal tidak mendeklarasikan kontrol latar belakang transparan secara eksplisit di OpenClaw, sehingga background: "transparent" dilaporkan sebagai penimpaan yang diabaikan untuk model fal. Endpoint Krea 2 tidak mengekspos bidang permintaan output_format melalui fal, sehingga OpenClaw menolak penimpaan outputFormat untuk permintaan Krea.

    Untuk menggunakan Krea 2 Medium:

    json5
    {  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/krea/v2/medium/text-to-image",      },    },  },}

    Pembuatan video

    Provider pembuatan video fal bawaan menggunakan fal/fal-ai/minimax/video-01-live secara default.

    Kemampuan Nilai
    Mode Teks-ke-video, referensi satu gambar, referensi-ke-video Seedance
    Waktu proses Alur pengiriman/status/hasil berbasis antrean untuk tugas berdurasi panjang
    Batas waktu 20 menit per tugas secara default; status diperiksa setiap 5 detik
    Model video yang tersedia

    MiniMax (default):

    • fal/fal-ai/minimax/video-01-live

    Agen video HeyGen:

    • fal/fal-ai/heygen/v2/video-agent

    Kling dan 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

    Permintaan MiniMax Live dan HeyGen hanya mengirim prompt beserta satu gambar referensi opsional; penimpaan lainnya tidak diteruskan. Model Seedance menerima aspectRatio, size, resolution, durasi 4–15 detik, dan pengalih audio.

    Contoh konfigurasi Seedance 2.0
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",      },    },  },}
    Contoh konfigurasi referensi-ke-video Seedance 2.0
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",      },    },  },}

    Referensi-ke-video menerima hingga 9 gambar, 3 video, dan 3 referensi audio melalui parameter bersama images, videos, dan audioRefs milik video_generate, dengan maksimum 12 berkas referensi secara keseluruhan. Referensi audio memerlukan setidaknya satu referensi gambar atau video dalam permintaan yang sama.

    Contoh konfigurasi agen video HeyGen
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/fal-ai/heygen/v2/video-agent",      },    },  },}

    Pembuatan musik

    Plugin fal bawaan juga mendaftarkan provider pembuatan musik untuk alat bersama music_generate.

    Kemampuan Nilai
    Model default fal/fal-ai/minimax-music/v2.6
    Model fal-ai/minimax-music/v2.6 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav)
    Durasi maksimum 240 detik
    Waktu proses Permintaan sinkron beserta pengunduhan audio yang dihasilkan

    Gunakan fal sebagai provider musik default:

    json5
    {  agents: {    defaults: {      musicGenerationModel: {        primary: "fal/fal-ai/minimax-music/v2.6",      },    },  },}

    fal-ai/minimax-music/v2.6 mendukung lirik eksplisit dan mode instrumental, tetapi tidak keduanya dalam permintaan yang sama. ACE-Step dan Stable Audio adalah endpoint prompt-ke-audio; pilih endpoint tersebut dengan penimpaan model ketika Anda menginginkan keluarga model tersebut. ACE-Step menolak lirik eksplisit; Stable Audio menolak lirik maupun mode instrumental.

    Terkait

    Pembuatan gambar

    Parameter alat gambar bersama dan pemilihan provider.
    Pembuatan video

    Parameter alat video bersama dan pemilihan provider.
    Pembuatan musik

    Parameter alat musik bersama dan pemilihan provider.
    Referensi konfigurasi

    Default agen, termasuk pemilihan model gambar, video, dan musik.
    Was this useful?
    On this page

    On this page