chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-05 23:14:42 +00:00
parent 37aa0da9de
commit 86e858ab0e
2 changed files with 58 additions and 52 deletions

View File

@ -3,26 +3,26 @@ read_when:
- Ви хочете використовувати генерацію зображень fal в OpenClaw
- Вам потрібен потік автентифікації FAL_KEY
- Ви хочете використовувати типові значення fal для image_generate або video_generate
summary: налаштування генерації зображень і відео fal в OpenClaw
summary: Налаштування генерації зображень і відео fal в OpenClaw
title: fal
x-i18n:
generated_at: "2026-04-05T22:22:53Z"
generated_at: "2026-04-05T23:14:24Z"
model: gpt-5.4
provider: openai
source_hash: f136abdc36826812c9f1930483df308247de07be2dacab4d4c6c1b32d951602c
source_hash: 1922907d2c8360c5877a56495323d54bd846d47c27a801155e3d11e3f5706fbd
source_path: providers/fal.md
workflow: 15
---
# fal
OpenClaw постачається з вбудованим провайдером `fal` для хостингової генерації зображень і відео.
OpenClaw постачається з вбудованим провайдером `fal` для розміщеної генерації зображень і відео.
- Провайдер: `fal`
- Автентифікація: `FAL_KEY`
- Автентифікація: `FAL_KEY` (канонічний варіант; `FAL_API_KEY` також працює як запасний)
- API: кінцеві точки моделей fal
## Швидкий початок
## Швидкий старт
1. Установіть API-ключ:
@ -74,7 +74,8 @@ openclaw onboard --auth-choice fal-api-key
Вбудований провайдер генерації відео `fal` типово використовує
`fal/fal-ai/minimax/video-01-live`.
- Режими: text-to-video і потоки з одним еталонним зображенням
- Режими: потоки text-to-video і з одним еталонним зображенням
- Виконання: потік submit/status/result на основі черги для довготривалих завдань
Щоб використовувати fal як типовий провайдер відео:

View File

