From 18dae697331aaece132f354148ab8d13fef8544a Mon Sep 17 00:00:00 2001 From: "openclaw-docs-i18n[bot]" Date: Sun, 5 Apr 2026 23:19:10 +0000 Subject: [PATCH] chore(i18n): refresh uk translations --- docs/uk/tools/image-generation.md | 82 +++++++++++++++---------------- 1 file changed, 41 insertions(+), 41 deletions(-) diff --git a/docs/uk/tools/image-generation.md b/docs/uk/tools/image-generation.md index 9aad551a1..2557ce82d 100644 --- a/docs/uk/tools/image-generation.md +++ b/docs/uk/tools/image-generation.md @@ -1,31 +1,31 @@ --- read_when: - - Генерування зображень через агента + - Генерація зображень через агента - Налаштування провайдерів і моделей для генерації зображень - Розуміння параметрів інструмента image_generate summary: Генеруйте та редагуйте зображення за допомогою налаштованих провайдерів (OpenAI, Google Gemini, fal, MiniMax) title: Генерація зображень x-i18n: - generated_at: "2026-04-05T22:23:29Z" + generated_at: "2026-04-05T23:19:10Z" model: gpt-5.4 provider: openai - source_hash: 7ef7849a002f2328b94d1d55e7e0c8f3a59640ba269657c4184311c316c674fd + source_hash: 46afbcbfebe0b798422208d39dc4c97584985fe8c3f08b0ed9002a0a77c5eea5 source_path: tools/image-generation.md workflow: 15 --- # Генерація зображень -Інструмент `image_generate` дає змогу агенту створювати та редагувати зображення за допомогою ваших налаштованих провайдерів. Згенеровані зображення автоматично доставляються як медіавкладення у відповіді агента. +Інструмент `image_generate` дає агенту змогу створювати та редагувати зображення за допомогою ваших налаштованих провайдерів. Згенеровані зображення автоматично доставляються як медіавкладення у відповіді агента. -Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації зображень. Якщо ви не бачите `image_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.imageGenerationModel` або задайте ключ API провайдера. +Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації зображень. Якщо ви не бачите `image_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.imageGenerationModel` або задайте API-ключ провайдера. ## Швидкий старт -1. Установіть ключ API щонайменше для одного провайдера (наприклад, `OPENAI_API_KEY` або `GEMINI_API_KEY`). -2. За потреби встановіть бажану модель: +1. Задайте API-ключ щонайменше для одного провайдера (наприклад, `OPENAI_API_KEY` або `GEMINI_API_KEY`). +2. За бажанням задайте бажану модель: ```json5 { @@ -39,20 +39,20 @@ x-i18n: } ``` -3. Попросіть агента: _"Згенеруй зображення дружнього лобстера-маскота."_ +3. Попросіть агента: _"Згенеруй зображення дружнього маскота-лобстера."_ -Агент автоматично викликає `image_generate`. Жодного списку дозволів для інструментів не потрібно — його ввімкнено за замовчуванням, коли провайдер доступний. +Агент автоматично викликає `image_generate`. Додавати інструмент до списку дозволених не потрібно — його ввімкнено за замовчуванням, коли провайдер доступний. ## Підтримувані провайдери -| Провайдер | Модель за замовчуванням | Підтримка редагування | Ключ API | -| --------- | -------------------------------- | ----------------------- | ----------------------------------------------------- | -| OpenAI | `gpt-image-1` | Так (до 5 зображень) | `OPENAI_API_KEY` | -| Google | `gemini-3.1-flash-image-preview` | Так | `GEMINI_API_KEY` або `GOOGLE_API_KEY` | -| fal | `fal-ai/flux/dev` | Так | `FAL_KEY` | -| MiniMax | `image-01` | Так (референс суб’єкта) | `MINIMAX_API_KEY` або MiniMax OAuth (`minimax-portal`) | +| Провайдер | Модель за замовчуванням | Підтримка редагування | API-ключ | +| --------- | -------------------------------- | ------------------------ | ------------------------------------------------------ | +| OpenAI | `gpt-image-1` | Так (до 5 зображень) | `OPENAI_API_KEY` | +| Google | `gemini-3.1-flash-image-preview` | Так | `GEMINI_API_KEY` або `GOOGLE_API_KEY` | +| fal | `fal-ai/flux/dev` | Так | `FAL_KEY` | +| MiniMax | `image-01` | Так (посилання на об’єкт) | `MINIMAX_API_KEY` або MiniMax OAuth (`minimax-portal`) | -Використовуйте `action: "list"`, щоб переглянути доступні провайдери та моделі під час виконання: +Використовуйте `action: "list"`, щоб переглянути доступних провайдерів і моделі під час виконання: ``` /tool image_generate action=list @@ -62,18 +62,18 @@ x-i18n: | Параметр | Тип | Опис | | ------------- | -------- | ------------------------------------------------------------------------------------- | -| `prompt` | string | Запит для генерації зображення (обов’язковий для `action: "generate"`) | +| `prompt` | string | Підказка для генерації зображення (обов’язкова для `action: "generate"`) | | `action` | string | `"generate"` (типово) або `"list"` для перегляду провайдерів | | `model` | string | Перевизначення провайдера/моделі, наприклад `openai/gpt-image-1` | -| `image` | string | Шлях або URL одного референсного зображення для режиму редагування | -| `images` | string[] | Кілька референсних зображень для режиму редагування (до 5) | -| `size` | string | Підказка розміру: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` | +| `image` | string | Шлях або URL одного еталонного зображення для режиму редагування | +| `images` | string[] | Кілька еталонних зображень для режиму редагування (до 5) | +| `size` | string | Підказка щодо розміру: `1024x1024`, `1536x1024`, `1024x1536`, `1024x1792`, `1792x1024` | | `aspectRatio` | string | Співвідношення сторін: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` | -| `resolution` | string | Підказка роздільної здатності: `1K`, `2K` або `4K` | +| `resolution` | string | Підказка щодо роздільної здатності: `1K`, `2K` або `4K` | | `count` | number | Кількість зображень для генерації (1–4) | -| `filename` | string | Підказка для назви вихідного файла | +| `filename` | string | Підказка щодо назви вихідного файла | -Не всі провайдери підтримують усі параметри. Інструмент передає те, що підтримує кожен провайдер, а решту ігнорує. +Не всі провайдери підтримують усі параметри. Інструмент передає те, що підтримує кожен провайдер, ігнорує решту та повідомляє про відкинуті перевизначення в результаті інструмента. ## Конфігурація @@ -98,49 +98,49 @@ x-i18n: 1. Параметр **`model`** з виклику інструмента (якщо агент його вказує) 2. **`imageGenerationModel.primary`** з конфігурації -3. **`imageGenerationModel.fallbacks`** у заданому порядку -4. **Автовиявлення** — використовує лише типові значення провайдерів, підкріплені автентифікацією: +3. **`imageGenerationModel.fallbacks`** у вказаному порядку +4. **Автовизначення** — використовує лише типові значення провайдерів, підкріплені автентифікацією: - спочатку поточний типовий провайдер - - решта зареєстрованих провайдерів генерації зображень у порядку ідентифікаторів провайдерів + - потім решта зареєстрованих провайдерів генерації зображень у порядку provider-id -Якщо провайдер завершується помилкою (помилка автентифікації, обмеження швидкості тощо), автоматично пробується наступний кандидат. Якщо всі завершаться помилкою, помилка міститиме подробиці кожної спроби. +Якщо провайдер завершується помилкою (помилка автентифікації, ліміт запитів тощо), автоматично пробується наступний кандидат. Якщо не спрацюють усі, помилка міститиме подробиці кожної спроби. Примітки: -- Автовиявлення враховує автентифікацію. Типове значення провайдера потрапляє до списку кандидатів лише тоді, коли OpenClaw справді може автентифікувати цей провайдер. -- Використовуйте `action: "list"`, щоб переглянути наразі зареєстрованих провайдерів, їхні типові моделі та підказки щодо змінних середовища для автентифікації. +- Автовизначення враховує автентифікацію. Типове значення провайдера потрапляє до списку кандидатів лише тоді, коли OpenClaw справді може автентифікувати цей провайдер. +- Використовуйте `action: "list"`, щоб переглянути наразі зареєстрованих провайдерів, їхні типові моделі та підказки щодо env vars для автентифікації. ### Редагування зображень -OpenAI, Google, fal і MiniMax підтримують редагування референсних зображень. Передайте шлях або URL референсного зображення: +OpenAI, Google, fal і MiniMax підтримують редагування еталонних зображень. Передайте шлях або URL еталонного зображення: ``` "Згенеруй акварельну версію цього фото" + image: "/path/to/photo.jpg" ``` -OpenAI і Google підтримують до 5 референсних зображень через параметр `images`. fal і MiniMax підтримують 1. +OpenAI і Google підтримують до 5 еталонних зображень через параметр `images`. fal і MiniMax підтримують 1. Генерація зображень MiniMax доступна через обидва вбудовані шляхи автентифікації MiniMax: -- `minimax/image-01` для налаштувань із ключем API -- `minimax-portal/image-01` для налаштувань із OAuth +- `minimax/image-01` для налаштувань з API-ключем +- `minimax-portal/image-01` для налаштувань з OAuth ## Можливості провайдерів -| Можливість | OpenAI | Google | fal | MiniMax | -| ---------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | -| Генерація | Так (до 4) | Так (до 4) | Так (до 4) | Так (до 9) | -| Редагування/референс | Так (до 5 зображень) | Так (до 5 зображень) | Так (1 зображення) | Так (1 зображення, референс суб’єкта) | -| Керування розміром | Так | Так | Так | Ні | -| Співвідношення сторін | Ні | Так | Так (лише генерація) | Так | +| Можливість | OpenAI | Google | fal | MiniMax | +| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | +| Генерація | Так (до 4) | Так (до 4) | Так (до 4) | Так (до 9) | +| Редагування/еталон | Так (до 5 зображень) | Так (до 5 зображень) | Так (1 зображення) | Так (1 зображення, посилання на об’єкт) | +| Керування розміром | Так | Так | Так | Ні | +| Співвідношення сторін | Ні | Так | Так (лише генерація) | Так | | Роздільна здатність (1K/2K/4K) | Ні | Так | Так | Ні | ## Пов’язане - [Огляд інструментів](/uk/tools) — усі доступні інструменти агента -- [fal](/providers/fal) — налаштування провайдера зображень і відео fal +- [fal](/uk/providers/fal) — налаштування провайдера зображень і відео fal - [Google (Gemini)](/uk/providers/google) — налаштування провайдера зображень Gemini - [MiniMax](/uk/providers/minimax) — налаштування провайдера зображень MiniMax - [OpenAI](/uk/providers/openai) — налаштування провайдера OpenAI Images - [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults) — конфігурація `imageGenerationModel` -- [Моделі](/uk/concepts/models) — конфігурація моделей і резервне перемикання +- [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання на резервні варіанти