openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-11 01:40:23 +00:00
parent 0e474dcea6
commit c61b0422ec
2 changed files with 127 additions and 107 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
docs/uk/providers/fal.md
View File

@ -1,22 +1,22 @@
---
read_when:
- Ви хочете використовувати генерацію зображень fal в OpenClaw
- Вам потрібен потік автентифікації FAL_KEY
- Ви хочете використовувати типові значення fal для image_generate або video_generate
summary: Налаштування генерації зображень і відео fal в OpenClaw
- Вам потрібен потік автентифікації `FAL_KEY`
- Вам потрібні типові налаштування fal для `image_generate` або `video_generate`
summary: налаштування генерації зображень і відео fal в OpenClaw
title: fal
x-i18n:
generated_at: "2026-04-05T23:14:24Z"
generated_at: "2026-04-11T01:39:18Z"
model: gpt-5.4
provider: openai
source_hash: 1922907d2c8360c5877a56495323d54bd846d47c27a801155e3d11e3f5706fbd
source_hash: 6865c3110cbb9d63f4ecec4467f89a801478759cd7a2f3efa83e8f7ce1dc3e67
source_path: providers/fal.md
workflow: 15
---
# fal
OpenClaw постачається з вбудованим провайдером `fal` для розміщеної генерації зображень і відео.
OpenClaw постачається з вбудованим провайдером `fal` для хостингової генерації зображень і відео.
- Провайдер: `fal`
- Автентифікація: `FAL_KEY` (канонічний варіант; `FAL_API_KEY` також працює як запасний)
@ -49,7 +49,7 @@ openclaw onboard --auth-choice fal-api-key
Вбудований провайдер генерації зображень `fal` типово використовує
`fal/fal-ai/flux/dev`.
- Генерація: до 4 зображень на запит
- Генерація: до 4 зображень за запит
- Режим редагування: увімкнено, 1 еталонне зображення
- Підтримує `size`, `aspectRatio` і `resolution`
- Поточне обмеження редагування: кінцева точка редагування зображень fal **не** підтримує
@ -74,17 +74,22 @@ openclaw onboard --auth-choice fal-api-key
Вбудований провайдер генерації відео `fal` типово використовує
`fal/fal-ai/minimax/video-01-live`.
- Режими: потоки text-to-video і з одним еталонним зображенням
- Виконання: потік submit/status/result на основі черги для довготривалих завдань
- Режими: перетворення тексту на відео та потоки з одним еталонним зображенням
- Середовище виконання: потік submit/status/result на основі черги для довготривалих завдань
- Посилання на моделі 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/text-to-video`
- `fal/bytedance/seedance-2.0/image-to-video`
Щоб використовувати fal як типовий провайдер відео:
Щоб використовувати Seedance 2.0 як типову модель відео:
```json5
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/fal-ai/minimax/video-01-live",
primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
},
},
},

207
docs/uk/tools/video-generation.md
View File