@ -1,30 +1,34 @@
---
read_when:
- Генерація відео через агента
- Генерування відео через агента
- Налаштування провайдерів і моделей для генерації відео
- Розуміння параметрів інструмента `video_generate`
- Розуміння параметрів інструмента video_generate
summary: Генеруйте відео за допомогою налаштованих провайдерів, таких як Alibaba, OpenAI, Google, Qwen і MiniMax
title: Генерація відео
x-i18n:
generated_at: "2026-04-05T22:59:37Z"
generated_at: "2026-04-05T23:14:42Z"
model: gpt-5.4
provider: openai
source_hash: 8b57870c6a53e51694cc1606b5620fc7b260a64ff9aec83a6123566f64b6f2ab
source_hash: 992068bc687982044023920557d9a839540175f62ac83e26b579c420c2a010fd
source_path: tools/video-generation.md
workflow: 15
---
# Генерація відео
Інструмент `video_generate` дає змогу агенту створювати відео за допомогою ваших налаштованих провайдерів. Згенеровані відео автоматично доставляються як вкладення медіа у відповіді агента.
Інструмент `video_generate` дає агенту змогу створювати відео за допомогою ваших налаштованих провайдерів. Згенеровані відео автоматично доставляються як медіавкладення у відповіді агента.
<Note>
Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви не бачите `video_generate` в інструментах свого агента, налаштуйте `agents.defaults.videoGenerationModel` або задайте API-ключ провайдера.
Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви не бачите `video_generate` в інструментах вашого агента, налаштуйте `agents.defaults.videoGenerationModel` або задайте API-ключ провайдера.
</Note>
<Note>
OpenClaw тепер записує запуски `video_generate` у журнал завдань, коли агент має ключ сесії, тож довгі генерації можна відстежувати за ідентифікаторами завдань/запусків, хоча інструмент усе ще очікує завершення в межах поточного ходу.
</Note>
## Швидкий старт
1. Задайте API-ключ принаймні для одного провайдера (наприклад, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `MODELSTUDIO_API_KEY` або `QWEN_API_KEY`).
1. Установіть API-ключ принаймні для одного провайдера (наприклад, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `MODELSTUDIO_API_KEY` або `QWEN_API_KEY`).
2. За бажанням задайте бажану модель:
```json5
@ -39,25 +43,25 @@ x-i18n:
}
```
3. Попросіть агента: _"Згенеруй 5-секундне кінематографічне відео доброзичливого омара, що катається на серфі на заході сонця."_
3. Попросіть агента: _"Згенеруй 5-секундне кінематографічне відео дружнього омара, який займається серфінгом на заході сонця."_
Агент автоматично викликає `video_generate`. Жодного списку дозволів для інструментів не потрібно — він увімкнений за замовчуванням, коли провайдер доступний.
Агент автоматично викликає `video_generate`. Жодного allowlist для інструмента не потрібно — його ввімкнено за замовчуванням, коли доступний провайдер.
## Підтримувані провайдери
| Провайдер | Модель за замовчуванням | Вхідні референси | API-ключ |
| --------- | ------------------------------ | ----------------- | ---------------------------------------------------------- |
| Alibaba | `wan2.6-t2v` | Так, віддалені URL | `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`, `QWEN_API_KEY` |
| BytePlus | `seedance-1-0-lite-t2v-250428` | 1 зображення | `BYTEPLUS_API_KEY` |
| fal | `fal-ai/minimax/video-01-live` | 1 зображення | `FAL_KEY` |
| Провайдер | Модель за замовчуванням | Вхідні референси | API-ключ |
| --------- | ------------------------------- | ----------------- | ---------------------------------------------------------- |
| Alibaba | `wan2.6-t2v` | Так, віддалені URL | `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY`, `QWEN_API_KEY` |
| BytePlus | `seedance-1-0-lite-t2v-250428` | 1 зображення | `BYTEPLUS_API_KEY` |
| fal | `fal-ai/minimax/video-01-live` | 1 зображення | `FAL_KEY` |
| Google | `veo-3.1-fast-generate-preview` | 1 зображення або 1 відео | `GEMINI_API_KEY`, `GOOGLE_API_KEY` |
| MiniMax | `MiniMax-Hailuo-2.3` | 1 зображення | `MINIMAX_API_KEY` |
| OpenAI | `sora-2` | 1 зображення або 1 відео | `OPENAI_API_KEY` |
| Qwen | `wan2.6-t2v` | Так, віддалені URL | `QWEN_API_KEY`, `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY` |
| Together | `Wan-AI/Wan2.2-T2V-A14B` | 1 зображення | `TOGETHER_API_KEY` |
| xAI | `grok-imagine-video` | 1 зображення або 1 відео | `XAI_API_KEY` |
| MiniMax | `MiniMax-Hailuo-2.3` | 1 зображення | `MINIMAX_API_KEY` |
| OpenAI | `sora-2` | 1 зображення або 1 відео | `OPENAI_API_KEY` |
| Qwen | `wan2.6-t2v` | Так, віддалені URL | `QWEN_API_KEY`, `MODELSTUDIO_API_KEY`, `DASHSCOPE_API_KEY` |
| Together | `Wan-AI/Wan2.2-T2V-A14B` | 1 зображення | `TOGETHER_API_KEY` |
| xAI | `grok-imagine-video` | 1 зображення або 1 відео | `XAI_API_KEY` |
Використовуйте `action: "list"`, щоб переглянути доступні провайдери й моделі під час виконання:
Використовуйте `action: "list"`, щоб переглянути доступні провайдери та моделі під час виконання:
```
/tool video_generate action=list
@ -65,26 +69,26 @@ x-i18n:
## Параметри інструмента
| Параметр | Тип | Опис |
| ---------------- | -------- | -------------------------------------------------------------------------------------- |
| `prompt` | string | Запит для генерації відео (обов’язковий для `action: "generate"`) |
| `action` | string | `"generate"` (за замовчуванням) або `"list"` для перегляду провайдерів |
| `model` | string | Перевизначення провайдера/моделі, наприклад `qwen/wan2.6-t2v` |
| `image` | string | Шлях або URL одного референсного зображення |
| `images` | string[] | Кілька референсних зображень (до 5) |
| `video` | string | Шлях або URL одного референсного відео |
| `videos` | string[] | Кілька референсних відео (до 4) |
| `size` | string | Підказка щодо розміру, якщо провайдер це підтримує |
| Параметр | Тип | Опис |
| ---------------- | -------- | ------------------------------------------------------------------------------------- |
| `prompt` | string | Запит для генерації відео (обов’язковий для `action: "generate"`) |
| `action` | string | `"generate"` (типово) або `"list"` для перегляду провайдерів |
| `model` | string | Перевизначення провайдера/моделі, наприклад `qwen/wan2.6-t2v` |
| `image` | string | Шлях або URL одного референсного зображення |
| `images` | string[] | Кілька референсних зображень (до 5) |
| `video` | string | Шлях або URL одного референсного відео |
| `videos` | string[] | Кілька референсних відео (до 4) |
| `size` | string | Підказка щодо розміру, якщо провайдер це підтримує |
| `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` або `1080P` |
| `durationSeconds` | number | Цільова тривалість у секундах. OpenClaw може округлити до найближчого значення, яке підтримує провайдер |
| `audio` | boolean | Увімкнути згенероване аудіо, якщо провайдер це підтримує |
| `watermark` | boolean | Увімкнути або вимкнути водяний знак провайдера, якщо це підтримується |
| `filename` | string | Підказка щодо імені вихідного файлу |
| `resolution` | string | Підказка щодо роздільної здатності: `480P`, `720P` або `1080P` |
| `durationSeconds` | number | Цільова тривалість у секундах. OpenClaw може округлити її до найближчого значення, яке підтримує провайдер |
| `audio` | boolean | Увімкнути згенероване аудіо, якщо провайдер це підтримує |
| `watermark` | boolean | Увімкнення або вимкнення водяного знака провайдера, якщо підтримується |
| `filename` | string | Підказка для імені вихідного файла |
Не всі провайдери підтримують усі параметри. Інструмент перевіряє обмеження можливостей провайдера перед надсиланням запиту. Коли провайдер або модель підтримує лише дискретний набір тривалостей відео, OpenClaw округлює `durationSeconds` до найближчого підтримуваного значення та повідомляє нормалізовану тривалість у результаті інструмента.
## Налаштування
## Конфігурація
### Вибір моделі
@ -112,20 +116,21 @@ x-i18n:
- спочатку поточний провайдер за замовчуванням
- решта зареєстрованих провайдерів генерації відео в порядку ідентифікаторів провайдерів
Якщо провайдер завершується помилкою, автоматично пробується наступний кандидат. Якщо помиляються всі, помилка містить подробиці кожної спроби.
Якщо провайдер зазнає невдачі, автоматично пробується наступний кандидат. Якщо зазнають невдачі всі, помилка міститиме подробиці кожної спроби.
## Примітки про провайдерів
## Примітки щодо провайдерів
- Alibaba використовує асинхронний відеоендпойнт DashScope / Model Studio і наразі вимагає віддалені URL `http(s)` для референсних ресурсів.
- Alibaba використовує асинхронну відеокінцеву точку DashScope / Model Studio і наразі вимагає віддалені URL `http(s)` для референсних ресурсів.
- Google використовує Gemini/Veo і підтримує одне референсне зображення або відео.
- MiniMax, Together, BytePlus і fal наразі підтримують одне референсне зображення.
- OpenAI використовує нативний відеоендпойнт і наразі за замовчуванням використовує `sora-2`.
- Qwen підтримує референси зображень/відео, але висхідний відеоендпойнт DashScope наразі вимагає віддалені URL `http(s)` для цих референсів.
- xAI використовує нативний відео-API xAI і підтримує text-to-video, image-to-video та віддалені сценарії редагування/розширення відео.
- OpenAI використовує нативну відеокінцеву точку і наразі типово використовує `sora-2`.
- Qwen підтримує референси зображень/відео, але висхідна відеокінцева точка DashScope наразі вимагає віддалені URL `http(s)` для цих референсів.
- xAI використовує нативний відео API xAI і підтримує сценарії text-to-video, image-to-video та віддалене редагування/розширення відео.
- fal використовує чергу з підтримкою відеопотоку fal для довготривалих завдань замість одного блокувального запиту інференсу.
## Референсні входи Qwen
Вбудований провайдер Qwen підтримує text-to-video, а також режими з референсами зображень/відео, але висхідний відеоендпойнт DashScope наразі вимагає **віддалені URL `http(s)`** для референсних входів. Шляхи до локальних файлів і завантажені буфери відхиляються одразу, а не ігноруються без повідомлення.
Вбудований провайдер Qwen підтримує text-to-video, а також режими з референсами зображень/відео, але висхідна відеокінцева точка DashScope наразі вимагає **віддалені URL `http(s)`** для референсних входів. Шляхи до локальних файлів і вивантажені буфери відхиляються одразу, а не тихо ігноруються.
## Пов’язане
@ -134,8 +139,8 @@ x-i18n:
- [Google (Gemini)](/uk/providers/google) — налаштування провайдера Veo
- [MiniMax](/uk/providers/minimax) — налаштування провайдера Hailuo
- [OpenAI](/uk/providers/openai) — налаштування провайдера Sora
- [Qwen](/uk/providers/qwen) — специфічне для Qwen налаштування та обмеження
- [Qwen](/uk/providers/qwen) — налаштування та обмеження, специфічні для Qwen
- [Together AI](/uk/providers/together) — налаштування провайдера Together Wan
- [xAI](/uk/providers/xai) — налаштування провайдера відео Grok
- [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults) — конфігурація `videoGenerationModel`
- [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання при збоях
- [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання у разі збою