الانتقال إلى المحتوى الرئيسي
يوفر OpenClaw موفر fal مضمنا لتوليد الصور والفيديو والموسيقى المستضافة.
الخاصيةالقيمة
الموفرfal
المصادقةFAL_KEY (أساسي؛ يعمل FAL_API_KEY أيضا كاحتياطي)
APIنقاط نهاية نماذج fal

​
بدء الاستخدام

1

عيّن مفتاح API

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

عيّن نموذج صور افتراضيا

{
  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
طلبات تحويل الصور إلى صور في Flux لا تدعم تجاوزات aspectRatio. تستخدم طلبات تحرير GPT Image 2 وNano Banana 2 نقطة النهاية /edit في fal وتقبل تلميحات نسبة العرض إلى الارتفاع. يقبل Nano Banana 2 أيضا نسبا عريضة/طويلة أصلية إضافية مثل 4:1 و1:4 و8:1 و1:8؛ ويتحقق Krea 2 من مجموعته الفرعية الأصغر لنسب العرض إلى الارتفاع.
تستخدم نماذج Krea 2 مخطط حمولة Krea الأصلي في fal. يرسل OpenClaw aspect_ratio وcreativity وimage_style_references بدلا من حمولة image_size العامة / نقطة نهاية التحرير التي يستخدمها Flux. مراجع النماذج هي:
  • fal/krea/v2/medium/text-to-image
  • fal/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-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
{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
      },
    },
  },
}

{
  agents: {
    defaults: {
      videoGenerationModel: {
        primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
      },
    },
  },
}
يقبل المرجع إلى الفيديو ما يصل إلى 9 صور، و3 فيديوهات، و3 مراجع صوتية عبر معاملات video_generate المشتركة images وvideos وaudioRefs بإجمالي لا يتجاوز 12 ملفا مرجعيا.
{
  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 عندما تريد عائلات النماذج هذه.
استخدم openclaw models list --provider fal للاطلاع على القائمة الكاملة لنماذج fal المتاحة، بما في ذلك أي إدخالات أضيفت حديثا.

​
ذات صلة

توليد الصور

معاملات أداة الصور المشتركة واختيار الموفر.

توليد الفيديو

معاملات أداة الفيديو المشتركة واختيار الموفر.

توليد الموسيقى

معاملات أداة الموسيقى المشتركة واختيار الموفر.

مرجع الإعدادات

الإعدادات الافتراضية للوكلاء بما في ذلك اختيار نماذج الصور والفيديو والموسيقى.