Fal

OpenClaw होस्ट की गई इमेज, वीडियो और संगीत जनरेशन के लिए एक बंडल किया गया fal प्रदाता उपलब्ध कराता है।

गुण	मान
प्रदाता	`fal`
प्रमाणीकरण	`FAL_KEY` (मानक; `FAL_API_KEY` फ़ॉलबैक के रूप में भी काम करता है)
API	fal मॉडल एंडपॉइंट (`https://fal.run`; वीडियो जॉब `https://queue.fal.run` का उपयोग करते हैं)
आधार URL	`models.providers.fal.baseUrl` से ओवरराइड करें

शुरुआत करना

API कुंजी सेट करें

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

गैर-इंटरैक्टिव सेटअप --fal-api-key <key> पास कर सकते हैं या FAL_KEY एक्सपोर्ट कर सकते हैं। कोई मॉडल कॉन्फ़िगर न होने पर ऑनबोर्डिंग fal/fal-ai/flux/dev को डिफ़ॉल्ट इमेज मॉडल के रूप में भी सेट करती है।

डिफ़ॉल्ट इमेज मॉडल सेट करें

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

इमेज जनरेशन

बंडल किया गया fal इमेज-जनरेशन प्रदाता डिफ़ॉल्ट रूप से fal/fal-ai/flux/dev का उपयोग करता है।

क्षमता	मान
अधिकतम इमेज	प्रति अनुरोध 4; Krea 2: प्रति अनुरोध 1
आकार ओवरराइड	`1024x1024`, `1024x1536`, `1536x1024`, `1024x1792`, `1792x1024`
अभिमुखता अनुपात	Flux इमेज-टू-इमेज को छोड़कर हर जगह समर्थित
रिज़ॉल्यूशन	`1K`, `2K`, `4K` (प्रति-मॉडल सीमाएँ नीचे दी गई हैं)
आउटपुट प्रारूप	`png` (डिफ़ॉल्ट) या `jpeg`; Krea 2 `outputFormat` ओवरराइड अस्वीकार करता है

संपादन अनुरोध (साझा image / images पैरामीटर के माध्यम से संदर्भ इमेज) प्रति-मॉडल संदर्भ सीमाओं वाले प्रति-मॉडल संपादन एंडपॉइंट पर रूट किए जाते हैं:

मॉडल परिवार	`fal/` के बाद मॉडल संदर्भ	संपादन एंडपॉइंट	अधिकतम संदर्भ इमेज
Flux और अन्य fal मॉडल	`fal-ai/flux/dev` (डिफ़ॉल्ट)	`/image-to-image`	1
GPT Image	`openai/gpt-image-*`	`/edit`	10
Grok Imagine	`xai/grok-imagine-image`	`/edit`	3
Nano Banana (लीगेसी)	`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`	कोई नहीं (शैली संदर्भ)	10 शैली संदर्भ

Flux इमेज-टू-इमेज अनुरोध aspectRatio ओवरराइड का समर्थन नहीं करते। GPT Image और Nano Banana 2 संपादन अनुरोध fal के /edit एंडपॉइंट का उपयोग करते हैं और अभिमुखता-अनुपात संकेत स्वीकार करते हैं। Nano Banana 2 अतिरिक्त-नेटिव चौड़े/लंबे अनुपात भी स्वीकार करता है, जैसे 4:1, 1:4, 8:1, और 1:8; Krea 2 अपने छोटे अभिमुखता-अनुपात उपसमुच्चय को सत्यापित करता है। Grok Imagine की अपनी अनुपात सूची है (जिसमें 2:1, 20:9, 19.5:9, और उनके व्युत्क्रम शामिल हैं) और यह केवल 1K/2K रिज़ॉल्यूशन स्वीकार करता है; लीगेसी Nano Banana और Nano Banana 2 Lite resolution ओवरराइड अस्वीकार करते हैं।

Krea 2 मॉडल fal की नेटिव Krea पेलोड स्कीमा का उपयोग करते हैं। OpenClaw Flux द्वारा उपयोग किए जाने वाले सामान्य image_size / संपादन-एंडपॉइंट पेलोड के बजाय aspect_ratio, creativity, और image_style_references भेजता है। मॉडल संदर्भ ये हैं:

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

अधिक तेज़ अभिव्यंजक चित्रांकन, एनीमे, पेंटिंग और कलात्मक शैलियों के लिए Medium का उपयोग करें। अधिक धीमे फ़ोटोरियल, कच्चे टेक्सचर, फ़िल्म ग्रेन और विस्तृत रूपों के लिए Large का उपयोग करें। Krea डिफ़ॉल्ट रूप से fal.creativity: "medium" का उपयोग करता है; समर्थित मान raw, low, medium, और high हैं। fal की अनुरोध स्कीमा में Krea 2 image_size नहीं, बल्कि अभिमुखता अनुपात प्रदर्शित करता है। aspectRatio को प्राथमिकता दें; OpenClaw size को निकटतम समर्थित Krea अभिमुखता अनुपात से मैप करता है और Krea के लिए resolution को छोड़ने के बजाय अस्वीकार करता है। उन fal मॉडलों से PNG आउटपुट प्राप्त करने के लिए outputFormat: "png" का उपयोग करें जो output_format प्रदर्शित करते हैं। fal OpenClaw में पारदर्शी पृष्ठभूमि का कोई स्पष्ट नियंत्रण घोषित नहीं करता, इसलिए fal मॉडलों के लिए background: "transparent" को अनदेखे ओवरराइड के रूप में रिपोर्ट किया जाता है। Krea 2 एंडपॉइंट fal के माध्यम से कोई output_format अनुरोध फ़ील्ड प्रदर्शित नहीं करते, इसलिए OpenClaw Krea अनुरोधों के लिए outputFormat ओवरराइड अस्वीकार करता है। Krea 2 Medium का उपयोग करने के लिए:

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

