From 86e858ab0eda3acfd5ee5f1e67ba73dc9696d4ee Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sun, 5 Apr 2026 23:14:42 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/providers/fal.md | 15 ++--- docs/uk/tools/video-generation.md | 95 ++++++++++++++++--------------- 2 files changed, 58 insertions(+), 52 deletions(-) diff --git a/docs/uk/providers/fal.md b/docs/uk/providers/fal.md index 38e5c89a7..c47c83ee2 100644 --- a/docs/uk/providers/fal.md +++ b/docs/uk/providers/fal.md @@ -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 як типовий провайдер відео: diff --git a/docs/uk/tools/video-generation.md b/docs/uk/tools/video-generation.md index 045b8e759..7944a10ab 100644 --- a/docs/uk/tools/video-generation.md +++ b/docs/uk/tools/video-generation.md @@ -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` дає агенту змогу створювати відео за допомогою ваших налаштованих провайдерів. Згенеровані відео автоматично доставляються як медіавкладення у відповіді агента. -Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви не бачите `video_generate` в інструментах свого агента, налаштуйте `agents.defaults.videoGenerationModel` або задайте API-ключ провайдера. +Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації відео. Якщо ви не бачите `video_generate` в інструментах вашого агента, налаштуйте `agents.defaults.videoGenerationModel` або задайте API-ключ провайдера. + + + +OpenClaw тепер записує запуски `video_generate` у журнал завдань, коли агент має ключ сесії, тож довгі генерації можна відстежувати за ідентифікаторами завдань/запусків, хоча інструмент усе ще очікує завершення в межах поточного ходу. ## Швидкий старт -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) — конфігурація моделей і перемикання у разі збою