Providers
Fal
يوفر OpenClaw موفر fal مضمنا لتوليد الصور والفيديو والموسيقى
المستضافة.
| الخاصية | القيمة |
|---|---|
| الموفر | fal |
| المصادقة | FAL_KEY (أساسي؛ يعمل FAL_API_KEY أيضا كاحتياطي) |
| API | نقاط نهاية نماذج fal |
بدء الاستخدام
عيّن مفتاح API
openclaw onboard --auth-choice fal-api-keyعيّن نموذج صور افتراضيا
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}توليد الصور
يعتمد موفر توليد الصور fal المضمن افتراضيا على
fal/fal-ai/flux/dev.
| القدرة | القيمة |
|---|---|
| الحد الأقصى للصور | 4 لكل طلب؛ Krea 2: صورة واحدة لكل طلب |
| وضع التحرير | Flux: صورة مرجعية واحدة؛ GPT Image 2: 10؛ Nano Banana 2: 14 |
| مراجع الأسلوب | Krea 2: ما يصل إلى 10 مراجع أسلوب عبر image / images |
| تجاوزات الحجم | مدعومة |
| نسبة العرض إلى الارتفاع | مدعومة للتوليد، وKrea 2، وتحرير GPT Image 2/Nano Banana 2 |
| الدقة | مدعومة |
| تنسيق الإخراج | png أو jpeg |
تستخدم نماذج Krea 2 مخطط حمولة Krea الأصلي في fal. يرسل OpenClaw
aspect_ratio وcreativity وimage_style_references بدلا من حمولة
image_size العامة / نقطة نهاية التحرير التي يستخدمها Flux. مراجع النماذج هي:
fal/krea/v2/medium/text-to-imagefal/krea/v2/large/text-to-image
استخدم Medium للرسم التعبيري الأسرع، والأنمي، والتلوين، والأساليب الفنية.
واستخدم Large للحصول على مظهر فوتوغرافي واقعي أبطأ، وملمس خام، وحبيبات فيلم، وتفاصيل
أدق. القيمة الافتراضية في Krea هي fal.creativity: "medium"؛ والقيم المدعومة هي
raw وlow وmedium وhigh.
يعرض Krea 2 نسبة العرض إلى الارتفاع، لا image_size، في مخطط طلب fal. فضّل
aspectRatio؛ يطابق OpenClaw قيمة size مع أقرب نسبة عرض إلى ارتفاع مدعومة في Krea
ويرفض resolution مع Krea بدلا من إسقاطه.
استخدم outputFormat: "png" عندما تريد إخراج PNG من نماذج fal التي تعرض
output_format. لا يعلن fal عن تحكم صريح في الخلفية الشفافة
ضمن OpenClaw، لذلك يتم الإبلاغ عن background: "transparent" كتجاوز متجاهل
لنماذج fal.
لا تعرض نقاط نهاية Krea 2 حقل طلب output_format عبر fal، لذلك
يرفض OpenClaw تجاوزات outputFormat لطلبات Krea.
لاستخدام fal كموفر الصور الافتراضي:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/fal-ai/flux/dev", }, }, },}لاستخدام Krea 2 Medium:
{ agents: { defaults: { imageGenerationModel: { primary: "fal/krea/v2/medium/text-to-image", }, }, },}توليد الفيديو
يعتمد موفر توليد الفيديو fal المضمن افتراضيا على
fal/fal-ai/minimax/video-01-live.
| القدرة | القيمة |
|---|---|
| الأوضاع | نص إلى فيديو، مرجع صورة واحدة، Seedance مرجع إلى فيديو |
| وقت التشغيل | تدفق إرسال/حالة/نتيجة مدعوم بطابور للمهام طويلة التشغيل |
نماذج الفيديو المتاحة
HeyGen video-agent:
fal/fal-ai/heygen/v2/video-agent
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
مثال إعداد 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", }, }, },}يقبل المرجع إلى الفيديو ما يصل إلى 9 صور، و3 فيديوهات، و3 مراجع صوتية
عبر معاملات video_generate المشتركة images وvideos وaudioRefs
بإجمالي لا يتجاوز 12 ملفا مرجعيا.
مثال إعداد HeyGen video-agent
{ agents: { defaults: { videoGenerationModel: { primary: "fal/fal-ai/heygen/v2/video-agent", }, }, },}توليد الموسيقى
يسجل Plugin fal المضمن أيضا موفر توليد موسيقى لأداة
music_generate المشتركة.
| القدرة | القيمة |
|---|---|
| النموذج الافتراضي | fal/fal-ai/minimax-music/v2.6 |
| النماذج | fal-ai/minimax-music/v2.6, fal-ai/ace-step/prompt-to-audio, fal-ai/stable-audio-25/text-to-audio |
| وقت التشغيل | طلب متزامن بالإضافة إلى تنزيل الصوت المولد |
استخدم fal كموفر الموسيقى الافتراضي:
{ agents: { defaults: { musicGenerationModel: { primary: "fal/fal-ai/minimax-music/v2.6", }, }, },}يدعم fal-ai/minimax-music/v2.6 كلمات صريحة ووضعا آليا.
ACE-Step وStable Audio هما نقطتا نهاية لتحويل المطالبة إلى صوت؛ اخترهما باستخدام
تجاوز model عندما تريد عائلات النماذج هذه.