chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
a0985da6e1
commit
18dae69733
@ -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` дає агенту змогу створювати та редагувати зображення за допомогою ваших налаштованих провайдерів. Згенеровані зображення автоматично доставляються як медіавкладення у відповіді агента.
|
||||
|
||||
<Note>
|
||||
Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації зображень. Якщо ви не бачите `image_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.imageGenerationModel` або задайте ключ API провайдера.
|
||||
Інструмент з’являється лише тоді, коли доступний принаймні один провайдер генерації зображень. Якщо ви не бачите `image_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.imageGenerationModel` або задайте API-ключ провайдера.
|
||||
</Note>
|
||||
|
||||
## Швидкий старт
|
||||
|
||||
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) — конфігурація моделей і перемикання на резервні варіанти
|
||||
|
||||
Loading…
Reference in New Issue
Block a user