chore(i18n): refresh uk translations
This commit is contained in:
parent
37aa0da9de
commit
86e858ab0e
@ -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 як типовий провайдер відео:
|
||||
|
||||
|
||||
@ -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) — конфігурація моделей і перемикання у разі збою
|
||||
|
||||
Loading…
Reference in New Issue
Block a user