Providers
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 शैली संदर्भ |
Krea 2 मॉडल fal की नेटिव Krea पेलोड स्कीमा का उपयोग करते हैं। OpenClaw
Flux द्वारा उपयोग किए जाने वाले सामान्य image_size / संपादन-एंडपॉइंट पेलोड के बजाय
aspect_ratio, creativity, और image_style_references भेजता है। मॉडल संदर्भ ये हैं:
fal/krea/v2/medium/text-to-imagefal/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-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 और 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
गीत और वाद्य मोड दोनों को अस्वीकार करता है।