From a9ec77db471d86964a9124e4963fbfdb48ab1191 Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Mon, 6 Apr 2026 01:46:19 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/tools/music-generation.md | 128 +++++++++++++++--------------- 1 file changed, 64 insertions(+), 64 deletions(-) diff --git a/docs/uk/tools/music-generation.md b/docs/uk/tools/music-generation.md index fbb6da3c6..003d8b52d 100644 --- a/docs/uk/tools/music-generation.md +++ b/docs/uk/tools/music-generation.md @@ -2,14 +2,14 @@ read_when: - Генерація музики або аудіо через агента - Налаштування провайдерів і моделей для генерації музики - - Розуміння параметрів інструмента music_generate -summary: Генеруйте музику за допомогою спільних провайдерів, зокрема плагінів на основі workflow + - Розуміння параметрів інструмента `music_generate` +summary: Генеруйте музику за допомогою спільних провайдерів, включно з плагінами на основі workflow title: Генерація музики x-i18n: - generated_at: "2026-04-06T01:05:30Z" + generated_at: "2026-04-06T01:46:19Z" model: gpt-5.4 provider: openai - source_hash: 7e5dc234b14aee2f5ef766985479b0ba262cceb4510596f6b1cc343a3732838c + source_hash: a03de8aa75cfb7248eb0c1d969fb2a6da06117967d097e6f6e95771d0f017ae1 source_path: tools/music-generation.md workflow: 15 --- @@ -20,22 +20,22 @@ x-i18n: спільну можливість генерації музики з налаштованими провайдерами, такими як Google, MiniMax і налаштований через workflow ComfyUI. -Для сеансів агента зі спільними провайдерами OpenClaw запускає генерацію музики як -фонове завдання, відстежує його в реєстрі завдань, а потім знову пробуджує агента, -коли трек готовий, щоб агент міг надіслати готове аудіо назад у +Для сеансів агента на основі спільного провайдера OpenClaw запускає генерацію музики як +фонове завдання, відстежує її в журналі завдань, а потім знову пробуджує агента, коли +трек готовий, щоб агент міг опублікувати готове аудіо назад у початковий канал. Вбудований спільний інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації музики. Якщо ви не бачите `music_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.musicGenerationModel` або вкажіть API-ключ провайдера. -## Швидкий початок +## Швидкий старт -### Генерація через спільних провайдерів +### Генерація на основі спільного провайдера 1. Установіть API-ключ принаймні для одного провайдера, наприклад `GEMINI_API_KEY` або `MINIMAX_API_KEY`. -2. За бажанням установіть бажану модель: +2. За потреби встановіть бажану модель: ```json5 { @@ -50,12 +50,12 @@ MiniMax і налаштований через workflow ComfyUI. ``` 3. Попросіть агента: _"Згенеруй енергійний synthpop-трек про нічну поїздку - неоновим містом."_ + крізь неонове місто."_ -Агент викликає `music_generate` автоматично. Додавання інструмента до allow-list не потрібне. +Агент викликає `music_generate` автоматично. Додавати інструмент до списку дозволених не потрібно. Для прямих синхронних контекстів без запуску агента на основі сеансу вбудований -інструмент усе одно переходить до вбудованої генерації та повертає фінальний шлях до медіафайлу в результаті інструмента. +інструмент усе одно повертається до вбудованої генерації та повертає фінальний шлях до медіафайлу в результаті інструмента. Приклади запитів: @@ -64,15 +64,15 @@ MiniMax і налаштований через workflow ComfyUI. ``` ```text -Згенеруй енергійний chiptune-луп про запуск ракети на світанку. +Згенеруй енергійну chiptune-петлю про запуск ракети на світанку. ``` -### Генерація через Comfy на основі workflow +### Генерація Comfy на основі workflow Вбудований плагін `comfy` підключається до спільного інструмента `music_generate` через реєстр провайдерів генерації музики. -1. Налаштуйте `models.providers.comfy.music` за допомогою JSON workflow і +1. Налаштуйте `models.providers.comfy.music` за допомогою JSON workflow та вузлів prompt/output. 2. Якщо ви використовуєте Comfy Cloud, установіть `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY`. 3. Попросіть агента створити музику або викличте інструмент безпосередньо. @@ -80,16 +80,16 @@ MiniMax і налаштований через workflow ComfyUI. Приклад: ```text -/tool music_generate prompt="Warm ambient synth loop with soft tape texture" +/tool music_generate prompt="Тепла ембієнтна synth-петля з м’якою текстурою стрічки" ``` -## Підтримка вбудованих спільних провайдерів +## Підтримка спільних вбудованих провайдерів -| Провайдер | Модель за замовчуванням | Вхідні reference-дані | Підтримувані параметри керування | API-ключ | -| --------- | ----------------------- | --------------------- | ------------------------------------------------------ | -------------------------------------- | -| ComfyUI | `workflow` | До 1 зображення | Музика або аудіо, визначені workflow | `COMFY_API_KEY`, `COMFY_CLOUD_API_KEY` | -| Google | `lyria-3-clip-preview` | До 10 зображень | `lyrics`, `instrumental`, `format` | `GEMINI_API_KEY`, `GOOGLE_API_KEY` | -| MiniMax | `music-2.5+` | Немає | `lyrics`, `instrumental`, `durationSeconds`, `format=mp3` | `MINIMAX_API_KEY` | +| Провайдер | Модель за замовчуванням | Еталонні входи | Підтримувані елементи керування | API-ключ | +| --------- | ----------------------- | -------------- | ----------------------------------------------------- | -------------------------------------- | +| ComfyUI | `workflow` | До 1 зображення | Визначена workflow музика або аудіо | `COMFY_API_KEY`, `COMFY_CLOUD_API_KEY` | +| Google | `lyria-3-clip-preview` | До 10 зображень | `lyrics`, `instrumental`, `format` | `GEMINI_API_KEY`, `GOOGLE_API_KEY` | +| MiniMax | `music-2.5+` | Немає | `lyrics`, `instrumental`, `durationSeconds`, `format=mp3` | `MINIMAX_API_KEY` | Використовуйте `action: "list"`, щоб переглянути доступні спільні провайдери та моделі під час виконання: @@ -98,8 +98,7 @@ MiniMax і налаштований через workflow ComfyUI. /tool music_generate action=list ``` -Використовуйте `action: "status"`, щоб переглянути активне музичне завдання, -пов’язане із сеансом: +Використовуйте `action: "status"`, щоб переглянути активне завдання музики на основі сеансу: ```text /tool music_generate action=status @@ -108,36 +107,37 @@ MiniMax і налаштований через workflow ComfyUI. Приклад прямої генерації: ```text -/tool music_generate prompt="Dreamy lo-fi hip hop with vinyl texture and gentle rain" instrumental=true +/tool music_generate prompt="Мрійливий lo-fi hip hop із вініловою текстурою та ніжним дощем" instrumental=true ``` ## Параметри вбудованого інструмента | Параметр | Тип | Опис | | ---------------- | -------- | ------------------------------------------------------------------------------------------------- | -| `prompt` | string | Запит для генерації музики (обов’язковий для `action: "generate"`) | -| `action` | string | `"generate"` (типово), `"status"` для поточного завдання сеансу або `"list"` для перегляду провайдерів | +| `prompt` | string | Запит на генерацію музики (обов’язковий для `action: "generate"`) | +| `action` | string | `"generate"` (за замовчуванням), `"status"` для поточного завдання сеансу або `"list"` для перегляду провайдерів | | `model` | string | Перевизначення провайдера/моделі, наприклад `google/lyria-3-pro-preview` або `comfy/workflow` | | `lyrics` | string | Необов’язковий текст пісні, якщо провайдер підтримує явне введення тексту | -| `instrumental` | boolean | Запитати лише інструментальний результат, якщо провайдер це підтримує | -| `image` | string | Шлях або URL одного reference-зображення | -| `images` | string[] | Кілька reference-зображень (до 10) | +| `instrumental` | boolean | Запит лише на інструментальний результат, якщо провайдер це підтримує | +| `image` | string | Шлях або URL одного еталонного зображення | +| `images` | string[] | Кілька еталонних зображень (до 10) | | `durationSeconds`| number | Цільова тривалість у секундах, якщо провайдер підтримує підказки щодо тривалості | -| `format` | string | Підказка формату виводу (`mp3` або `wav`), якщо провайдер це підтримує | -| `filename` | string | Підказка імені вихідного файлу | +| `format` | string | Підказка щодо формату виводу (`mp3` або `wav`), якщо провайдер це підтримує | +| `filename` | string | Підказка щодо імені вихідного файлу | -Не всі провайдери підтримують усі параметри. Спільний інструмент перевіряє -обмеження можливостей провайдера перед надсиланням запиту. +Не всі провайдери підтримують усі параметри. OpenClaw усе одно перевіряє жорсткі обмеження, +як-от кількість входів, перед надсиланням, але непідтримувані необов’язкові підказки +ігноруються з попередженням, якщо вибраний провайдер або модель не можуть їх виконати. -## Асинхронна поведінка для шляху через спільних провайдерів +## Асинхронна поведінка для шляху на основі спільного провайдера -- Запуски агента на основі сеансу: `music_generate` створює фонове завдання, одразу повертає відповідь про запуск/завдання, а готовий трек надсилає пізніше в подальшому повідомленні агента. -- Запобігання дублюванню: поки це фонове завдання має стан `queued` або `running`, наступні виклики `music_generate` у тому самому сеансі повертають статус завдання замість запуску нової генерації. -- Перевірка статусу: використовуйте `action: "status"`, щоб переглянути активне музичне завдання, пов’язане із сеансом, без запуску нового. +- Запуски агента на основі сеансу: `music_generate` створює фонове завдання, негайно повертає відповідь started/task і публікує готовий трек пізніше в наступному повідомленні агента. +- Запобігання дублюванню: поки це фонове завдання все ще має стан `queued` або `running`, наступні виклики `music_generate` у тому самому сеансі повертають стан завдання замість запуску нової генерації. +- Перегляд стану: використовуйте `action: "status"`, щоб переглянути активне музичне завдання на основі сеансу без запуску нового. - Відстеження завдань: використовуйте `openclaw tasks list` або `openclaw tasks show `, щоб переглядати статуси queued, running і terminal для генерації. -- Пробудження після завершення: OpenClaw вставляє внутрішню подію завершення назад у той самий сеанс, щоб модель могла сама написати повідомлення для користувача. -- Підказка для prompt: наступні користувацькі/ручні ходи в тому самому сеансі отримують невелику підказку під час виконання, коли музичне завдання вже виконується, щоб модель не викликала `music_generate` знову бездумно. -- Резервний варіант без сеансу: прямі/локальні контексти без реального сеансу агента все одно виконуються вбудовано та повертають фінальний результат аудіо в тому самому ході. +- Пробудження після завершення: OpenClaw впроваджує внутрішню подію завершення назад у той самий сеанс, щоб модель могла самостійно написати користувацьке подальше повідомлення. +- Підказка в prompt: пізніші користувацькі/ручні ходи в тому самому сеансі отримують невелику підказку часу виконання, коли завдання музики вже виконується, щоб модель не викликала `music_generate` знову бездумно. +- Режим без сеансу: прямі/локальні контексти без реального сеансу агента все одно виконуються вбудовано й повертають фінальний результат аудіо в тому самому ході. ## Налаштування @@ -156,45 +156,45 @@ MiniMax і налаштований через workflow ComfyUI. } ``` -### Порядок вибору провайдерів +### Порядок вибору провайдера -Під час генерації музики OpenClaw намагається використовувати провайдерів у такому порядку: +Під час генерації музики OpenClaw намагається використати провайдерів у такому порядку: -1. параметр `model` з виклику інструмента, якщо агент указує його -2. `musicGenerationModel.primary` з конфігурації -3. `musicGenerationModel.fallbacks` по порядку -4. Автовизначення з використанням лише типових значень провайдерів на основі auth: - - спочатку поточний типовий провайдер - - решта зареєстрованих провайдерів генерації музики в порядку ідентифікаторів провайдерів +1. параметр `model` із виклику інструмента, якщо агент його вказує +2. `musicGenerationModel.primary` із конфігурації +3. `musicGenerationModel.fallbacks` у заданому порядку +4. Автовиявлення з використанням лише стандартних значень провайдерів на основі auth: + - спочатку поточний провайдер за замовчуванням + - решта зареєстрованих провайдерів генерації музики в порядку provider-id -Якщо провайдер завершується помилкою, автоматично використовується наступний кандидат. Якщо всі завершуються помилкою, -помилка містить деталі кожної спроби. +Якщо провайдер завершується помилкою, автоматично пробується наступний кандидат. Якщо всі завершуються помилкою, +помилка містить подробиці кожної спроби. -## Примітки про провайдерів +## Примітки щодо провайдерів - Google використовує пакетну генерацію Lyria 3. Поточний вбудований потік підтримує - prompt, необов’язковий текст пісні та необов’язкові reference-зображення. + prompt, необов’язковий текст lyrics і необов’язкові еталонні зображення. - MiniMax використовує пакетний endpoint `music_generation`. Поточний вбудований потік - підтримує prompt, необов’язковий текст пісні, інструментальний режим, керування тривалістю та + підтримує prompt, необов’язкові lyrics, інструментальний режим, керування тривалістю та вивід у mp3. -- Підтримка ComfyUI ґрунтується на workflow і залежить від налаштованого графа та +- Підтримка ComfyUI керується workflow і залежить від налаштованого графа та зіставлення вузлів для полів prompt/output. -## Як вибрати правильний шлях +## Вибір правильного шляху -- Використовуйте шлях через спільних провайдерів, якщо вам потрібні вибір моделі, перемикання на резервних провайдерів і вбудований асинхронний потік завдань/статусу. -- Використовуйте шлях через плагін, наприклад ComfyUI, якщо вам потрібен власний граф workflow або провайдер, який не входить до спільної вбудованої можливості генерації музики. -- Якщо ви налагоджуєте поведінку, специфічну для ComfyUI, див. [ComfyUI](/uk/providers/comfy). Якщо ви налагоджуєте поведінку спільних провайдерів, почніть із [Google (Gemini)](/uk/providers/google) або [MiniMax](/uk/providers/minimax). +- Використовуйте шлях на основі спільного провайдера, якщо вам потрібні вибір моделі, відмовостійке перемикання між провайдерами та вбудований асинхронний потік завдань/стану. +- Використовуйте шлях плагіна, наприклад ComfyUI, якщо вам потрібен власний граф workflow або провайдер, який не входить до спільної вбудованої можливості музики. +- Якщо ви налагоджуєте поведінку, специфічну для ComfyUI, див. [ComfyUI](/uk/providers/comfy). Якщо ви налагоджуєте поведінку спільного провайдера, почніть із [Google (Gemini)](/uk/providers/google) або [MiniMax](/uk/providers/minimax). -## Live тести +## Живі тести -Опційне live-покриття для спільних вбудованих провайдерів: +Добровільне live-покриття для спільних вбудованих провайдерів: ```bash OPENCLAW_LIVE_TEST=1 pnpm test:live -- extensions/music-generation-providers.live.test.ts ``` -Опційне live-покриття для вбудованого музичного шляху ComfyUI: +Добровільне live-покриття для вбудованого музичного шляху ComfyUI: ```bash OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy.live.test.ts @@ -210,5 +210,5 @@ OPENCLAW_LIVE_TEST=1 COMFY_LIVE_TEST=1 pnpm test:live -- extensions/comfy/comfy. - [ComfyUI](/uk/providers/comfy) - [Google (Gemini)](/uk/providers/google) - [MiniMax](/uk/providers/minimax) -- [Моделі](/uk/concepts/models) - конфігурація моделей і перемикання на резервні +- [Моделі](/uk/concepts/models) - конфігурація моделей і перемикання при відмові - [Огляд інструментів](/uk/tools)