openclaw/docs
openclaw/docs
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(i18n): refresh uk translations

Browse Source
This commit is contained in:
openclaw-docs-i18n[bot] 2026-04-24 00:47:20 +00:00
parent 6dfddfeefe
commit dcf23b414c
3 changed files with 647 additions and 634 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1020
docs/uk/help/testing.md
View File

File diff suppressed because it is too large Load Diff

94
docs/uk/providers/openrouter.md
View File

@ -1,20 +1,21 @@
---
read_when:
- You want a single API key for many LLMs
- Вам потрібен один API-ключ для багатьох LLM-ів
- Ви хочете запускати моделі через OpenRouter в OpenClaw
summary: Використання уніфікованого API OpenRouter для доступу до багатьох моделей в OpenClaw
- Ви хочете використовувати OpenRouter для генерації зображень
summary: Використовуйте уніфікований API OpenRouter для доступу до багатьох моделей в OpenClaw
title: OpenRouter
x-i18n:
generated_at: "2026-04-23T21:07:37Z"
generated_at: "2026-04-24T00:42:40Z"
model: gpt-5.4
provider: openai
source_hash: 29532ce2b7fa2b4643db155f6fd6ee17fd9d14ddf65d5e78d0970a4db7b7694a
source_hash: 7516910f67a8adfb107d07cadd73c34ddd110422ecb90278025d4d6344937aac
source_path: providers/openrouter.md
workflow: 15
---
OpenRouter надає **уніфікований API**, який маршрутизує запити до багатьох моделей через один
endpoint і один API-ключ. Він сумісний з OpenAI, тому більшість OpenAI SDK працюють, якщо змінити base URL.
OpenRouter надає **уніфікований API**, який спрямовує запити до багатьох моделей через єдину
кінцеву точку та API-ключ. Він сумісний з OpenAI, тому більшість SDK OpenAI працюють, якщо змінити базовий URL.
## Початок роботи
@ -28,7 +29,7 @@ endpoint і один API-ключ. Він сумісний з OpenAI, тому
```
</Step>
<Step title="(Необов’язково) Перемкніться на конкретну модель">
Онбординг типово встановлює `openrouter/auto`. Пізніше можна вибрати конкретну модель:
Під час онбордингу типовим значенням є `openrouter/auto`. Пізніше виберіть конкретну модель:
```bash
openclaw models set openrouter/<provider>/<model>
@ -50,70 +51,89 @@ endpoint і один API-ключ. Він сумісний з OpenAI, тому
}
```
## Посилання на моделі
## Посилання моделей
<Note>
Посилання на моделі мають формат `openrouter/<provider>/<model>`. Повний список
доступних provider і моделей див. у [/concepts/model-providers](/uk/concepts/model-providers).
Посилання моделей відповідають шаблону `openrouter/<provider>/<model>`. Повний список
доступних провайдерів і моделей дивіться в [/concepts/model-providers](/uk/concepts/model-providers).
</Note>
Приклади вбудованого fallback:
Приклади вбудованого резервного перемикання:
| Model ref | Примітки |
| ------------------------------------ | ------------------------------- |
| Model ref | Примітки |
| ------------------------------------ | --------------------------------- |
| `openrouter/auto` | Автоматична маршрутизація OpenRouter |
| `openrouter/moonshotai/kimi-k2.6` | Kimi K2.6 через MoonshotAI |
| `openrouter/openrouter/healer-alpha` | Маршрут OpenRouter Healer Alpha |
| `openrouter/openrouter/hunter-alpha` | Маршрут OpenRouter Hunter Alpha |
| `openrouter/moonshotai/kimi-k2.6` | Kimi K2.6 через MoonshotAI |
| `openrouter/openrouter/healer-alpha` | Маршрут OpenRouter Healer Alpha |
| `openrouter/openrouter/hunter-alpha` | Маршрут OpenRouter Hunter Alpha |
## Генерація зображень
OpenRouter також може працювати як основа для інструмента `image_generate`. Використовуйте модель зображень OpenRouter у `agents.defaults.imageGenerationModel`:
```json5
{
env: { OPENROUTER_API_KEY: "sk-or-..." },
agents: {
defaults: {
imageGenerationModel: {
primary: "openrouter/google/gemini-3.1-flash-image-preview",
},
},
},
}
```
OpenClaw надсилає запити на зображення до API зображень chat completions OpenRouter з `modalities: ["image", "text"]`. Моделі зображень Gemini отримують підтримувані підказки `aspectRatio` і `resolution` через `image_config` OpenRouter.
## Автентифікація та заголовки
Під капотом OpenRouter використовує Bearer token з вашим API-ключем.
OpenRouter використовує Bearer token з вашим API-ключем під капотом.
Для реальних запитів OpenRouter (`https://openrouter.ai/api/v1`) OpenClaw також додає
задокументовані OpenRouter заголовки атрибуції застосунку:
У реальних запитах OpenRouter (`https://openrouter.ai/api/v1`) OpenClaw також додає
задокументовані заголовки атрибуції застосунку OpenRouter:
| Заголовок | Значення |
| Header | Value |
| ------------------------- | --------------------- |
| `HTTP-Referer` | `https://openclaw.ai` |
| `X-OpenRouter-Title` | `OpenClaw` |
| `X-OpenRouter-Categories` | `cli-agent` |
<Warning>
Якщо ви перенаправите provider OpenRouter на якийсь інший proxy або base URL, OpenClaw
**не** додаватиме ці OpenRouter-специфічні заголовки або маркери кешу Anthropic.
Якщо ви перенаправите провайдер OpenRouter на якийсь інший проксі або базовий URL, OpenClaw
**не** додаватиме ці специфічні для OpenRouter заголовки або маркери кешу Anthropic.
</Warning>
## Розширена конфігурація
<AccordionGroup>
<Accordion title="Маркери кешу Anthropic">
На перевірених маршрутах OpenRouter refs моделей Anthropic зберігають
На перевірених маршрутах OpenRouter посилання моделей Anthropic зберігають
специфічні для OpenRouter маркери Anthropic `cache_control`, які OpenClaw використовує для
кращого повторного використання prompt-cache у блоках system/developer prompt.
кращого повторного використання кешу промптів у блоках system/developer prompt.
</Accordion>
<Accordion title="Впровадження thinking / reasoning">
<Accordion title="Ін’єкція thinking / reasoning">
На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень thinking з
payload міркувань proxy OpenRouter. Непідтримувані підказки моделі та
`openrouter/auto` пропускають це впровадження міркувань.
payload reasoning проксі OpenRouter. Непідтримувані підказки моделей і
`openrouter/auto` пропускають цю ін’єкцію reasoning.
</Accordion>
<Accordion title="Формування запитів лише для OpenAI">
OpenRouter усе одно працює через proxy-подібний OpenAI-сумісний шлях, тому
нативне формування запитів лише для OpenAI, таке як `serviceTier`, Responses `store`,
payload сумісності reasoning OpenAI та підказки prompt-cache, не передається далі.
OpenRouter усе ще працює через сумісний з OpenAI шлях у стилі проксі, тому
нативне формування запитів лише для OpenAI, таке як `serviceTier`, `store` у Responses,
payload сумісності reasoning OpenAI та підказки кешу промптів, не передається далі.
</Accordion>
<Accordion title="Маршрути на базі Gemini">
refs OpenRouter на базі Gemini залишаються на proxy-Gemini шляху: OpenClaw зберігає
там санітизацію thought-signature Gemini, але не вмикає нативну валідацію replay Gemini
Посилання OpenRouter на базі Gemini залишаються на шляху proxy-Gemini: OpenClaw зберігає
там очищення thought-signature Gemini, але не вмикає нативну перевірку повторного відтворення Gemini
або bootstrap rewrites.
</Accordion>
<Accordion title="Метадані маршрутизації provider">
Якщо ви передаєте маршрутизацію provider OpenRouter у параметрах моделі, OpenClaw передає
її як метадані маршрутизації OpenRouter до запуску спільних stream wrappers.
<Accordion title="Метадані маршрутизації провайдера">
Якщо ви передаєте маршрутизацію провайдера OpenRouter через параметри моделі, OpenClaw пересилає
її як метадані маршрутизації OpenRouter до запуску спільних обгорток потоку.
</Accordion>
</AccordionGroup>
@ -121,9 +141,9 @@ endpoint і один API-ключ. Він сумісний з OpenAI, тому
<CardGroup cols={2}>
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
Вибір provider, refs моделей і поведінки failover.
Вибір провайдерів, посилань моделей і поведінки резервного перемикання.
</Card>
<Card title="Довідник конфігурації" href="/uk/gateway/configuration-reference" icon="gear">
Повний довідник конфігурації для agents, models і providers.
Повний довідник конфігурації для агентів, моделей і провайдерів.
</Card>
</CardGroup>

