Fal

يوفّر OpenClaw مزوّد fal مضمّنًا لتوليد الصور ومقاطع الفيديو والموسيقى عبر خدمات مستضافة.

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

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

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

توليد الصور

يستخدم مزوّد توليد الصور fal المضمّن fal/fal-ai/flux/dev افتراضيًا.

تُوجَّه طلبات التحرير (الصور المرجعية عبر معاملي image / images المشتركين) إلى نقطة نهاية تحرير خاصة بكل نموذج، مع حدود مراجع خاصة بكل نموذج:

تستخدم نماذج 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.

لاستخدام Krea 2 Medium:

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

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

يستخدم مزوّد توليد الفيديو fal المضمّن fal/fal-ai/minimax/video-01-live افتراضيًا.

{  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",      },    },  },}

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

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

يسجّل Plugin ‏fal المضمّن أيضًا مزوّدًا لتوليد الموسيقى لأداة music_generate المشتركة.

استخدم 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 كلًا من كلمات الأغنية ووضع الموسيقى الآلية.

ذو صلة