diff --git a/docs/uk/tools/video-generation.md b/docs/uk/tools/video-generation.md index 36a368c7c..e0f391062 100644 --- a/docs/uk/tools/video-generation.md +++ b/docs/uk/tools/video-generation.md @@ -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` дає змогу агенту створювати відео за допомогою ваших налаштованих провайдерів. Згенеровані відео автоматично доставляються як медіавкладення у відповіді агента. -Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви не бачите `video_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.videoGenerationModel` або задайте API-ключ провайдера. +Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви не бачите `video_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.videoGenerationModel` або вкажіть API-ключ провайдера. ## Швидкий старт -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) — конфігурація моделей і перемикання на резервні варіанти