167
docs/uk/tools/image-generation.md
View File

@ -3,13 +3,13 @@ read_when:
- Генерація зображень через агента
- Налаштування провайдерів і моделей для генерації зображень
- Розуміння параметрів інструмента `image_generate`
summary: Генеруйте та редагуйте зображення за допомогою налаштованих провайдерів (OpenAI, OpenAI Codex OAuth, Google Gemini, fal, MiniMax, ComfyUI, Vydra, xAI)
summary: Генеруйте та редагуйте зображення за допомогою налаштованих провайдерів (OpenAI, OpenAI Codex OAuth, Google Gemini, OpenRouter, fal, MiniMax, ComfyUI, Vydra, xAI)
title: Генерація зображень
x-i18n:
generated_at: "2026-04-23T23:47:36Z"
generated_at: "2026-04-24T00:42:41Z"
model: gpt-5.4
provider: openai
source_hash: 2ee9f19389824e99d7a2d74f212564e1658b904eb722f09c4a402fcaeabd2487
source_hash: 427df6a3aa2adebef13cb77b6bbc161c010477d8f669b7c20b917382c3acb224
source_path: tools/image-generation.md
workflow: 15
---
@ -22,8 +22,8 @@ x-i18n:
## Швидкий старт
1. Установіть API-ключ щонайменше для одного провайдера (наприклад, `OPENAI_API_KEY` або `GEMINI_API_KEY`) або увійдіть через OpenAI Codex OAuth.
2. За потреби задайте бажану модель:
1. Установіть API-ключ щонайменше для одного провайдера (наприклад, `OPENAI_API_KEY`, `GEMINI_API_KEY` або `OPENROUTER_API_KEY`) або увійдіть через OpenAI Codex OAuth.
2. За бажанням установіть бажану модель:
```json5
{
@ -37,33 +37,28 @@ x-i18n:
}
```
Codex OAuth використовує той самий референс моделі `openai/gpt-image-2`. Коли
налаштовано OAuth-профіль `openai-codex`, OpenClaw спрямовує запити на
зображення через той самий OAuth-профіль замість того, щоб спочатку пробувати `OPENAI_API_KEY`.
Явна користувацька конфігурація зображень `models.providers.openai`, наприклад API-ключ або
користувацький/Azure base URL, знову вмикає прямий маршрут через OpenAI Images API.
Для OpenAI-сумісних LAN-ендпойнтів, таких як LocalAI, залиште користувацький
`models.providers.openai.baseUrl` і явно ввімкніть
`browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true`; приватні/внутрішні
ендпойнти зображень за замовчуванням залишаються заблокованими.
Codex OAuth використовує те саме посилання на модель `openai/gpt-image-2`. Коли налаштовано OAuth-профіль `openai-codex`, OpenClaw спрямовує запити на зображення через цей самий OAuth-профіль замість того, щоб спочатку пробувати `OPENAI_API_KEY`.
Явна користувацька конфігурація зображень `models.providers.openai`, наприклад API-ключ або користувацький/Azure base URL, знову вмикає прямий маршрут через OpenAI Images API.
Для OpenAI-сумісних LAN-ендпойнтів, таких як LocalAI, зберігайте користувацький `models.providers.openai.baseUrl` і явно вмикайте доступ через `browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true`; приватні/внутрішні ендпойнти зображень за замовчуванням залишаються заблокованими.
3. Попросіть агента: _"Згенеруй зображення дружнього робота-маскота."_
Агент автоматично викликає `image_generate`. Дозволи для списку інструментів не потрібні — інструмент увімкнений за замовчуванням, коли доступний провайдер.
Агент автоматично викликає `image_generate`. Додавати інструмент до списку дозволених не потрібно — він увімкнений за замовчуванням, коли доступний провайдер.
## Підтримувані провайдери
| Провайдер | Модель за замовчуванням | Підтримка редагування | Автентифікація |
| --------- | -------------------------------- | ---------------------------------- | ------------------------------------------------------ |
| OpenAI | `gpt-image-2` | Так (до 4 зображень) | `OPENAI_API_KEY` або OpenAI Codex OAuth |
| 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`) |
| ComfyUI | `workflow` | Так (1 зображення, задається workflow) | `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` для хмари |
| Vydra | `grok-imagine` | Ні | `VYDRA_API_KEY` |
| xAI | `grok-imagine-image` | Так (до 5 зображень) | `XAI_API_KEY` |
| Провайдер | Модель за замовчуванням | Підтримка редагування | Автентифікація |
| --------- | --------------------------------------- | ---------------------------------- | ------------------------------------------------------ |
| OpenAI | `gpt-image-2` | Так (до 4 зображень) | `OPENAI_API_KEY` або OpenAI Codex OAuth |
| OpenRouter | `google/gemini-3.1-flash-image-preview` | Так (до 5 вхідних зображень) | `OPENROUTER_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`) |
| ComfyUI | `workflow` | Так (1 зображення, налаштовується workflow) | `COMFY_API_KEY` або `COMFY_CLOUD_API_KEY` для хмари |
| Vydra | `grok-imagine` | Ні | `VYDRA_API_KEY` |
| xAI | `grok-imagine-image` | Так (до 5 зображень) | `XAI_API_KEY` |
Використовуйте `action: "list"`, щоб під час виконання переглянути доступні провайдери та моделі:
Використовуйте `action: "list"`, щоб переглянути доступні провайдери та моделі під час виконання:
```
/tool image_generate action=list
@ -76,7 +71,7 @@ Codex OAuth використовує той самий референс моде
</ParamField>
<ParamField path="action" type="'generate' | 'list'" default="generate">
Використовуйте `"list"`, щоб під час виконання переглянути доступні провайдери та моделі.
Використовуйте `"list"`, щоб переглянути доступні провайдери та моделі під час виконання.
</ParamField>
<ParamField path="model" type="string">
@ -84,7 +79,7 @@ Codex OAuth використовує той самий референс моде
</ParamField>
<ParamField path="image" type="string">
Шлях або URL одного референсного зображення для режиму редагування.
Шлях до одного референсного зображення або URL для режиму редагування.
</ParamField>
<ParamField path="images" type="string[]">
@ -104,11 +99,11 @@ Codex OAuth використовує той самий референс моде
</ParamField>
<ParamField path="quality" type="'low' | 'medium' | 'high' | 'auto'">
Підказка щодо якості, якщо провайдер її підтримує.
Підказка щодо якості, якщо провайдер це підтримує.
</ParamField>
<ParamField path="outputFormat" type="'png' | 'jpeg' | 'webp'">
Підказка щодо формату виводу, якщо провайдер його підтримує.
Підказка щодо формату виводу, якщо провайдер це підтримує.
</ParamField>
<ParamField path="count" type="number">
@ -116,7 +111,7 @@ Codex OAuth використовує той самий референс моде
</ParamField>
<ParamField path="timeoutMs" type="number">
Необов’язковий таймаут запиту до провайдера в мілісекундах.
Необов’язковий тайм-аут запиту до провайдера в мілісекундах.
</ParamField>
<ParamField path="filename" type="string">
@ -127,9 +122,9 @@ Codex OAuth використовує той самий референс моде
Підказки лише для OpenAI: `background`, `moderation`, `outputCompression` і `user`.
</ParamField>
Не всі провайдери підтримують усі параметри. Коли резервний провайдер підтримує близький варіант геометрії замість точно запитаного, OpenClaw перед надсиланням зіставляє запит із найближчим підтримуваним розміром, співвідношенням сторін або роздільною здатністю. Непідтримувані підказки виводу, такі як `quality` або `outputFormat`, відкидаються для провайдерів, які не заявляють таку підтримку, і про це повідомляється в результаті інструмента.
Не всі провайдери підтримують усі параметри. Коли резервний провайдер підтримує близький варіант геометрії замість точно запитаного, OpenClaw перед надсиланням зіставляє запит із найближчим підтримуваним розміром, співвідношенням сторін або роздільною здатністю. Непідтримувані підказки виводу, як-от `quality` або `outputFormat`, відкидаються для провайдерів, які не заявляють такої підтримки, і про це повідомляється в результаті інструмента.
Результати інструмента містять застосовані налаштування. Коли OpenClaw зіставляє геометрію під час переходу до резервного провайдера, повернуті значення `size`, `aspectRatio` і `resolution` відображають те, що фактично було надіслано, а `details.normalization` містить перетворення від запитаного до застосованого значення.
Результати інструмента повідомляють про застосовані параметри. Коли OpenClaw змінює геометрію під час переходу на резервного провайдера, повернені значення `size`, `aspectRatio` і `resolution` відображають те, що фактично було надіслано, а `details.normalization` містить перетворення від запитаного до застосованого.
## Конфігурація
@ -141,66 +136,71 @@ Codex OAuth використовує той самий референс моде
defaults: {
imageGenerationModel: {
primary: "openai/gpt-image-2",
fallbacks: ["google/gemini-3.1-flash-image-preview", "fal/fal-ai/flux/dev"],
fallbacks: [
"openrouter/google/gemini-3.1-flash-image-preview",
"google/gemini-3.1-flash-image-preview",
"fal/fal-ai/flux/dev",
],
},
},
},
}
```
### Порядок вибору провайдерів
### Порядок вибору провайдера
Під час генерації зображення OpenClaw пробує провайдерів у такому порядку:
1. **Параметр `model`** з виклику інструмента (якщо агент його вказує)
2. **`imageGenerationModel.primary`** з конфігурації
3. **`imageGenerationModel.fallbacks`** по порядку
4. **Автовизначення** — використовуються лише значення за замовчуванням провайдерів із підтримкою автентифікації:
1. Параметр **`model`** з виклику інструмента (якщо агент його вказує)
2. **`imageGenerationModel.primary`** із конфігурації
3. **`imageGenerationModel.fallbacks`** у заданому порядку
4. **Автовизначення** — використовує лише типові значення провайдерів, підкріплені автентифікацією:
- спочатку поточний провайдер за замовчуванням
- далі решта зареєстрованих провайдерів генерації зображень у порядку ідентифікаторів провайдерів
- потім решту зареєстрованих провайдерів генерації зображень у порядку provider-id
Якщо провайдер завершується помилкою (помилка автентифікації, ліміт запитів тощо), автоматично пробується наступний кандидат. Якщо помиляються всі, помилка містить подробиці про кожну спробу.
Якщо провайдер не спрацьовує (помилка автентифікації, ліміт запитів тощо), автоматично пробується наступний кандидат. Якщо не спрацьовують усі, помилка містить подробиці кожної спроби.
Примітки:
- Автовизначення враховує стан автентифікації. Значення провайдера за замовчуванням потрапляє до списку кандидатів
лише тоді, коли OpenClaw справді може автентифікувати цей провайдер.
- Автовизначення ввімкнене за замовчуванням. Установіть
`agents.defaults.mediaGenerationAutoProviderFallback: false`, якщо хочете, щоб генерація зображень
використовувала лише явні записи `model`, `primary` і `fallbacks`.
- Використовуйте `action: "list"`, щоб переглянути наразі зареєстрованих провайдерів, їхні
моделі за замовчуванням і підказки щодо env vars для автентифікації.
- Автовизначення враховує автентифікацію. Типове значення провайдера потрапляє до списку кандидатів лише тоді, коли OpenClaw дійсно може автентифікувати цей провайдер.
- Автовизначення ввімкнене за замовчуванням. Установіть `agents.defaults.mediaGenerationAutoProviderFallback: false`, якщо хочете, щоб генерація зображень використовувала лише явні записи `model`, `primary` і `fallbacks`.
- Використовуйте `action: "list"`, щоб переглянути наразі зареєстровані провайдери, їхні моделі за замовчуванням і підказки щодо змінних середовища для автентифікації.
### Редагування зображень
OpenAI, Google, fal, MiniMax, ComfyUI і xAI підтримують редагування референсних зображень. Передайте шлях або URL референсного зображення:
OpenAI, OpenRouter, Google, fal, MiniMax, ComfyUI і xAI підтримують редагування референсних зображень. Передайте шлях до референсного зображення або URL:
```
"Згенеруй акварельну версію цього фото" + image: "/path/to/photo.jpg"
"Згенеруй акварельну версію цієї фотографії" + image: "/path/to/photo.jpg"
```
OpenAI, Google і xAI підтримують до 5 референсних зображень через параметр `images`. fal, MiniMax і ComfyUI підтримують 1.
OpenAI, OpenRouter, Google і xAI підтримують до 5 референсних зображень через параметр `images`. fal, MiniMax і ComfyUI підтримують 1.
### Моделі зображень OpenRouter
Генерація зображень через OpenRouter використовує той самий `OPENROUTER_API_KEY` і маршрутизується через image API chat completions від OpenRouter. Вибирайте моделі зображень OpenRouter за допомогою префікса `openrouter/`:
```json5
{
agents: {
defaults: {
imageGenerationModel: {
primary: "openrouter/google/gemini-3.1-flash-image-preview",
},
},
},
}
```
OpenClaw пересилає в OpenRouter `prompt`, `count`, референсні зображення та сумісні з Gemini підказки `aspectRatio` / `resolution`. Серед поточних вбудованих скорочень для моделей зображень OpenRouter є `google/gemini-3.1-flash-image-preview`, `google/gemini-3-pro-image-preview` і `openai/gpt-5.4-image-2`; використовуйте `action: "list"`, щоб побачити, що надає ваш налаштований Plugin.
### OpenAI `gpt-image-2`
Генерація зображень OpenAI за замовчуванням використовує `openai/gpt-image-2`. Якщо
налаштовано OAuth-профіль `openai-codex`, OpenClaw повторно використовує той самий OAuth-профіль,
який застосовується для моделей чату з підпискою Codex, і надсилає запит на зображення
через бекенд Codex Responses; він не виконує непомітний перехід на
`OPENAI_API_KEY` для цього запиту. Щоб примусово використовувати прямий маршрут через OpenAI Images API,
явно налаштуйте `models.providers.openai` за допомогою API-ключа, користувацького base URL
або ендпойнта Azure. Старішу модель
`openai/gpt-image-1` усе ще можна вибрати явно, але нові запити OpenAI
на генерацію та редагування зображень мають використовувати `gpt-image-2`.
Генерація зображень OpenAI за замовчуванням використовує `openai/gpt-image-2`. Якщо налаштовано OAuth-профіль `openai-codex`, OpenClaw повторно використовує той самий OAuth-профіль, що й для чат-моделей підписки Codex, і надсилає запит на зображення через бекенд Codex Responses; він не переходить непомітно на `OPENAI_API_KEY` для цього запиту. Щоб примусово використовувати прямий маршрут через OpenAI Images API, явно налаштуйте `models.providers.openai` з API-ключем, користувацьким base URL або ендпойнтом Azure. Старішу модель `openai/gpt-image-1` усе ще можна явно вибрати, але нові запити OpenAI на генерацію й редагування зображень мають використовувати `gpt-image-2`.
`gpt-image-2` підтримує як генерацію текст-у-зображення, так і редагування
референсних зображень через той самий інструмент `image_generate`. OpenClaw передає в OpenAI `prompt`,
`count`, `size`, `quality`, `outputFormat` і референсні зображення.
OpenAI не отримує `aspectRatio` або `resolution` безпосередньо; коли можливо,
OpenClaw зіставляє їх із підтримуваним `size`, інакше інструмент повідомляє про них як про
проігноровані перевизначення.
`gpt-image-2` підтримує як генерацію зображень із тексту, так і редагування референсних зображень через той самий інструмент `image_generate`. OpenClaw пересилає до OpenAI `prompt`, `count`, `size`, `quality`, `outputFormat` і референсні зображення. OpenAI не отримує `aspectRatio` або `resolution` безпосередньо; коли це можливо, OpenClaw зіставляє їх із підтримуваним `size`, інакше інструмент повідомляє про них як про проігноровані перевизначення.
Параметри, специфічні для OpenAI, розміщуються в об’єкті `openai`:
Специфічні для OpenAI параметри містяться в об’єкті `openai`:
```json
{
@ -215,11 +215,9 @@ OpenClaw зіставляє їх із підтримуваним `size`, іна
}
```
`openai.background` приймає значення `transparent`, `opaque` або `auto`; прозорі
результати вимагають `outputFormat` `png` або `webp`. `openai.outputCompression`
застосовується до результатів JPEG/WebP.
`openai.background` приймає значення `transparent`, `opaque` або `auto`; прозорий вивід потребує `outputFormat` `png` або `webp`. `openai.outputCompression` застосовується до виводу у форматах JPEG/WebP.
Згенерувати одне горизонтальне 4K-зображення:
Згенерувати одне горизонтальне зображення 4K:
```
/tool image_generate action=generate model=openai/gpt-image-2 prompt="A clean editorial poster for OpenClaw image generation" size=3840x2160 count=1
@ -237,56 +235,51 @@ OpenClaw зіставляє їх із підтримуваним `size`, іна
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Keep the subject, replace the background with a bright studio setup" image=/path/to/reference.png size=1024x1536
```
Редагування з кількома референсами:
Редагувати з кількома референсами:
```
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Combine the character identity from the first image with the color palette from the second" images='["/path/to/character.png","/path/to/palette.jpg"]' size=1536x1024
```
Щоб спрямувати генерацію зображень OpenAI через розгортання Azure OpenAI замість
`api.openai.com`, див. [ендпойнти Azure OpenAI](/uk/providers/openai#azure-openai-endpoints)
у документації провайдера OpenAI.
Щоб маршрутизувати генерацію зображень OpenAI через розгортання Azure OpenAI замість `api.openai.com`, див. [ендпойнти Azure OpenAI](/uk/providers/openai#azure-openai-endpoints) у документації провайдера OpenAI.
Генерація зображень MiniMax доступна через обидва вбудовані шляхи автентифікації MiniMax:
- `minimax/image-01` для конфігурацій з API-ключем
- `minimax-portal/image-01` для конфігурацій з OAuth
- `minimax-portal/image-01` для конфігурацій OAuth
## Можливості провайдерів
| Можливість | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra | xAI |
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ------- | -------------------- |
| Генерація | Так (до 4) | Так (до 4) | Так (до 4) | Так (до 9) | Так (кількість виходів задає workflow) | Так (1) | Так (до 4) |
| Редагування/референс | Так (до 5 зображень) | Так (до 5 зображень) | Так (1 зображення) | Так (1 зображення, референс суб’єкта) | Так (1 зображення, задається workflow) | Ні | Так (до 5 зображень) |
| Генерація | Так (до 4) | Так (до 4) | Так (до 4) | Так (до 9) | Так (кількість виходів визначається workflow) | Так (1) | Так (до 4) |
| Редагування/референси | Так (до 5 зображень) | Так (до 5 зображень) | Так (1 зображення) | Так (1 зображення, референс об’єкта) | Так (1 зображення, налаштовується workflow) | Ні | Так (до 5 зображень) |
| Керування розміром | Так (до 4K) | Так | Так | Ні | Ні | Ні | Ні |
| Співвідношення сторін | Ні | Так | Так (лише генерація) | Так | Ні | Ні | Так |
| Роздільна здатність (1K/2K/4K) | Ні | Так | Так | Ні | Ні | Ні | Так (1K/2K) |
### xAI `grok-imagine-image`
Вбудований провайдер xAI використовує `/v1/images/generations` для запитів лише з промптом
і `/v1/images/edits`, коли присутній `image` або `images`.
Вбудований провайдер xAI використовує `/v1/images/generations` для запитів лише з промптом і `/v1/images/edits`, коли присутній `image` або `images`.
- Моделі: `xai/grok-imagine-image`, `xai/grok-imagine-image-pro`
- Кількість: до 4
- Референси: один `image` або до п’яти `images`
- Співвідношення сторін: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `2:3`, `3:2`
- Роздільна здатність: `1K`, `2K`
- Результати: повертаються як вкладення зображень, якими керує OpenClaw
- Вивід: повертається як вкладення зображень, керовані OpenClaw
OpenClaw навмисно не відкриває власні параметри xAI `quality`, `mask`, `user` або
додаткові співвідношення сторін, доступні лише нативно, доки ці елементи керування не з’являться в спільному
міжпровайдерному контракті `image_generate`.
OpenClaw навмисно не надає доступу до специфічних для xAI параметрів `quality`, `mask`, `user` або додаткових native-only співвідношень сторін, доки ці елементи керування не з’являться у спільному міжпровайдерному контракті `image_generate`.
## Пов’язане
- [Огляд інструментів](/uk/tools) — усі доступні інструменти агента
- [fal](/uk/providers/fal) — налаштування провайдера зображень і відео fal
- [ComfyUI](/uk/providers/comfy) — налаштування локального workflow ComfyUI і Comfy Cloud
- [ComfyUI](/uk/providers/comfy) — налаштування локального ComfyUI і Comfy Cloud workflow
- [Google (Gemini)](/uk/providers/google) — налаштування провайдера зображень Gemini
- [MiniMax](/uk/providers/minimax) — налаштування провайдера зображень MiniMax
- [OpenAI](/uk/providers/openai) — налаштування провайдера OpenAI Images
- [Vydra](/uk/providers/vydra) — налаштування зображень, відео та мовлення Vydra
- [xAI](/uk/providers/xai) — налаштування Grok для зображень, відео, пошуку, виконання коду та TTS
- [Vydra](/uk/providers/vydra) — налаштування зображень, відео й мовлення Vydra
- [xAI](/uk/providers/xai) — налаштування зображень, відео, пошуку, виконання коду та TTS Grok
- [Довідник із конфігурації](/uk/gateway/configuration-reference#agent-defaults) — конфігурація `imageGenerationModel`
- [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання на резервні варіанти
- [Моделі](/uk/concepts/models) — конфігурація моделей і резервне перемикання