Providers

Fal

يأتي OpenClaw مع provider مضمّن باسم fal لإنشاء الصور والفيديو المستضاف.

الخاصية القيمة
Provider fal
المصادقة FAL_KEY (القياسي؛ ويعمل FAL_API_KEY أيضًا كخيار fallback)
API نقاط نهاية models الخاصة بـ fal

البدء

  • اضبط API key

    openclaw onboard --auth-choice fal-api-key
    
  • اضبط model افتراضيًا للصور

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    
  • إنشاء الصور

    يستخدم provider المضمّن fal لإنشاء الصور القيمة الافتراضية fal/fal-ai/flux/dev.

    capability القيمة
    الحد الأقصى للصور 4 لكل طلب
    وضع التحرير مفعّل، صورة مرجعية واحدة
    تجاوزات الحجم مدعومة
    نسبة الأبعاد مدعومة
    الدقة مدعومة
    تنسيق الإخراج png أو jpeg

    استخدم outputFormat: "png" عندما تريد إخراجًا بصيغة PNG. لا يعرّف fal عنصر تحكم صريحًا للخلفية الشفافة في OpenClaw، لذا تُبلَّغ القيمة background: "transparent" على أنها تجاوز تم تجاهله في models الخاصة بـ fal.

    لاستخدام fal بوصفه provider الافتراضي للصور:

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

    إنشاء الفيديو

    يستخدم provider المضمّن fal لإنشاء الفيديو القيمة الافتراضية fal/fal-ai/minimax/video-01-live.

    capability القيمة
    الأوضاع نص إلى فيديو، وصورة مرجعية واحدة، وreference-to-video في Seedance
    runtime تدفق submit/status/result معتمد على قائمة انتظار للمهام طويلة التشغيل
    Models الفيديو المتاحة

    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
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
          },
        },
      },
    }
    
    مثال إعداد Seedance 2.0 reference-to-video
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
          },
        },
      },
    }
    

    يقبل reference-to-video حتى 9 صور و3 فيديوهات و3 مراجع صوتية عبر معاملات images وvideos وaudioRefs المشتركة في video_generate، بحد أقصى 12 ملفًا مرجعيًا إجمالًا.

    مثال إعداد HeyGen video-agent
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/fal-ai/heygen/v2/video-agent",
          },
        },
      },
    }
    

    ذو صلة