Providers

Fal

OpenClaw یک ارائه‌دهندهٔ bundled با نام fal برای تولید تصویر و ویدیوی میزبانی‌شده ارائه می‌کند.

ویژگی مقدار
ارائه‌دهنده fal
احراز هویت FAL_KEY (اصلی؛ FAL_API_KEY نیز به‌عنوان fallback کار می‌کند)
API نقاط پایانی مدل fal

شروع به کار

  • تنظیم کلید API

    openclaw onboard --auth-choice fal-api-key
    
  • تنظیم مدل تصویر پیش‌فرض

    {
      agents: {
        defaults: {
          imageGenerationModel: {
            primary: "fal/fal-ai/flux/dev",
          },
        },
      },
    }
    
  • تولید تصویر

    ارائه‌دهندهٔ bundled تولید تصویر fal به‌طور پیش‌فرض از fal/fal-ai/flux/dev استفاده می‌کند.

    قابلیت مقدار
    حداکثر تصاویر 4 در هر درخواست
    حالت ویرایش فعال، 1 تصویر مرجع
    overrideهای اندازه پشتیبانی می‌شود
    نسبت تصویر پشتیبانی می‌شود
    وضوح پشتیبانی می‌شود
    قالب خروجی png یا jpeg

    وقتی خروجی PNG می‌خواهید، از outputFormat: "png" استفاده کنید. fal در OpenClaw کنترل صریحی برای پس‌زمینهٔ شفاف اعلام نمی‌کند، بنابراین background: "transparent" برای مدل‌های fal به‌عنوان override نادیده‌گرفته‌شده گزارش می‌شود.

    برای استفاده از fal به‌عنوان ارائه‌دهندهٔ تصویر پیش‌فرض:

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

    تولید ویدیو

    ارائه‌دهندهٔ bundled تولید ویدیوی fal به‌طور پیش‌فرض از fal/fal-ai/minimax/video-01-live استفاده می‌کند.

    قابلیت مقدار
    حالت‌ها متن به ویدیو، مرجع تک‌تصویری، مرجع به ویدیو Seedance
    زمان اجرا جریان ارسال/وضعیت/نتیجه مبتنی بر صف برای کارهای طولانی‌مدت
    مدل‌های ویدیویی موجود

    video-agent از HeyGen:

    • 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
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/bytedance/seedance-2.0/fast/reference-to-video",
          },
        },
      },
    }
    

    مرجع به ویدیو از طریق پارامترهای مشترک video_generate، یعنی images، videos و audioRefs، تا 9 تصویر، 3 ویدیو و 3 مرجع صوتی را می‌پذیرد، با حداکثر 12 فایل مرجع در مجموع.

    نمونه پیکربندی video-agent از HeyGen
    {
      agents: {
        defaults: {
          videoGenerationModel: {
            primary: "fal/fal-ai/heygen/v2/video-agent",
          },
        },
      },
    }
    

    مرتبط