Providers

Fal

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

Властивість Значення
Провайдер fal
Автентифікація FAL_KEY (основний; FAL_API_KEY також працює як резервний варіант)
API кінцеві точки моделей fal (https://fal.run; відеозавдання використовують https://queue.fal.run)
Базова URL-адреса Перевизначається за допомогою models.providers.fal.baseUrl

Початок роботи

  • Установіть ключ API

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

    Для неінтерактивного налаштування можна передати --fal-api-key <key> або експортувати FAL_KEY. Під час початкового налаштування також установлюється fal/fal-ai/flux/dev як модель зображень за замовчуванням, якщо жодної моделі не налаштовано.

  • Установіть модель зображень за замовчуванням

    json5
    {  agents: {    defaults: {      imageGenerationModel: {        primary: "fal/fal-ai/flux/dev",      },    },  },}
  • Генерація зображень

    Вбудований провайдер fal для генерації зображень за замовчуванням використовує fal/fal-ai/flux/dev.

    Можливість Значення
    Максимум зображень 4 на запит; Krea 2: 1 на запит
    Перевизначення розміру 1024x1024, 1024x1536, 1536x1024, 1024x1792, 1792x1024
    Співвідношення сторін Підтримується всюди, крім перетворення зображення на зображення у Flux
    Роздільна здатність 1K, 2K, 4K (обмеження для кожної моделі наведено нижче)
    Формат виведення png (за замовчуванням) або jpeg; Krea 2 відхиляє перевизначення outputFormat

    Запити на редагування (еталонні зображення через спільні параметри image / images) спрямовуються до окремої кінцевої точки редагування для кожної моделі з відповідними обмеженнями кількості еталонів:

    Сімейство моделей Посилання на модель після fal/ Кінцева точка редагування Максимум еталонних зображень
    Flux та інші моделі fal fal-ai/flux/dev (за замовчуванням) /image-to-image 1
    GPT Image openai/gpt-image-* /edit 10
    Grok Imagine xai/grok-imagine-image /edit 3
    Nano Banana (застаріла) fal-ai/nano-banana /edit 3
    Nano Banana 2 fal-ai/nano-banana-* /edit 14
    Nano Banana 2 Lite google/nano-banana-2-lite /edit 14
    Krea 2 krea/v2/{medium,large}/text-to-image немає (еталони стилю) 10 еталонів стилю

    Моделі 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.

    У схемі запиту fal Krea 2 надає співвідношення сторін, а не 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.

    Щоб використовувати Krea 2 Medium:

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

    Генерація відео

    Вбудований провайдер fal для генерації відео за замовчуванням використовує fal/fal-ai/minimax/video-01-live.

    Можливість Значення
    Режими Текст у відео, одне еталонне зображення, еталони у відео Seedance
    Виконання Потік надсилання, перевірки стану й отримання результату через чергу для тривалих завдань
    Час очікування За замовчуванням 20 хвилин на завдання; стан перевіряється кожні 5 секунд
    Доступні моделі відео

    MiniMax (за замовчуванням):

    • fal/fal-ai/minimax/video-01-live

    Відеоагент HeyGen:

    • fal/fal-ai/heygen/v2/video-agent

    Kling і Wan:

    • fal/fal-ai/kling-video/v2.1/master/text-to-video
    • fal/fal-ai/wan/v2.2-a14b/text-to-video
    • fal/fal-ai/wan/v2.2-a14b/image-to-video

    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

    Запити MiniMax Live і HeyGen надсилають лише підказку та необов’язкове одне еталонне зображення; інші перевизначення не передаються. Моделі Seedance приймають aspectRatio, size, resolution, тривалість від 4 до 15 секунд і перемикач аудіо.

    Приклад конфігурації 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 аудіоеталонів через спільні параметри images, videos і audioRefs інструмента video_generate, але не більше 12 еталонних файлів загалом. Для аудіоеталонів потрібен принаймні один еталон зображення або відео в тому самому запиті.

    Приклад конфігурації відеоагента HeyGen
    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 (mp3), fal-ai/ace-step/prompt-to-audio (wav), fal-ai/stable-audio-25/text-to-audio (wav)
    Максимальна тривалість 240 секунд
    Виконання Синхронний запит із подальшим завантаженням згенерованого аудіо

    Щоб використовувати fal як провайдер музики за замовчуванням:

    json5
    {  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 відхиляє і текст пісні, і інструментальний режим.

    Пов’язані матеріали

    Was this useful?
    On this page

    On this page