Providers

Fal

OpenClaw постачається з вбудованим провайдером fal для хостингової генерації зображень, відео та музики.

Властивість Значення
Провайдер fal
Автентифікація FAL_KEY (канонічний; FAL_API_KEY також працює як fallback)
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: 1 на запит
    Режим редагування Flux: 1 еталонне зображення; GPT Image 2: 10; Nano Banana 2: 14
    Еталони стилю Krea 2: до 10 еталонів стилю через image / images
    Перевизначення розміру Підтримується
    Співвідношення сторін Підтримується для generate, Krea 2, а також редагування GPT Image 2/Nano Banana 2
    Роздільна здатність Підтримується
    Формат виводу png або jpeg

    Моделі Krea 2 використовують нативну схему payload Krea від fal. OpenClaw надсилає aspect_ratio, creativity та image_style_references замість загального image_size / payload кінцевої точки редагування, який використовує 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 у схемі запиту fal надає співвідношення сторін, а не image_size. Віддавайте перевагу 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.

    Можливість Значення
    Режими Text-to-video, еталон одного зображення, Seedance reference-to-video
    Середовище виконання Потік submit/status/result на основі черги для довготривалих завдань
    Доступні моделі відео

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

    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 є кінцевими точками prompt-to-audio; вибирайте їх за допомогою перевизначення model, коли потрібні ці сімейства моделей.

    Пов’язане

    Was this useful?
    On this page

    On this page