Providers

Fal

يوفر OpenClaw موفر fal مضمنا لتوليد الصور والفيديو والموسيقى المستضافة.

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

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

  • عيّن مفتاح API

    bash
    openclaw onboard --auth-choice fal-api-key
  • عيّن نموذج صور افتراضيا

    json5
    {  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-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 كموفر الصور الافتراضي:

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

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

    json5
    {  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
    مثال إعداد Seedance 2.0
    json5
    {  agents: {    defaults: {      videoGenerationModel: {        primary: "fal/bytedance/seedance-2.0/fast/text-to-video",      },    },  },}
    مثال إعداد Seedance 2.0 للمرجع إلى الفيديو
    json5
    {  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
    json5
    {  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 كموفر الموسيقى الافتراضي:

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

    يدعم fal-ai/minimax-music/v2.6 كلمات صريحة ووضعا آليا. ACE-Step وStable Audio هما نقطتا نهاية لتحويل المطالبة إلى صوت؛ اخترهما باستخدام تجاوز model عندما تريد عائلات النماذج هذه.

    ذات صلة

    Was this useful?
    On this page

    On this page