@ -1,34 +1,34 @@
---
read_when:
- Генерація відео через агента
- Створення відео через агента
- Налаштування провайдерів і моделей для генерації відео
- Розуміння параметрів інструмента video_generate
summary: Генеруйте відео з тексту, зображень або наявних відео за допомогою 12 бекендів провайдерів
title: Генерація відео
x-i18n:
generated_at: "2026-04-06T22:52:45Z"
generated_at: "2026-04-11T01:39:19Z"
model: gpt-5.4
provider: openai
source_hash: bf1224c59a5f1217f56cf2001870aca710a09268677dcd12aad2efbe476e47b7
source_hash: f0949cd819b40b909801d877066bcdea01ca7335f6cdd807cb4155953734ffdc
source_path: tools/video-generation.md
workflow: 15
---
# Генерація відео
Агенти OpenClaw можуть генерувати відео з текстових запитів, еталонних зображень або наявних відео. Підтримуються дванадцять бекендів провайдерів, кожен із різними варіантами моделей, режимами введення та наборами функцій. Агент автоматично вибирає відповідного провайдера на основі вашої конфігурації та доступних API-ключів.
Агенти OpenClaw можуть генерувати відео з текстових підказок, еталонних зображень або наявних відео. Підтримуються дванадцять бекендів провайдерів, кожен з яких має різні варіанти моделей, режими введення та набори функцій. Агент автоматично вибирає відповідного провайдера на основі вашої конфігурації та доступних API-ключів.
<Note>
Інструмент `video_generate` з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви не бачите його серед інструментів свого агента, задайте API-ключ провайдера або налаштуйте `agents.defaults.videoGenerationModel`.
Інструмент `video_generate` з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви його не бачите серед інструментів вашого агента, задайте API-ключ провайдера або налаштуйте `agents.defaults.videoGenerationModel`.
</Note>
OpenClaw розглядає генерацію відео як три режими виконання:
- `generate` для запитів text-to-video без еталонного медіа
- `generate` для запитів text-to-video без еталонних медіа
- `imageToVideo`, коли запит містить одне або кілька еталонних зображень
- `videoToVideo`, коли запит містить одне або кілька еталонних відео
Провайдери можуть підтримувати будь-яку підмножину цих режимів. Інструмент перевіряє активний режим перед надсиланням і повідомляє підтримувані режими в `action=list`.
Провайдери можуть підтримувати будь-яку підмножину цих режимів. Інструмент перевіряє активний режим перед надсиланням і повідомляє про підтримувані режими в `action=list`.
## Швидкий старт
@ -38,15 +38,15 @@ OpenClaw розглядає генерацію відео як три режим
export GEMINI_API_KEY="your-key"
```
2. За бажанням зафіксуйте модель за замовчуванням:
2. За потреби закріпіть модель за замовчуванням:
```bash
openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1-fast-generate-preview"
```
3. Попросіть агента:
3. Зверніться до агента:
> Згенеруй 5-секундне кінематографічне відео з доброзичливим лобстером, який катається на серфі на заході сонця.
> Згенеруй 5-секундне кінематографічне відео дружнього лобстера, який серфить на заході сонця.
Агент автоматично викликає `video_generate`. Дозволений список інструментів не потрібен.
@ -59,20 +59,20 @@ openclaw config set agents.defaults.videoGenerationModel.primary "google/veo-3.1
3. Коли відео готове, OpenClaw пробуджує ту саму сесію внутрішньою подією завершення.
4. Агент публікує готове відео назад в оригінальну розмову.
Поки завдання виконується, повторні виклики `video_generate` у тій самій сесії повертають поточний стан завдання замість запуску нової генерації. Використовуйте `openclaw tasks list` або `openclaw tasks show <taskId>`, щоб перевірити прогрес через CLI.
Поки завдання виконується, повторні виклики `video_generate` у тій самій сесії повертають поточний стан завдання замість запуску нової генерації. Щоб перевірити перебіг із CLI, використовуйте `openclaw tasks list` або `openclaw tasks show <taskId>`.
Поза запусками агента, що використовують сесію (наприклад, прямі виклики інструмента), інструмент повертається до вбудованої генерації та повертає фінальний шлях до медіафайлу в тому самому ході.
Поза межами запусків агента з підтримкою сесії (наприклад, для прямих викликів інструмента) інструмент переходить до вбудованої генерації та повертає фінальний шлях до медіа в тому самому ході.
### Життєвий цикл завдання
Кожен запит `video_generate` проходить через чотири стани:
1. **queued** -- завдання створено, очікує, поки провайдер його прийме.
2. **running** -- провайдер виконує обробку (зазвичай від 30 секунд до 5 хвилин залежно від провайдера та роздільної здатності).
3. **succeeded** -- відео готове; агент пробуджується та публікує його в розмову.
4. **failed** -- помилка провайдера або тайм-аут; агент пробуджується з деталями помилки.
2. **running** -- провайдер обробляє запит (зазвичай від 30 секунд до 5 хвилин залежно від провайдера та роздільної здатності).
3. **succeeded** -- відео готове; агент пробуджується і публікує його в розмову.
4. **failed** -- помилка провайдера або тайм-аут; агент пробуджується з відомостями про помилку.
Перевірка стану через CLI:
Перевірка стану з CLI:
```bash
openclaw tasks list
@ -80,57 +80,57 @@ openclaw tasks show <taskId>
openclaw tasks cancel <taskId>
```
Запобігання дублюванню: якщо для поточної сесії завдання відео вже має стан `queued` або `running`, `video_generate` повертає стан наявного завдання замість запуску нового. Використовуйте `action: "status"`, щоб явно перевірити стан без запуску нової генерації.
Запобігання дублюванню: якщо для поточної сесії завдання відеогенерації вже перебуває у стані `queued` або `running`, `video_generate` повертає стан наявного завдання замість запуску нового. Щоб явно перевірити стан без запуску нової генерації, використовуйте `action: "status"`.
## Підтримувані провайдери
| Провайдер | Модель за замовчуванням | Текст | Еталонне зображення | Еталонне відео | API-ключ |
| --------- | ------------------------------- | ----- | ------------------- | ---------------- | ---------------------------------------- |
| Alibaba | `wan2.6-t2v` | Так | Так (віддалений URL) | Так (віддалений URL) | `MODELSTUDIO_API_KEY` |
| BytePlus | `seedance-1-0-lite-t2v-250428` | Так | 1 зображення | Ні | `BYTEPLUS_API_KEY` |
| ComfyUI | `workflow` | Так | 1 зображення | Ні | `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` |
| fal | `fal-ai/minimax/video-01-live` | Так | 1 зображення | Ні | `FAL_KEY` |
| Google | `veo-3.1-fast-generate-preview` | Так | 1 зображення | 1 відео | `GEMINI_API_KEY` |
| MiniMax | `MiniMax-Hailuo-2.3` | Так | 1 зображення | Ні | `MINIMAX_API_KEY` |
| OpenAI | `sora-2` | Так | 1 зображення | 1 відео | `OPENAI_API_KEY` |
| Qwen | `wan2.6-t2v` | Так | Так (віддалений URL) | Так (віддалений URL) | `QWEN_API_KEY` |
| Runway | `gen4.5` | Так | 1 зображення | 1 відео | `RUNWAYML_API_SECRET` |
| Together | `Wan-AI/Wan2.2-T2V-A14B` | Так | 1 зображення | Ні | `TOGETHER_API_KEY` |
| Vydra | `veo3` | Так | 1 зображення (`kling`) | Ні | `VYDRA_API_KEY` |
| xAI | `grok-imagine-video` | Так | 1 зображення | 1 відео | `XAI_API_KEY` |
| Провайдер | Модель за замовчуванням | Текст | Еталонне зображення | Еталонне відео | API-ключ |
| --------- | ------------------------------- | ----- | ------------------- | -------------- | ---------------------------------------- |
| Alibaba | `wan2.6-t2v` | Так | Так (віддалений URL) | Так (віддалений URL) | `MODELSTUDIO_API_KEY` |
| BytePlus | `seedance-1-0-lite-t2v-250428` | Так | 1 зображення | Ні | `BYTEPLUS_API_KEY` |
| ComfyUI | `workflow` | Так | 1 зображення | Ні | `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` |
| fal | `fal-ai/minimax/video-01-live` | Так | 1 зображення | Ні | `FAL_KEY` |
| Google | `veo-3.1-fast-generate-preview` | Так | 1 зображення | 1 відео | `GEMINI_API_KEY` |
| MiniMax | `MiniMax-Hailuo-2.3` | Так | 1 зображення | Ні | `MINIMAX_API_KEY` |
| OpenAI | `sora-2` | Так | 1 зображення | 1 відео | `OPENAI_API_KEY` |
| Qwen | `wan2.6-t2v` | Так | Так (віддалений URL) | Так (віддалений URL) | `QWEN_API_KEY` |
| Runway | `gen4.5` | Так | 1 зображення | 1 відео | `RUNWAYML_API_SECRET` |
| Together | `Wan-AI/Wan2.2-T2V-A14B` | Так | 1 зображення | Ні | `TOGETHER_API_KEY` |
| Vydra | `veo3` | Так | 1 зображення (`kling`) | Ні | `VYDRA_API_KEY` |
| xAI | `grok-imagine-video` | Так | 1 зображення | 1 відео | `XAI_API_KEY` |
Деякі провайдери приймають додаткові або альтернативні змінні середовища API-ключів. Докладніше дивіться на окремих [сторінках провайдерів](#related).
Деякі провайдери приймають додаткові або альтернативні змінні середовища для API-ключів. Докладніше див. на окремих [сторінках провайдерів](#related).
Виконайте `video_generate action=list`, щоб переглянути доступних провайдерів, моделі та режими виконання під час роботи.
Запустіть `video_generate action=list`, щоб під час виконання переглянути доступних провайдерів, моделі та режими виконання.
### Оголошена матриця можливостей
### Заявлена матриця можливостей
Це явний контракт режимів, який використовується `video_generate`, контрактними тестами та спільним live sweep.
| Провайдер | `generate` | `imageToVideo` | `videoToVideo` | Спільні live-режими сьогодні |
| --------- | ---------- | -------------- | -------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| Alibaba | Так | Так | Так | `generate`, `imageToVideo`; `videoToVideo` пропускається, оскільки цьому провайдеру потрібні віддалені `http(s)` URL відео |
| BytePlus | Так | Так | Ні | `generate`, `imageToVideo` |
| ComfyUI | Так | Так | Ні | Не входить до спільного sweep; покриття, специфічне для workflow, живе в тестах Comfy |
| fal | Так | Так | Ні | `generate`, `imageToVideo` |
| Google | Так | Так | Так | `generate`, `imageToVideo`; спільний `videoToVideo` пропускається, оскільки поточний буферно-орієнтований sweep Gemini/Veo не приймає такий ввід |
| MiniMax | Так | Так | Ні | `generate`, `imageToVideo` |
| OpenAI | Так | Так | Так | `generate`, `imageToVideo`; спільний `videoToVideo` пропускається, оскільки цей шлях організації/вводу зараз потребує доступу до inpaint/remix на боці провайдера |
| Qwen | Так | Так | Так | `generate`, `imageToVideo`; `videoToVideo` пропускається, оскільки цьому провайдеру потрібні віддалені `http(s)` URL відео |
| Runway | Так | Так | Так | `generate`, `imageToVideo`; `videoToVideo` запускається лише тоді, коли вибрана модель — `runway/gen4_aleph` |
| Together | Так | Так | Ні | `generate`, `imageToVideo` |
| Vydra | Так | Так | Ні | `generate`; спільний `imageToVideo` пропускається, оскільки вбудований `veo3` підтримує лише текст, а вбудований `kling` вимагає віддалений URL зображення |
| xAI | Так | Так | Так | `generate`, `imageToVideo`; `videoToVideo` пропускається, оскільки цьому провайдеру зараз потрібен віддалений URL MP4 |
| Провайдер | `generate` | `imageToVideo` | `videoToVideo` | Спільні live-ланки наразі |
| --------- | ---------- | -------------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| Alibaba | Так | Так | Так | `generate`, `imageToVideo`; `videoToVideo` пропущено, оскільки цей провайдер потребує віддалених відео-URL `http(s)` |
| BytePlus | Так | Так | Ні | `generate`, `imageToVideo` |
| ComfyUI | Так | Так | Ні | Не входить до спільного sweep; coverage, специфічне для workflow, живе в тестах Comfy |
| fal | Так | Так | Ні | `generate`, `imageToVideo` |
| Google | Так | Так | Так | `generate`, `imageToVideo`; спільний `videoToVideo` пропущено, оскільки поточний буферний sweep Gemini/Veo не приймає такий ввід |
| MiniMax | Так | Так | Ні | `generate`, `imageToVideo` |
| OpenAI | Так | Так | Так | `generate`, `imageToVideo`; спільний `videoToVideo` пропущено, оскільки цей org/шлях введення наразі потребує доступу до inpaint/remix на боці провайдера |
| Qwen | Так | Так | Так | `generate`, `imageToVideo`; `videoToVideo` пропущено, оскільки цей провайдер потребує віддалених відео-URL `http(s)` |
| Runway | Так | Так | Так | `generate`, `imageToVideo`; `videoToVideo` запускається лише тоді, коли вибраною моделлю є `runway/gen4_aleph` |
| Together | Так | Так | Ні | `generate`, `imageToVideo` |
| Vydra | Так | Так | Ні | `generate`; спільний `imageToVideo` пропущено, оскільки вбудований `veo3` є лише текстовим, а вбудований `kling` потребує віддалений URL зображення |
| xAI | Так | Так | Так | `generate`, `imageToVideo`; `videoToVideo` пропущено, оскільки цей провайдер наразі потребує віддалений URL MP4 |
## Параметри інструмента
### Обов’язкові
| Параметр | Тип | Опис |
| -------- | ------ | --------------------------------------------------------------------------------- |
| `prompt` | string | Текстовий опис відео для генерації (обов’язково для `action: "generate"`) |
| Параметр | Тип | Опис |
| -------- | ------ | --------------------------------------------------------------------------- |
| `prompt` | string | Текстовий опис відео для генерації (обов’язковий для `action: "generate"`) |
### Вхідні дані вмісту
### Вхідний контент
| Параметр | Тип | Опис |
| -------- | -------- | ------------------------------------ |
@ -144,37 +144,37 @@ openclaw tasks cancel <taskId>
| Параметр | Тип | Опис |
| ----------------- | ------- | ------------------------------------------------------------------------ |
| `aspectRatio` | string | `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
| `resolution` | string | `480P`, `720P`, `768P`, або `1080P` |
| `durationSeconds` | number | Цільова тривалість у секундах (округлюється до найближчого значення, підтримуваного провайдером) |
| `size` | string | Підказка розміру, якщо провайдер це підтримує |
| `resolution` | string | `480P`, `720P`, `768P` або `1080P` |
| `durationSeconds` | number | Цільова тривалість у секундах (округлюється до найближчого значення, яке підтримує провайдер) |
| `size` | string | Підказка щодо розміру, якщо провайдер це підтримує |
| `audio` | boolean | Увімкнути згенерований звук, якщо підтримується |
| `watermark` | boolean | Увімкнути або вимкнути водяний знак провайдера, якщо підтримується |
### Додатково
### Розширені
| Параметр | Тип | Опис |
| ---------- | ------ | ----------------------------------------------------- |
| `action` | string | `"generate"` (типово), `"status"` або `"list"` |
| `model` | string | Перевизначення провайдера/моделі (наприклад, `runway/gen4.5`) |
| `filename` | string | Підказка для імені вихідного файла |
| Параметр | Тип | Опис |
| --------- | ------ | ----------------------------------------------- |
| `action` | string | `"generate"` (типово), `"status"` або `"list"` |
| `model` | string | Перевизначення провайдера/моделі (наприклад, `runway/gen4.5`) |
| `filename` | string | Підказка для імені вихідного файла |
Не всі провайдери підтримують усі параметри. OpenClaw уже нормалізує тривалість до найближчого значення, підтримуваного провайдером, а також повторно зіставляє перекладені підказки геометрії, як-от size-to-aspect-ratio, коли резервний провайдер надає іншу поверхню керування. Справді непідтримувані перевизначення ігноруються на основі best-effort і повідомляються як попередження в результаті інструмента. Жорсткі обмеження можливостей (наприклад, надто велика кількість еталонних входів) завершуються помилкою до надсилання.
Не всі провайдери підтримують усі параметри. OpenClaw уже нормалізує тривалість до найближчого значення, яке підтримує провайдер, а також переназначає трансльовані підказки геометрії, як-от size-to-aspect-ratio, коли резервний провайдер має іншу поверхню керування. Справді непідтримувані перевизначення ігноруються за принципом best-effort і повідомляються як попередження в результаті інструмента. Жорсткі обмеження можливостей (наприклад, надто багато еталонних входів) спричиняють помилку до надсилання.
Результати інструмента повідомляють про застосовані налаштування. Коли OpenClaw повторно зіставляє тривалість або геометрію під час резервного перемикання провайдера, повернуті значення `durationSeconds`, `size`, `aspectRatio` і `resolution` відображають те, що було надіслано, а `details.normalization` фіксує перетворення від запитаного до застосованого.
Результати інструмента повідомляють про застосовані налаштування. Коли OpenClaw переназначає тривалість або геометрію під час резервного переходу між провайдерами, повернуті значення `durationSeconds`, `size`, `aspectRatio` і `resolution` відображають те, що було надіслано, а `details.normalization` фіксує трансляцію від запитаного до застосованого значення.
Еталонні входи також визначають режим виконання:
- Без еталонного медіа: `generate`
- Без еталонних медіа: `generate`
- Будь-яке еталонне зображення: `imageToVideo`
- Будь-яке еталонне відео: `videoToVideo`
Змішані еталонні зображення та відео не є стабільною спільною поверхнею можливостей.
Рекомендується використовувати один тип еталонних даних на запит.
Краще використовувати один тип еталонних даних на запит.
## Дії
- **generate** (типово) -- створити відео з указаного запиту та необов’язкових еталонних входів.
- **status** -- перевірити стан поточного завдання генерації відео для поточної сесії без запуску нової генерації.
- **generate** (типово) -- створити відео з поданої підказки та необов’язкових еталонних входів.
- **status** -- перевірити стан поточного відеозавдання для поточної сесії без запуску нової генерації.
- **list** -- показати доступних провайдерів, моделі та їхні можливості.
## Вибір моделі
@ -184,12 +184,12 @@ openclaw tasks cancel <taskId>
1. **Параметр інструмента `model`** -- якщо агент указує його у виклику.
2. **`videoGenerationModel.primary`** -- із конфігурації.
3. **`videoGenerationModel.fallbacks`** -- пробуються по черзі.
4. **Автовиявлення** -- використовує провайдерів, які мають дійсну автентифікацію, починаючи з поточного провайдера за замовчуванням, а потім решту провайдерів в алфавітному порядку.
4. **Автовизначення** -- використовує провайдерів із дійсною автентифікацією, починаючи з поточного провайдера за замовчуванням, а потім решту провайдерів в алфавітному порядку.
Якщо провайдер завершується помилкою, автоматично пробується наступний кандидат. Якщо помилку дають усі кандидати, помилка містить деталі кожної спроби.
Якщо провайдер завершується з помилкою, автоматично пробується наступний кандидат. Якщо всі кандидати завершуються з помилкою, помилка містить відомості про кожну спробу.
Установіть `agents.defaults.mediaGenerationAutoProviderFallback: false`, якщо хочете,
щоб генерація відео використовувала лише явні записи `model`, `primary` і `fallbacks`.
щоб генерація відео використовувала лише явно вказані записи `model`, `primary` і `fallbacks`.
```json5
{
@ -204,28 +204,42 @@ openclaw tasks cancel <taskId>
}
```
Seedance 2.0 на fal можна зафіксувати так:
```json5
{
agents: {
defaults: {
videoGenerationModel: {
primary: "fal/bytedance/seedance-2.0/fast/text-to-video",
},
},
},
}
```
## Примітки щодо провайдерів
| Провайдер | Примітки |
| --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Alibaba | Використовує асинхронну кінцеву точку DashScope/Model Studio. Еталонні зображення та відео мають бути віддаленими `http(s)` URL. |
| BytePlus | Підтримується лише одне еталонне зображення. |
| ComfyUI | Виконання локально або в хмарі на основі workflow. Підтримує text-to-video та image-to-video через налаштований граф. |
| fal | Використовує flow на основі черги для довготривалих завдань. Підтримується лише одне еталонне зображення. |
| Alibaba | Використовує асинхронну кінцеву точку DashScope/Model Studio. Еталонні зображення та відео мають бути віддаленими URL `http(s)`. |
| BytePlus | Лише одне еталонне зображення. |
| ComfyUI | Локальне або хмарне виконання на основі workflow. Підтримує text-to-video та image-to-video через налаштований граф. |
| fal | Використовує потік на основі черги для довготривалих завдань. Лише одне еталонне зображення. Містить посилання на моделі Seedance 2.0 для text-to-video та image-to-video. |
| Google | Використовує Gemini/Veo. Підтримує одне еталонне зображення або одне еталонне відео. |
| MiniMax | Підтримується лише одне еталонне зображення. |
| MiniMax | Лише одне еталонне зображення. |
| OpenAI | Передається лише перевизначення `size`. Інші перевизначення стилю (`aspectRatio`, `resolution`, `audio`, `watermark`) ігноруються з попередженням. |
| Qwen | Використовує той самий бекенд DashScope, що й Alibaba. Еталонні входи мають бути віддаленими `http(s)` URL; локальні файли одразу відхиляються. |
| Runway | Підтримує локальні файли через data URI. Для video-to-video потрібен `runway/gen4_aleph`. Запуски лише з текстом відкривають співвідношення сторін `16:9` і `9:16`. |
| Together | Підтримується лише одне еталонне зображення. |
| Vydra | Використовує `https://www.vydra.ai/api/v1` напряму, щоб уникнути перенаправлень, які скидають автентифікацію. `veo3` вбудовано лише для text-to-video; `kling` вимагає віддалений URL зображення. |
| xAI | Підтримує потоки text-to-video, image-to-video та віддаленого редагування/розширення відео. |
| Qwen | Той самий бекенд DashScope, що й Alibaba. Еталонні входи мають бути віддаленими URL `http(s)`; локальні файли відхиляються відразу. |
| Runway | Підтримує локальні файли через data URI. Для video-to-video потрібен `runway/gen4_aleph`. Для текстових запусків доступні співвідношення сторін `16:9` і `9:16`. |
| Together | Лише одне еталонне зображення. |
| Vydra | Використовує `https://www.vydra.ai/api/v1` безпосередньо, щоб уникнути редиректів, які скидають автентифікацію. `veo3` вбудовано лише як text-to-video; `kling` потребує віддалений URL зображення. |
| xAI | Підтримує text-to-video, image-to-video та віддалені потоки редагування/розширення відео. |
## Режими можливостей провайдерів
## Режими можливостей провайдера
Спільний контракт генерації відео тепер дозволяє провайдерам оголошувати
можливості для конкретних режимів замість лише плоских агрегованих обмежень. Новим реалізаціям провайдерів
слід надавати перевагу явним блокам режимів:
Спільний контракт генерації відео тепер дає змогу провайдерам оголошувати
можливості для конкретних режимів, а не лише плоскі сукупні обмеження. Нові
реалізації провайдерів мають надавати перевагу явним блокам режимів:
```typescript
capabilities: {
@ -249,15 +263,15 @@ capabilities: {
}
```
Плоских агрегованих полів, таких як `maxInputImages` і `maxInputVideos`,
недостатньо для оголошення підтримки режимів перетворення. Провайдери мають явно оголошувати
`generate`, `imageToVideo` і `videoToVideo`, щоб live-тести,
контрактні тести та спільний інструмент `video_generate` могли перевіряти підтримку режимів
детерміновано.
Плоских сукупних полів на кшталт `maxInputImages` і `maxInputVideos`
недостатньо, щоб оголосити підтримку режимів перетворення. Провайдери мають
явно оголошувати `generate`, `imageToVideo` і `videoToVideo`, щоб live-тести,
контрактні тести та спільний інструмент `video_generate` могли детерміновано
перевіряти підтримку режимів.
## Live-тести
Добровільне live-покриття для спільних вбудованих провайдерів:
Opt-in live coverage для спільних вбудованих провайдерів:
```bash
OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.live.test.ts
@ -269,18 +283,19 @@ OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/video-generation-providers.liv
pnpm test:live:media video
```
Цей live-файл завантажує відсутні змінні середовища провайдерів із `~/.profile`, за замовчуванням надає
перевагу live/env API-ключам перед збереженими профілями автентифікації та запускає
оголошені режими, які він може безпечно виконати з локальним медіа:
Цей live-файл завантажує відсутні змінні середовища провайдерів із `~/.profile`, за
замовчуванням надає перевагу API-ключам live/env перед збереженими профілями
автентифікації та запускає оголошені режими, які можна безпечно перевірити з
локальними медіа:
- `generate` для кожного провайдера в sweep
- `imageToVideo`, коли `capabilities.imageToVideo.enabled`
- `videoToVideo`, коли `capabilities.videoToVideo.enabled` і провайдер/модель
приймає буферизований локальний відеоввід у спільному sweep
приймає локальний відеовхід на основі буфера в спільному sweep
Сьогодні спільний live-режим `videoToVideo` охоплює:
Наразі спільна live-лінія `videoToVideo` охоплює:
- лише `runway`, якщо ви вибрали `runway/gen4_aleph`
- лише `runway`, коли вибрано `runway/gen4_aleph`
## Конфігурація