वीडियो जनरेशन

बंडल किया गया fal वीडियो-जनरेशन प्रदाता डिफ़ॉल्ट रूप से fal/fal-ai/minimax/video-01-live का उपयोग करता है।

क्षमता	मान
मोड	टेक्स्ट-टू-वीडियो, एकल-इमेज संदर्भ, Seedance संदर्भ-टू-वीडियो
रनटाइम	लंबे समय तक चलने वाले जॉब के लिए कतार-समर्थित सबमिट/स्थिति/परिणाम प्रवाह
टाइमआउट	डिफ़ॉल्ट रूप से प्रति जॉब 20 मिनट; हर 5 सेकंड में स्थिति की जाँच

उपलब्ध वीडियो मॉडल

MiniMax (डिफ़ॉल्ट):

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

HeyGen वीडियो-एजेंट:

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

Kling और 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 और HeyGen अनुरोध केवल प्रॉम्प्ट तथा वैकल्पिक एकल संदर्भ इमेज भेजते हैं; अन्य ओवरराइड अग्रेषित नहीं किए जाते। Seedance मॉडल aspectRatio, size, resolution, 4-15 सेकंड की अवधियाँ और ऑडियो टॉगल स्वीकार करते हैं।

Seedance 2.0 कॉन्फ़िग उदाहरण

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

Seedance 2.0 संदर्भ-टू-वीडियो कॉन्फ़िग उदाहरण

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}

संदर्भ-टू-वीडियो साझा video_generate images, videos, और audioRefs पैरामीटर के माध्यम से अधिकतम 9 इमेज, 3 वीडियो और 3 ऑडियो संदर्भ स्वीकार करता है, जिसमें संदर्भ फ़ाइलों की कुल संख्या अधिकतम 12 हो सकती है। ऑडियो संदर्भों के लिए उसी अनुरोध में कम-से-कम एक इमेज या वीडियो संदर्भ आवश्यक है।

HeyGen वीडियो-एजेंट कॉन्फ़िग उदाहरण

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/fal-ai/heygen/v2/video-agent",
      },
    },
  },
}

संगीत जनरेशन

बंडल किया गया fal Plugin साझा music_generate टूल के लिए एक संगीत-जनरेशन प्रदाता भी पंजीकृत करता है।

क्षमता	मान
डिफ़ॉल्ट मॉडल	`fal/fal-ai/minimax-music/v2.6`
मॉडल	`fal-ai/minimax-music/v2.6` (mp3), `fal-ai/ace-step/prompt-to-audio` (wav), `fal-ai/stable-audio-25/text-to-audio` (wav)
अधिकतम अवधि	240 सेकंड
रनटाइम	सिंक्रोनस अनुरोध और उसके बाद जनरेट किया गया ऑडियो डाउनलोड

fal को डिफ़ॉल्ट संगीत प्रदाता के रूप में उपयोग करें:

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

fal-ai/minimax-music/v2.6 स्पष्ट गीत और वाद्य मोड का समर्थन करता है, लेकिन एक ही अनुरोध में दोनों का नहीं। ACE-Step और Stable Audio प्रॉम्प्ट-टू-ऑडियो एंडपॉइंट हैं; इन मॉडल परिवारों का उपयोग करने के लिए इन्हें model ओवरराइड से चुनें। ACE-Step स्पष्ट गीत अस्वीकार करता है; Stable Audio गीत और वाद्य मोड दोनों को अस्वीकार करता है।

ऊपर दी गई तालिकाएँ और अकॉर्डियन उन मॉडल परिवारों को समाहित करते हैं जिन्हें बंडल किया गया fal प्रदाता विशेष रूप से संभालता है। अन्य fal इमेज एंडपॉइंट आईडी को फिर भी इमेज मॉडल के रूप में चुना जा सकता है; उन्हें Flux की तरह माना जाता है (सामान्य image_size पेलोड, /image-to-image के माध्यम से एक संदर्भ इमेज)।

इमेज जनरेशन

साझा इमेज टूल पैरामीटर और प्रदाता चयन।

वीडियो जनरेशन

साझा वीडियो टूल पैरामीटर और प्रदाता चयन।

संगीत जनरेशन

साझा संगीत टूल पैरामीटर और प्रदाता चयन।

कॉन्फ़िगरेशन संदर्भ

इमेज, वीडियो और संगीत मॉडल चयन सहित एजेंट डिफ़ॉल्ट।

Overview

Concepts and configuration

Providers

शुरुआत करना

इमेज जनरेशन

वीडियो जनरेशन

संगीत जनरेशन

संबंधित

इमेज जनरेशन

वीडियो जनरेशन

संगीत जनरेशन

कॉन्फ़िगरेशन संदर्भ

​शुरुआत करना

​इमेज जनरेशन

​वीडियो जनरेशन

​संगीत जनरेशन

​संबंधित

इमेज जनरेशन

वीडियो जनरेशन

संगीत जनरेशन

कॉन्फ़िगरेशन संदर्भ

शुरुआत करना

इमेज जनरेशन

वीडियो जनरेशन

संगीत जनरेशन

संबंधित