chore(i18n): refresh uk translations

This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-05 22:08:53 +00:00
parent af8d98f78f
commit 4aa37d1d2b

View File

@ -1,31 +1,31 @@
---
read_when:
- Генерація відео через агента
- Створення відео через агента
- Налаштування провайдерів і моделей для генерації відео
- Розуміння параметрів інструмента `video_generate`
summary: Створюйте відео за допомогою налаштованих провайдерів, таких як OpenAI, Google, Qwen і MiniMax
- Розуміння параметрів інструмента video_generate
summary: Створюйте відео за допомогою налаштованих провайдерів, таких як Alibaba, OpenAI, Google, Qwen і MiniMax
title: Генерація відео
x-i18n:
generated_at: "2026-04-05T21:08:33Z"
generated_at: "2026-04-05T22:08:53Z"
model: gpt-5.4
provider: openai
source_hash: a9c0304475c7e1ab2aa79cedbdbceb60ff44440459291244a25a73b8001e281d
source_hash: 2e2c4e263bdcf96eab5067c93cee6719890b3e05396fc948854ff4926576ca3a
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>
## Швидкий старт
1. Задайте API-ключ принаймні для одного провайдера (наприклад, `OPENAI_API_KEY`, `GEMINI_API_KEY` або `QWEN_API_KEY`).
2. За бажанням задайте бажану модель:
1. Встановіть API-ключ принаймні для одного провайдера (наприклад, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `MODELSTUDIO_API_KEY` або `QWEN_API_KEY`).
2. За бажанням установіть бажану модель:
```json5
{
@ -37,23 +37,25 @@ x-i18n:
}
```
3. Запитайте агента: _"Згенеруй 5-секундне кінематографічне відео доброзичливого лобстера, який серфить на заході сонця."_
3. Попросіть агента: _"Створи 5-секундне кінематографічне відео з доброзичливим лобстером, який катається на серфі на заході сонця."_
Агент автоматично викликає `video_generate`. Додавати інструмент до списку дозволених не потрібно — він увімкнений за замовчуванням, коли провайдер доступний.
## Підтримувані провайдери
| Провайдер | Модель за замовчуванням | Референсні входи | API-ключ |
| --------- | ------------------------------- | ------------------ | ---------------------------------------------------------- |
| 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` |
| 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
@ -70,17 +72,17 @@ x-i18n:
| `images` | string[] | Кілька референсних зображень (до 5) |
| `video` | string | Шлях або URL одного референсного відео |
| `videos` | string[] | Кілька референсних відео (до 4) |
| `size` | string | Підказка розміру, якщо провайдер це підтримує |
| `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` |
| `resolution` | string | Підказка щодо роздільної здатності: `480P`, `720P` або `1080P` |
| `durationSeconds`| number | Цільова тривалість у секундах |
| `audio` | boolean | Увімкнути згенерований звук, якщо провайдер це підтримує |
| `watermark` | boolean | Увімкнути або вимкнути водяний знак провайдера, якщо підтримується |
| `filename` | string | Підказка для імені вихідного файла |
| `watermark` | boolean | Увімкнути або вимкнути водяний знак провайдера, якщо це підтримується |
| `filename` | string | Підказка щодо назви вихідного файла |
Не всі провайдери підтримують усі параметри. Інструмент перевіряє обмеження можливостей провайдера, перш ніж надсилати запит.
Не всі провайдери підтримують усі параметри. Інструмент перевіряє обмеження можливостей провайдера перед надсиланням запиту.
## Налаштування
## Конфігурація
### Вибір моделі
@ -102,28 +104,30 @@ x-i18n:
Під час генерації відео OpenClaw пробує провайдерів у такому порядку:
1. Параметр **`model`** з виклику інструмента (якщо агент його вказує)
2. **`videoGenerationModel.primary`** із конфігурації
3. **`videoGenerationModel.fallbacks`** у заданому порядку
4. **Автовизначення** — використовуються лише типові значення провайдерів, підкріплені автентифікацією:
2. **`videoGenerationModel.primary`** з конфігурації
3. **`videoGenerationModel.fallbacks`** по черзі
4. **Автовизначення** — використовує лише типові значення провайдерів, підкріплені автентифікацією:
- спочатку поточний провайдер за замовчуванням
- потім решта зареєстрованих провайдерів генерації відео в порядку `provider-id`
- решта зареєстрованих провайдерів генерації відео в порядку ідентифікаторів провайдерів
Якщо провайдер завершується помилкою, автоматично буде випробувано наступного кандидата. Якщо помиляються всі, повідомлення про помилку міститиме подробиці кожної спроби.
Якщо провайдер завершується помилкою, автоматично пробується наступний кандидат. Якщо помиляються всі, помилка містить подробиці кожної спроби.
## Примітки щодо провайдерів
- OpenAI використовує нативний відеоендпойнт і наразі за замовчуванням використовує `sora-2`.
- Google використовує Gemini/Veo і підтримує одне референсне зображення або відео.
- Alibaba використовує асинхронний відеоендпойнт DashScope / Model Studio і наразі вимагає віддалені URL `http(s)` для референсних ресурсів.
- Google використовує Gemini/Veo і підтримує одне референсне зображення або одне референсне відео.
- MiniMax, Together, BytePlus і fal наразі підтримують одне референсне зображення.
- Qwen підтримує референсні зображення/відео, але вхідна точка DashScope для відео наразі вимагає віддалені URL `http(s)` для цих референсів.
- OpenAI використовує нативний відеоендпойнт і наразі типово використовує `sora-2`.
- Qwen підтримує референси зображень/відео, але висхідний відеоендпойнт DashScope наразі вимагає віддалені URL `http(s)` для цих референсів.
- xAI використовує нативний відео-API xAI і підтримує сценарії text-to-video, image-to-video та віддалене редагування/розширення відео.
## Референсні входи Qwen
Вбудований провайдер Qwen підтримує режими text-to-video, а також режими з референсними зображеннями/відео, але вхідна точка DashScope для відео наразі вимагає **віддалені URL `http(s)`** для референсних входів. Локальні шляхи до файлів і завантажені буфери відхиляються одразу, а не ігноруються без повідомлення.
Вбудований провайдер Qwen підтримує text-to-video, а також режими з референсами зображень/відео, але висхідний відеоендпойнт DashScope наразі вимагає **віддалені URL `http(s)`** для референсних входів. Шляхи до локальних файлів і завантажені буфери одразу відхиляються, а не ігноруються мовчки.
## Пов’язане
- [Огляд інструментів](/uk/tools) — усі доступні інструменти агента
- [Qwen](/uk/providers/qwen) — налаштування та обмеження, специфічні для Qwen
- [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults) — конфігурація `videoGenerationModel`
- [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання при відмові
- [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання на резервні варіанти