chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
1044db6c77
commit
0df99629d3
File diff suppressed because it is too large
Load Diff
@ -1,111 +1,112 @@
|
||||
---
|
||||
read_when:
|
||||
- Ви хочете використовувати моделі OpenAI в OpenClaw
|
||||
- Ви хочете автентифікацію через підписку Codex замість ключів API
|
||||
- Вам потрібна суворіша поведінка виконання агента GPT-5
|
||||
summary: Використовуйте OpenAI через ключі API або підписку Codex в OpenClaw
|
||||
- Ви хочете використовувати автентифікацію підписки Codex замість API-ключів
|
||||
- Вам потрібні суворіші правила виконання для агента GPT-5
|
||||
summary: Використовуйте OpenAI через API-ключі або підписку Codex в OpenClaw
|
||||
title: OpenAI
|
||||
x-i18n:
|
||||
generated_at: "2026-04-25T17:33:09Z"
|
||||
generated_at: "2026-04-25T18:33:43Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 4f099227b8c8be3a4e919ea286fcede1e4e47be60c7593eb63b4cbbe85aa8389
|
||||
source_hash: da975a05e7dad86f4da8d85ff6a7915233321485854e927e3687c06ee1cf7b99
|
||||
source_path: providers/openai.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує три маршрути сімейства OpenAI. Префікс моделі визначає маршрут:
|
||||
|
||||
- **Ключ API** — прямий доступ до OpenAI Platform з оплатою за використання (моделі `openai/*`)
|
||||
- **API-ключ** — прямий доступ до платформи OpenAI з тарифікацією за використанням (моделі `openai/*`)
|
||||
- **Підписка Codex через PI** — вхід через ChatGPT/Codex із доступом за підпискою (моделі `openai-codex/*`)
|
||||
- **Harness app-server Codex** — нативне виконання через app-server Codex (моделі `openai/*` плюс `agents.defaults.embeddedHarness.runtime: "codex"`)
|
||||
- **Каркас app-server Codex** — нативне виконання через app-server Codex (моделі `openai/*` плюс `agents.defaults.embeddedHarness.runtime: "codex"`)
|
||||
|
||||
OpenAI явно підтримує використання OAuth-підписки у зовнішніх інструментах і робочих процесах на кшталт OpenClaw.
|
||||
OpenAI прямо підтримує використання OAuth за підпискою у зовнішніх інструментах і робочих процесах, таких як OpenClaw.
|
||||
|
||||
Провайдер, модель, runtime і канал — це окремі шари. Якщо ці мітки
|
||||
плутаються між собою, прочитайте [Agent runtimes](/uk/concepts/agent-runtimes), перш ніж
|
||||
Провайдер, модель, runtime і канал — це окремі рівні. Якщо ці позначення
|
||||
плутаються між собою, прочитайте [Runtime агентів](/uk/concepts/agent-runtimes), перш ніж
|
||||
змінювати конфігурацію.
|
||||
|
||||
## Швидкий вибір
|
||||
|
||||
| Ціль | Використовуйте | Примітки |
|
||||
| --------------------------------------------- | -------------------------------------------------------- | ---------------------------------------------------------------------------- |
|
||||
| Пряма оплата через ключ API | `openai/gpt-5.5` | Установіть `OPENAI_API_KEY` або запустіть onboarding ключа API OpenAI. |
|
||||
| Пряма тарифікація через API-ключ | `openai/gpt-5.5` | Установіть `OPENAI_API_KEY` або запустіть онбординг OpenAI API-key. |
|
||||
| GPT-5.5 з автентифікацією через підписку ChatGPT/Codex | `openai-codex/gpt-5.5` | Стандартний маршрут PI для Codex OAuth. Найкращий перший вибір для конфігурацій із підпискою. |
|
||||
| GPT-5.5 з нативною поведінкою app-server Codex | `openai/gpt-5.5` плюс `embeddedHarness.runtime: "codex"` | Примусово використовує harness app-server Codex для цього посилання моделі. |
|
||||
| Генерація або редагування зображень | `openai/gpt-image-2` | Працює або з `OPENAI_API_KEY`, або з OpenAI Codex OAuth. |
|
||||
| GPT-5.5 з нативною поведінкою app-server Codex | `openai/gpt-5.5` плюс `embeddedHarness.runtime: "codex"` | Примусово вмикає каркас app-server Codex для цього посилання на модель. |
|
||||
| Генерація або редагування зображень | `openai/gpt-image-2` | Працює як з `OPENAI_API_KEY`, так і з OpenAI Codex OAuth. |
|
||||
| Зображення з прозорим фоном | `openai/gpt-image-1.5` | Використовуйте `outputFormat=png` або `webp` і `openai.background=transparent`. |
|
||||
|
||||
<Note>
|
||||
GPT-5.5 доступна як через прямий доступ до OpenAI Platform API за ключем,
|
||||
так і через маршрути підписки/OAuth. Використовуйте `openai/gpt-5.5` для прямого трафіку
|
||||
GPT-5.5 доступна як через прямий доступ до OpenAI Platform API за API-ключем, так і
|
||||
через маршрути підписки/OAuth. Використовуйте `openai/gpt-5.5` для прямого трафіку
|
||||
через `OPENAI_API_KEY`, `openai-codex/gpt-5.5` для Codex OAuth через PI, або
|
||||
`openai/gpt-5.5` з `embeddedHarness.runtime: "codex"` для нативного harness
|
||||
`openai/gpt-5.5` з `embeddedHarness.runtime: "codex"` для нативного каркаса
|
||||
app-server Codex.
|
||||
</Note>
|
||||
|
||||
<Note>
|
||||
Увімкнення плагіна OpenAI або вибір моделі `openai-codex/*` не
|
||||
вмикає вбудований плагін app-server Codex. OpenClaw вмикає цей плагін лише
|
||||
коли ви явно вибираєте нативний harness Codex через
|
||||
`embeddedHarness.runtime: "codex"` або використовуєте застаріле посилання моделі `codex/*`.
|
||||
Увімкнення Plugin OpenAI або вибір моделі `openai-codex/*` не
|
||||
вмикає вбудований Plugin app-server Codex. OpenClaw вмикає цей Plugin лише
|
||||
коли ви явно вибираєте нативний каркас Codex через
|
||||
`embeddedHarness.runtime: "codex"` або використовуєте застаріле посилання на модель `codex/*`.
|
||||
</Note>
|
||||
|
||||
## Покриття можливостей OpenClaw
|
||||
|
||||
| Можливість OpenAI | Поверхня OpenClaw | Статус |
|
||||
| -------------------------- | --------------------------------------------------------- | ------------------------------------------------------ |
|
||||
| Chat / Responses | провайдер моделі `openai/<model>` | Так |
|
||||
| Моделі підписки Codex | `openai-codex/<model>` з OAuth `openai-codex` | Так |
|
||||
| Harness app-server Codex | `openai/<model>` з `embeddedHarness.runtime: codex` | Так |
|
||||
| Пошук у вебі на стороні сервера | нативний інструмент OpenAI Responses | Так, коли вебпошук увімкнено і не закріплено провайдера |
|
||||
| Зображення | `image_generate` | Так |
|
||||
| Відео | `video_generate` | Так |
|
||||
| Перетворення тексту в мовлення | `messages.tts.provider: "openai"` / `tts` | Так |
|
||||
| Пакетне перетворення мовлення в текст | `tools.media.audio` / розуміння медіа | Так |
|
||||
| Потокове перетворення мовлення в текст | Voice Call `streaming.provider: "openai"` | Так |
|
||||
| Голос у реальному часі | Voice Call `realtime.provider: "openai"` / Control UI Talk | Так |
|
||||
| Embeddings | провайдер embedding для памʼяті | Так |
|
||||
| Можливість OpenAI | Поверхня OpenClaw | Стан |
|
||||
| ------------------------- | ---------------------------------------------------------- | ------------------------------------------------------ |
|
||||
| Chat / Responses | провайдер моделей `openai/<model>` | Так |
|
||||
| Моделі підписки Codex | `openai-codex/<model>` з OAuth `openai-codex` | Так |
|
||||
| Каркас app-server Codex | `openai/<model>` з `embeddedHarness.runtime: codex` | Так |
|
||||
| Серверний вебпошук | нативний інструмент OpenAI Responses | Так, коли вебпошук увімкнено і провайдер не закріплено |
|
||||
| Зображення | `image_generate` | Так |
|
||||
| Відео | `video_generate` | Так |
|
||||
| Перетворення тексту на мовлення | `messages.tts.provider: "openai"` / `tts` | Так |
|
||||
| Пакетне перетворення мовлення на текст | `tools.media.audio` / розуміння медіа | Так |
|
||||
| Потокове перетворення мовлення на текст | Voice Call `streaming.provider: "openai"` | Так |
|
||||
| Голос у реальному часі | Voice Call `realtime.provider: "openai"` / Control UI Talk | Так |
|
||||
| Embeddings | провайдер embedding для пам’яті | Так |
|
||||
|
||||
## Початок роботи
|
||||
|
||||
Виберіть бажаний метод автентифікації та виконайте кроки налаштування.
|
||||
Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Ключ API (OpenAI Platform)">
|
||||
**Найкраще для:** прямого доступу до API та оплати за використання.
|
||||
<Tab title="API-ключ (OpenAI Platform)">
|
||||
**Найкраще для:** прямого доступу до API та тарифікації за використанням.
|
||||
|
||||
<Steps>
|
||||
<Step title="Отримайте свій ключ API">
|
||||
Створіть або скопіюйте ключ API з [панелі OpenAI Platform](https://platform.openai.com/api-keys).
|
||||
<Step title="Отримайте свій API-ключ">
|
||||
Створіть або скопіюйте API-ключ на [панелі OpenAI Platform](https://platform.openai.com/api-keys).
|
||||
</Step>
|
||||
<Step title="Запустіть onboarding">
|
||||
<Step title="Запустіть онбординг">
|
||||
```bash
|
||||
openclaw onboard --auth-choice openai-api-key
|
||||
```
|
||||
|
||||
Або передайте ключ напряму:
|
||||
Або передайте ключ безпосередньо:
|
||||
|
||||
```bash
|
||||
openclaw onboard --openai-api-key "$OPENAI_API_KEY"
|
||||
```
|
||||
</Step>
|
||||
<Step title="Переконайтеся, що модель доступна">
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider openai
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Зведення маршрутів
|
||||
### Підсумок маршрутів
|
||||
|
||||
| Посилання моделі | Маршрут | Автентифікація |
|
||||
| Model ref | Маршрут | Автентифікація |
|
||||
|-----------|-------|------|
|
||||
| `openai/gpt-5.5` | Прямий API OpenAI Platform | `OPENAI_API_KEY` |
|
||||
| `openai/gpt-5.4-mini` | Прямий API OpenAI Platform | `OPENAI_API_KEY` |
|
||||
| `openai/gpt-5.5` | Прямий OpenAI Platform API | `OPENAI_API_KEY` |
|
||||
| `openai/gpt-5.4-mini` | Прямий OpenAI Platform API | `OPENAI_API_KEY` |
|
||||
|
||||
<Note>
|
||||
`openai/*` — це прямий маршрут OpenAI за ключем API, якщо ви явно не
|
||||
примусите harness app-server Codex. Використовуйте `openai-codex/*` для Codex OAuth через
|
||||
`openai/*` — це прямий маршрут OpenAI API-key, якщо ви явно не примусите
|
||||
використання каркаса app-server Codex. Використовуйте `openai-codex/*` для Codex OAuth через
|
||||
стандартний runner PI, або використовуйте `openai/gpt-5.5` з
|
||||
`embeddedHarness.runtime: "codex"` для нативного виконання через app-server Codex.
|
||||
</Note>
|
||||
@ -120,13 +121,13 @@ app-server Codex.
|
||||
```
|
||||
|
||||
<Warning>
|
||||
OpenClaw **не** надає `openai/gpt-5.3-codex-spark`. Живі запити до OpenAI API відхиляють цю модель, і поточний каталог Codex також її не надає.
|
||||
OpenClaw **не** надає `openai/gpt-5.3-codex-spark`. Реальні запити до OpenAI API відхиляють цю модель, і поточний каталог Codex також її не містить.
|
||||
</Warning>
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Підписка Codex">
|
||||
**Найкраще для:** використання вашої підписки ChatGPT/Codex замість окремого ключа API. Codex cloud вимагає входу через ChatGPT.
|
||||
**Найкраще для:** використання вашої підписки ChatGPT/Codex замість окремого API-ключа. Хмарний Codex потребує входу через ChatGPT.
|
||||
|
||||
<Steps>
|
||||
<Step title="Запустіть Codex OAuth">
|
||||
@ -134,13 +135,13 @@ app-server Codex.
|
||||
openclaw onboard --auth-choice openai-codex
|
||||
```
|
||||
|
||||
Або запустіть OAuth напряму:
|
||||
Або запустіть OAuth безпосередньо:
|
||||
|
||||
```bash
|
||||
openclaw models auth login --provider openai-codex
|
||||
```
|
||||
|
||||
Для headless або несприятливих до callback конфігурацій додайте `--device-code`, щоб увійти через потік device-code ChatGPT замість callback браузера localhost:
|
||||
Для headless або конфігурацій із проблемним callback-хостом додайте `--device-code`, щоб увійти через потік device-code ChatGPT замість callback браузера через localhost:
|
||||
|
||||
```bash
|
||||
openclaw models auth login --provider openai-codex --device-code
|
||||
@ -151,24 +152,24 @@ app-server Codex.
|
||||
openclaw config set agents.defaults.model.primary openai-codex/gpt-5.5
|
||||
```
|
||||
</Step>
|
||||
<Step title="Переконайтеся, що модель доступна">
|
||||
<Step title="Перевірте, що модель доступна">
|
||||
```bash
|
||||
openclaw models list --provider openai-codex
|
||||
```
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Зведення маршрутів
|
||||
### Підсумок маршрутів
|
||||
|
||||
| Посилання моделі | Маршрут | Автентифікація |
|
||||
| Model ref | Маршрут | Автентифікація |
|
||||
|-----------|-------|------|
|
||||
| `openai-codex/gpt-5.5` | ChatGPT/Codex OAuth через PI | Вхід Codex |
|
||||
| `openai/gpt-5.5` + `embeddedHarness.runtime: "codex"` | Harness app-server Codex | Автентифікація app-server Codex |
|
||||
| `openai-codex/gpt-5.5` | ChatGPT/Codex OAuth через PI | вхід Codex |
|
||||
| `openai/gpt-5.5` + `embeddedHarness.runtime: "codex"` | Каркас app-server Codex | автентифікація app-server Codex |
|
||||
|
||||
<Note>
|
||||
Продовжуйте використовувати id провайдера `openai-codex` для команд auth/profile. Префікс моделі
|
||||
Продовжуйте використовувати ідентифікатор провайдера `openai-codex` для команд автентифікації/профілю. Префікс моделі
|
||||
`openai-codex/*` також є явним маршрутом PI для Codex OAuth.
|
||||
Він не вибирає і не вмикає автоматично вбудований harness app-server Codex.
|
||||
Він не вибирає і не вмикає автоматично вбудований каркас app-server Codex.
|
||||
</Note>
|
||||
|
||||
### Приклад конфігурації
|
||||
@ -180,28 +181,28 @@ app-server Codex.
|
||||
```
|
||||
|
||||
<Note>
|
||||
Onboarding більше не імпортує матеріали OAuth з `~/.codex`. Увійдіть через OAuth у браузері (за замовчуванням) або через наведений вище потік device-code — OpenClaw керує отриманими обліковими даними у власному сховищі auth агента.
|
||||
Онбординг більше не імпортує матеріали OAuth з `~/.codex`. Увійдіть через OAuth у браузері (за замовчуванням) або через наведений вище потік device-code — OpenClaw керує отриманими обліковими даними у власному сховищі автентифікації агентів.
|
||||
</Note>
|
||||
|
||||
### Індикатор статусу
|
||||
### Індикатор стану
|
||||
|
||||
Chat `/status` показує, який runtime моделі активний для поточної сесії.
|
||||
Стандартний harness PI відображається як `Runtime: OpenClaw Pi Default`. Коли
|
||||
вибрано вбудований harness app-server Codex, `/status` показує
|
||||
`Runtime: OpenAI Codex`. Наявні сесії зберігають записаний для них id harness, тож використовуйте
|
||||
У чаті `/status` показує, який runtime моделі активний для поточної сесії.
|
||||
Стандартний каркас PI відображається як `Runtime: OpenClaw Pi Default`. Коли
|
||||
вибрано вбудований каркас app-server Codex, `/status` показує
|
||||
`Runtime: OpenAI Codex`. Наявні сесії зберігають записаний для них ідентифікатор каркаса, тому використовуйте
|
||||
`/new` або `/reset` після зміни `embeddedHarness`, якщо хочете, щоб `/status`
|
||||
відображав новий вибір PI/Codex.
|
||||
|
||||
### Обмеження контекстного вікна
|
||||
### Обмеження вікна контексту
|
||||
|
||||
OpenClaw розглядає метадані моделі та обмеження контексту runtime як окремі значення.
|
||||
OpenClaw розглядає метадані моделі й обмеження контексту runtime як окремі значення.
|
||||
|
||||
Для `openai-codex/gpt-5.5` через Codex OAuth:
|
||||
|
||||
- Нативний `contextWindow`: `1000000`
|
||||
- Нативне `contextWindow`: `1000000`
|
||||
- Стандартне обмеження runtime `contextTokens`: `272000`
|
||||
|
||||
Менше стандартне обмеження на практиці дає кращі характеристики затримки та якості. Перевизначте його через `contextTokens`:
|
||||
Менше стандартне обмеження на практиці дає кращі характеристики затримки та якості. Перевизначте його за допомогою `contextTokens`:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -221,10 +222,10 @@ app-server Codex.
|
||||
|
||||
### Відновлення каталогу
|
||||
|
||||
OpenClaw використовує метадані каталогу Codex з upstream для `gpt-5.5`, коли вони
|
||||
присутні. Якщо живе виявлення Codex пропускає рядок `openai-codex/gpt-5.5`, поки
|
||||
обліковий запис автентифіковано, OpenClaw синтезує цей рядок моделі OAuth, щоб
|
||||
Cron, субагент і запуски налаштованої моделі за замовчуванням не завершувалися з
|
||||
OpenClaw використовує метадані з вихідного каталогу Codex для `gpt-5.5`, коли вони
|
||||
наявні. Якщо під час живого виявлення Codex пропускається рядок `openai-codex/gpt-5.5`, поки
|
||||
обліковий запис автентифіковано, OpenClaw синтезує цей рядок OAuth-моделі, щоб
|
||||
Cron, субагент і запуски з налаштованою моделлю за замовчуванням не завершувалися помилкою
|
||||
`Unknown model`.
|
||||
|
||||
</Tab>
|
||||
@ -232,19 +233,19 @@ app-server Codex.
|
||||
|
||||
## Генерація зображень
|
||||
|
||||
Вбудований плагін `openai` реєструє генерацію зображень через інструмент `image_generate`.
|
||||
Він підтримує як генерацію зображень OpenAI за ключем API, так і генерацію зображень
|
||||
через Codex OAuth через те саме посилання моделі `openai/gpt-image-2`.
|
||||
Вбудований Plugin `openai` реєструє генерацію зображень через інструмент `image_generate`.
|
||||
Він підтримує як генерацію зображень OpenAI за API-ключем, так і генерацію зображень
|
||||
через Codex OAuth із тим самим посиланням на модель `openai/gpt-image-2`.
|
||||
|
||||
| Можливість | Ключ API OpenAI | Codex OAuth |
|
||||
| ------------------------- | ---------------------------------- | ------------------------------------ |
|
||||
| Посилання моделі | `openai/gpt-image-2` | `openai/gpt-image-2` |
|
||||
| Автентифікація | `OPENAI_API_KEY` | Вхід через OpenAI Codex OAuth |
|
||||
| Транспорт | OpenAI Images API | backend Codex Responses |
|
||||
| Максимум зображень на запит | 4 | 4 |
|
||||
| Режим редагування | Увімкнено (до 5 еталонних зображень) | Увімкнено (до 5 еталонних зображень) |
|
||||
| Перевизначення розміру | Підтримується, включно з розмірами 2K/4K | Підтримується, включно з розмірами 2K/4K |
|
||||
| Співвідношення сторін / роздільна здатність | Не передається в OpenAI Images API | Зіставляється з підтримуваним розміром, коли це безпечно |
|
||||
| Можливість | API-ключ OpenAI | Codex OAuth |
|
||||
| ------------------------ | ----------------------------------- | ------------------------------------ |
|
||||
| Посилання на модель | `openai/gpt-image-2` | `openai/gpt-image-2` |
|
||||
| Автентифікація | `OPENAI_API_KEY` | вхід через OpenAI Codex OAuth |
|
||||
| Транспорт | OpenAI Images API | бекенд Codex Responses |
|
||||
| Макс. зображень на запит | 4 | 4 |
|
||||
| Режим редагування | Увімкнено (до 5 еталонних зображень) | Увімкнено (до 5 еталонних зображень) |
|
||||
| Перевизначення розміру | Підтримується, зокрема розміри 2K/4K | Підтримується, зокрема розміри 2K/4K |
|
||||
| Співвідношення сторін / роздільність | Не передається до OpenAI Images API | Зіставляється з підтримуваним розміром, коли це безпечно |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -257,31 +258,47 @@ app-server Codex.
|
||||
```
|
||||
|
||||
<Note>
|
||||
Див. [Image Generation](/uk/tools/image-generation) для спільних параметрів інструмента, вибору провайдера та поведінки failover.
|
||||
Див. [Генерація зображень](/uk/tools/image-generation) для спільних параметрів інструмента, вибору провайдера та поведінки failover.
|
||||
</Note>
|
||||
|
||||
`gpt-image-2` є стандартною моделлю як для генерації зображень з тексту OpenAI, так і для
|
||||
редагування зображень. `gpt-image-1` залишається доступною як явне перевизначення моделі, але нові
|
||||
робочі процеси OpenAI для зображень мають використовувати `openai/gpt-image-2`.
|
||||
`gpt-image-2` є стандартним варіантом як для генерації зображень за текстом OpenAI, так і для
|
||||
редагування зображень. `gpt-image-1.5`, `gpt-image-1` і `gpt-image-1-mini` залишаються доступними як
|
||||
явні перевизначення моделі. Використовуйте `openai/gpt-image-1.5` для виводу PNG/WebP
|
||||
із прозорим фоном; поточний API `gpt-image-2` відхиляє
|
||||
`background: "transparent"`.
|
||||
|
||||
Для запиту на прозорий фон агенти мають викликати `image_generate` з
|
||||
`model: "openai/gpt-image-1.5"`, `outputFormat: "png"` або `"webp"`, і
|
||||
`openai.background: "transparent"`. OpenClaw також захищає публічні маршрути OpenAI та
|
||||
OpenAI Codex OAuth, переписуючи стандартні прозорі запити `openai/gpt-image-2`
|
||||
на `gpt-image-1.5`; Azure і користувацькі OpenAI-сумісні endpoints зберігають
|
||||
налаштовані назви deployment/model.
|
||||
|
||||
Для інсталяцій із Codex OAuth зберігайте те саме посилання `openai/gpt-image-2`. Коли
|
||||
налаштовано OAuth-профіль `openai-codex`, OpenClaw знаходить цей збережений OAuth
|
||||
access token і надсилає запити на зображення через backend Codex Responses. Він
|
||||
не намагається спочатку використати `OPENAI_API_KEY` і не виконує тихий перехід на ключ API для цього
|
||||
запиту. Налаштуйте `models.providers.openai` явно з ключем API,
|
||||
власним base URL або endpoint Azure, якщо хочете використовувати прямий маршрут OpenAI Images API
|
||||
налаштовано OAuth-профіль `openai-codex`, OpenClaw знаходить збережений OAuth-токен доступу
|
||||
та надсилає запити на зображення через бекенд Codex Responses. Він
|
||||
не намагається спочатку використати `OPENAI_API_KEY` і не виконує тихий fallback на API-ключ для цього
|
||||
запиту. Явно налаштуйте `models.providers.openai` з API-ключем,
|
||||
користувацькою базовою URL-адресою або endpoint Azure, якщо ви хочете використовувати прямий маршрут OpenAI Images API
|
||||
замість цього.
|
||||
Якщо цей власний endpoint для зображень розміщено в довіреній LAN/приватній адресі, також установіть
|
||||
Якщо цей користувацький endpoint зображень розташований у довіреній LAN/приватній адресі, також встановіть
|
||||
`browser.ssrfPolicy.dangerouslyAllowPrivateNetwork: true`; OpenClaw залишає
|
||||
приватні/внутрішні OpenAI-сумісні endpoint для зображень заблокованими, якщо немає цього явного дозволу.
|
||||
приватні/внутрішні OpenAI-сумісні endpoints зображень заблокованими, якщо цей opt-in
|
||||
не задано.
|
||||
|
||||
Генерація:
|
||||
Згенерувати:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1
|
||||
```
|
||||
|
||||
Редагування:
|
||||
Згенерувати прозорий PNG:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-1.5 prompt="A simple red circle sticker on a transparent background" outputFormat=png openai='{"background":"transparent"}'
|
||||
```
|
||||
|
||||
Редагувати:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536
|
||||
@ -289,14 +306,14 @@ access token і надсилає запити на зображення чере
|
||||
|
||||
## Генерація відео
|
||||
|
||||
Вбудований плагін `openai` реєструє генерацію відео через інструмент `video_generate`.
|
||||
Вбудований Plugin `openai` реєструє генерацію відео через інструмент `video_generate`.
|
||||
|
||||
| Можливість | Значення |
|
||||
| --------------- | --------------------------------------------------------------------------------- |
|
||||
| Стандартна модель | `openai/sora-2` |
|
||||
| Режими | Текст у відео, зображення у відео, редагування одного відео |
|
||||
| Вхідні еталони | 1 зображення або 1 відео |
|
||||
| Перевизначення розміру | Підтримується |
|
||||
| Перевизначення розміру | Підтримується |
|
||||
| Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням інструмента |
|
||||
|
||||
```json5
|
||||
@ -310,25 +327,25 @@ access token і надсилає запити на зображення чере
|
||||
```
|
||||
|
||||
<Note>
|
||||
Див. [Video Generation](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover.
|
||||
Див. [Генерація відео](/uk/tools/video-generation) для спільних параметрів інструмента, вибору провайдера та поведінки failover.
|
||||
</Note>
|
||||
|
||||
## Внесок у prompt GPT-5
|
||||
## Внесок у промпт GPT-5
|
||||
|
||||
OpenClaw додає спільний внесок у prompt GPT-5 для запусків сімейства GPT-5 у різних провайдерів. Він застосовується за id моделі, тож `openai-codex/gpt-5.5`, `openai/gpt-5.5`, `openrouter/openai/gpt-5.5`, `opencode/gpt-5.5` та інші сумісні посилання GPT-5 отримують той самий overlay. Старіші моделі GPT-4.x — ні.
|
||||
OpenClaw додає спільний внесок у промпт GPT-5 для запусків сімейства GPT-5 у різних провайдерів. Він застосовується за ідентифікатором моделі, тому `openai-codex/gpt-5.5`, `openai/gpt-5.5`, `openrouter/openai/gpt-5.5`, `opencode/gpt-5.5` та інші сумісні посилання GPT-5 отримують той самий overlay. Старіші моделі GPT-4.x — ні.
|
||||
|
||||
Вбудований нативний harness Codex використовує ту саму поведінку GPT-5 і overlay Heartbeat через інструкції для розробника в app-server Codex, тож сесії `openai/gpt-5.x`, примусово спрямовані через `embeddedHarness.runtime: "codex"`, зберігають ті самі настанови щодо доведення до кінця та проактивного Heartbeat, навіть якщо рештою prompt harness керує Codex.
|
||||
Вбудований нативний каркас Codex використовує ту саму поведінку GPT-5 і overlay Heartbeat через інструкції розробника app-server Codex, тому сесії `openai/gpt-5.x`, примусово спрямовані через `embeddedHarness.runtime: "codex"`, зберігають ті самі настанови щодо доведення задач до кінця та проактивного Heartbeat, навіть попри те, що Codex керує рештою промпта каркаса.
|
||||
|
||||
Внесок GPT-5 додає контракт поведінки з тегами для збереження persona, безпеки виконання, дисципліни інструментів, форми виводу, перевірок завершення та верифікації. Поведінка відповідей і тихих повідомлень, специфічна для каналу, залишається у спільному системному prompt OpenClaw та політиці вихідної доставки. Настанови GPT-5 завжди ввімкнені для відповідних моделей. Шар дружнього стилю взаємодії є окремим і налаштовуваним.
|
||||
Внесок GPT-5 додає тегований контракт поведінки для збереження персони, безпеки виконання, дисципліни інструментів, форми виводу, перевірок завершення та верифікації. Поведінка відповіді й тихих повідомлень, специфічна для каналу, залишається у спільному системному промпті OpenClaw і політиці вихідної доставки. Настанови GPT-5 завжди ввімкнені для відповідних моделей. Рівень дружнього стилю взаємодії є окремим і налаштовуваним.
|
||||
|
||||
| Значення | Ефект |
|
||||
| ---------------------- | --------------------------------------------- |
|
||||
| `"friendly"` (стандартно) | Увімкнути шар дружнього стилю взаємодії |
|
||||
| `"on"` | Псевдонім для `"friendly"` |
|
||||
| `"off"` | Вимкнути лише шар дружнього стилю |
|
||||
| Значення | Ефект |
|
||||
| ---------------------- | ------------------------------------------ |
|
||||
| `"friendly"` (стандартно) | Увімкнути рівень дружнього стилю взаємодії |
|
||||
| `"on"` | Псевдонім для `"friendly"` |
|
||||
| `"off"` | Вимкнути лише рівень дружнього стилю |
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Config">
|
||||
<Tab title="Конфігурація">
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
@ -349,18 +366,18 @@ OpenClaw додає спільний внесок у prompt GPT-5 для зап
|
||||
</Tabs>
|
||||
|
||||
<Tip>
|
||||
Значення нечутливі до регістру під час runtime, тому і `"Off"`, і `"off"` вимикають шар дружнього стилю.
|
||||
Під час виконання значення нечутливі до регістру, тому `"Off"` і `"off"` обидва вимикають рівень дружнього стилю.
|
||||
</Tip>
|
||||
|
||||
<Note>
|
||||
Застаріле `plugins.entries.openai.config.personality` усе ще читається як резервний варіант для сумісності, коли спільне налаштування `agents.defaults.promptOverlays.gpt5.personality` не задано.
|
||||
Застаріле `plugins.entries.openai.config.personality` усе ще зчитується як сумісний fallback, коли спільне налаштування `agents.defaults.promptOverlays.gpt5.personality` не задано.
|
||||
</Note>
|
||||
|
||||
## Голос і мовлення
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Синтез мовлення (TTS)">
|
||||
Вбудований плагін `openai` реєструє синтез мовлення для поверхні `messages.tts`.
|
||||
Вбудований Plugin `openai` реєструє синтез мовлення для поверхні `messages.tts`.
|
||||
|
||||
| Параметр | Шлях конфігурації | Стандартно |
|
||||
|---------|------------|---------|
|
||||
@ -369,7 +386,7 @@ OpenClaw додає спільний внесок у prompt GPT-5 для зап
|
||||
| Швидкість | `messages.tts.providers.openai.speed` | (не задано) |
|
||||
| Інструкції | `messages.tts.providers.openai.instructions` | (не задано, лише `gpt-4o-mini-tts`) |
|
||||
| Формат | `messages.tts.providers.openai.responseFormat` | `opus` для голосових нотаток, `mp3` для файлів |
|
||||
| Ключ API | `messages.tts.providers.openai.apiKey` | Резервно використовує `OPENAI_API_KEY` |
|
||||
| API-ключ | `messages.tts.providers.openai.apiKey` | Використовує `OPENAI_API_KEY` як fallback |
|
||||
| Base URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` |
|
||||
|
||||
Доступні моделі: `gpt-4o-mini-tts`, `tts-1`, `tts-1-hd`. Доступні голоси: `alloy`, `ash`, `ballad`, `cedar`, `coral`, `echo`, `fable`, `juniper`, `marin`, `onyx`, `nova`, `sage`, `shimmer`, `verse`.
|
||||
@ -387,19 +404,19 @@ OpenClaw додає спільний внесок у prompt GPT-5 для зап
|
||||
```
|
||||
|
||||
<Note>
|
||||
Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити base URL для TTS без впливу на endpoint Chat API.
|
||||
Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базову URL-адресу TTS без впливу на endpoint chat API.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Перетворення мовлення в текст">
|
||||
Вбудований плагін `openai` реєструє пакетне перетворення мовлення в текст через
|
||||
поверхню транскрибування розуміння медіа OpenClaw.
|
||||
<Accordion title="Перетворення мовлення на текст">
|
||||
Вбудований Plugin `openai` реєструє пакетне перетворення мовлення на текст через
|
||||
поверхню транскрибування для розуміння медіа в OpenClaw.
|
||||
|
||||
- Стандартна модель: `gpt-4o-transcribe`
|
||||
- Endpoint: REST `OpenAI` `/v1/audio/transcriptions`
|
||||
- Шлях введення: multipart-завантаження аудіофайлу
|
||||
- Підтримується в OpenClaw всюди, де вхідне транскрибування аудіо використовує
|
||||
- Endpoint: OpenAI REST `/v1/audio/transcriptions`
|
||||
- Вхідний шлях: multipart-вивантаження аудіофайлу
|
||||
- Підтримується в OpenClaw всюди, де транскрибування вхідного аудіо використовує
|
||||
`tools.media.audio`, зокрема для сегментів голосових каналів Discord і
|
||||
аудіовкладень каналів
|
||||
|
||||
@ -423,31 +440,31 @@ OpenClaw додає спільний внесок у prompt GPT-5 для зап
|
||||
}
|
||||
```
|
||||
|
||||
Підказки щодо мови та prompt передаються в OpenAI, коли вони задаються
|
||||
спільною конфігурацією аудіомедіа або запитом на транскрибування для окремого виклику.
|
||||
Підказки мови та промпта передаються до OpenAI, коли їх надає
|
||||
спільна конфігурація аудіомедіа або запит транскрибування для окремого виклику.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Транскрибування в реальному часі">
|
||||
Вбудований плагін `openai` реєструє транскрибування в реальному часі для плагіна Voice Call.
|
||||
Вбудований Plugin `openai` реєструє транскрибування в реальному часі для Plugin Voice Call.
|
||||
|
||||
| Параметр | Шлях конфігурації | Стандартно |
|
||||
|---------|------------|---------|
|
||||
| Модель | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` |
|
||||
| Мова | `...openai.language` | (не задано) |
|
||||
| Prompt | `...openai.prompt` | (не задано) |
|
||||
| Промпт | `...openai.prompt` | (не задано) |
|
||||
| Тривалість тиші | `...openai.silenceDurationMs` | `800` |
|
||||
| Поріг VAD | `...openai.vadThreshold` | `0.5` |
|
||||
| Ключ API | `...openai.apiKey` | Резервно використовує `OPENAI_API_KEY` |
|
||||
| API-ключ | `...openai.apiKey` | Використовує `OPENAI_API_KEY` як fallback |
|
||||
|
||||
<Note>
|
||||
Використовує зʼєднання WebSocket із `wss://api.openai.com/v1/realtime` з аудіо формату G.711 u-law (`g711_ulaw` / `audio/pcmu`). Цей потоковий провайдер призначений для шляху транскрибування в реальному часі плагіна Voice Call; Discord voice наразі записує короткі сегменти й натомість використовує шлях пакетного транскрибування `tools.media.audio`.
|
||||
Використовує WebSocket-з’єднання з `wss://api.openai.com/v1/realtime` з аудіо G.711 u-law (`g711_ulaw` / `audio/pcmu`). Цей потоковий провайдер призначений для шляху транскрибування в реальному часі у Voice Call; голос Discord наразі записує короткі сегменти та натомість використовує пакетний шлях транскрибування `tools.media.audio`.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Голос у реальному часі">
|
||||
Вбудований плагін `openai` реєструє голос у реальному часі для плагіна Voice Call.
|
||||
Вбудований Plugin `openai` реєструє голос у реальному часі для Plugin Voice Call.
|
||||
|
||||
| Параметр | Шлях конфігурації | Стандартно |
|
||||
|---------|------------|---------|
|
||||
@ -456,40 +473,41 @@ OpenClaw додає спільний внесок у prompt GPT-5 для зап
|
||||
| Temperature | `...openai.temperature` | `0.8` |
|
||||
| Поріг VAD | `...openai.vadThreshold` | `0.5` |
|
||||
| Тривалість тиші | `...openai.silenceDurationMs` | `500` |
|
||||
| Ключ API | `...openai.apiKey` | Резервно використовує `OPENAI_API_KEY` |
|
||||
| API-ключ | `...openai.apiKey` | Використовує `OPENAI_API_KEY` як fallback |
|
||||
|
||||
<Note>
|
||||
Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двобічний виклик інструментів. Використовує аудіоформат G.711 u-law.
|
||||
Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонапрямлений виклик інструментів. Використовує аудіоформат G.711 u-law.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Endpoint Azure OpenAI
|
||||
## Endpoint-и Azure OpenAI
|
||||
|
||||
Вбудований провайдер `openai` може націлюватися на ресурс Azure OpenAI для генерації
|
||||
зображень через перевизначення base URL. На шляху генерації зображень OpenClaw
|
||||
виявляє імена хостів Azure в `models.providers.openai.baseUrl` і автоматично
|
||||
перемикається на формат запиту Azure.
|
||||
Вбудований провайдер `openai` може націлюватися на ресурс Azure OpenAI для
|
||||
генерації зображень шляхом перевизначення базової URL-адреси. На шляху генерації зображень OpenClaw
|
||||
визначає хостнейми Azure у `models.providers.openai.baseUrl` і автоматично перемикається на
|
||||
форму запиту Azure.
|
||||
|
||||
<Note>
|
||||
Голос у реальному часі використовує окремий шлях конфігурації
|
||||
(`plugins.entries.voice-call.config.realtime.providers.openai.azureEndpoint`)
|
||||
і на нього не впливає `models.providers.openai.baseUrl`. Див. accordion **Голос у реальному
|
||||
часі** в розділі [Голос і мовлення](#voice-and-speech), щоб дізнатися про його налаштування Azure.
|
||||
і на нього не впливає `models.providers.openai.baseUrl`. Див. акордеон **Голос
|
||||
у реальному часі** в розділі [Голос і мовлення](#voice-and-speech) для його параметрів
|
||||
Azure.
|
||||
</Note>
|
||||
|
||||
Використовуйте Azure OpenAI, коли:
|
||||
|
||||
- У вас уже є підписка, квота або корпоративна угода Azure OpenAI
|
||||
- Вам потрібне регіональне зберігання даних або засоби контролю відповідності, які надає Azure
|
||||
- Ви хочете зберігати трафік у межах наявного tenancy Azure
|
||||
- У вас уже є підписка Azure OpenAI, квота або корпоративна угода
|
||||
- Вам потрібна регіональна резидентність даних або механізми відповідності, які надає Azure
|
||||
- Ви хочете зберегти трафік у межах наявного tenancy Azure
|
||||
|
||||
### Конфігурація
|
||||
|
||||
Для генерації зображень через Azure у вбудованому провайдері `openai` укажіть
|
||||
`models.providers.openai.baseUrl` на ваш ресурс Azure і встановіть `apiKey` як
|
||||
ключ Azure OpenAI (а не ключ OpenAI Platform):
|
||||
Для генерації зображень через Azure за допомогою вбудованого провайдера `openai` укажіть
|
||||
`models.providers.openai.baseUrl` на ваш ресурс Azure і встановіть `apiKey` у значення
|
||||
ключа Azure OpenAI (не ключа OpenAI Platform):
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -504,7 +522,7 @@ OpenClaw додає спільний внесок у prompt GPT-5 для зап
|
||||
}
|
||||
```
|
||||
|
||||
OpenClaw розпізнає ці суфікси хостів Azure для маршруту генерації зображень Azure:
|
||||
OpenClaw розпізнає такі суфікси хостів Azure для маршруту Azure генерації зображень:
|
||||
|
||||
- `*.openai.azure.com`
|
||||
- `*.services.ai.azure.com`
|
||||
@ -513,16 +531,16 @@ OpenClaw розпізнає ці суфікси хостів Azure для мар
|
||||
Для запитів генерації зображень на розпізнаному хості Azure OpenClaw:
|
||||
|
||||
- Надсилає заголовок `api-key` замість `Authorization: Bearer`
|
||||
- Використовує шляхи в межах deployment (`/openai/deployments/{deployment}/...`)
|
||||
- Використовує шляхи з областю deployment (`/openai/deployments/{deployment}/...`)
|
||||
- Додає `?api-version=...` до кожного запиту
|
||||
|
||||
Інші base URL (публічний OpenAI, OpenAI-сумісні проксі) зберігають стандартний
|
||||
формат запиту OpenAI для зображень.
|
||||
Інші base URL (публічний OpenAI, OpenAI-сумісні проксі) зберігають стандартну
|
||||
форму запиту зображень OpenAI.
|
||||
|
||||
<Note>
|
||||
Маршрутизація Azure для шляху генерації зображень у провайдері `openai`
|
||||
потребує OpenClaw 2026.4.22 або новішої версії. Попередні версії обробляють будь-який власний
|
||||
`openai.baseUrl` як публічний endpoint OpenAI і завершаться помилкою при роботі з deployment
|
||||
Маршрутизація Azure для шляху генерації зображень провайдера `openai` потребує
|
||||
OpenClaw 2026.4.22 або новішої версії. Попередні версії обробляють будь-який користувацький
|
||||
`openai.baseUrl` як публічний endpoint OpenAI і не працюватимуть з deployment-ами
|
||||
зображень Azure.
|
||||
</Note>
|
||||
|
||||
@ -535,68 +553,68 @@ OpenClaw розпізнає ці суфікси хостів Azure для мар
|
||||
export AZURE_OPENAI_API_VERSION="2024-12-01-preview"
|
||||
```
|
||||
|
||||
Стандартне значення — `2024-12-01-preview`, коли змінну не встановлено.
|
||||
Стандартне значення — `2024-12-01-preview`, якщо змінну не задано.
|
||||
|
||||
### Назви моделей — це назви deployment
|
||||
|
||||
Azure OpenAI привʼязує моделі до deployment. Для запитів генерації зображень Azure,
|
||||
Azure OpenAI прив’язує моделі до deployment-ів. Для запитів генерації зображень Azure,
|
||||
маршрутизованих через вбудований провайдер `openai`, поле `model` в OpenClaw
|
||||
має бути **назвою deployment Azure**, яку ви налаштували в порталі Azure, а не
|
||||
публічним id моделі OpenAI.
|
||||
публічним ідентифікатором моделі OpenAI.
|
||||
|
||||
Якщо ви створили deployment із назвою `gpt-image-2-prod`, який обслуговує `gpt-image-2`:
|
||||
Якщо ви створили deployment з назвою `gpt-image-2-prod`, який обслуговує `gpt-image-2`:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2-prod prompt="A clean poster" size=1024x1024 count=1
|
||||
```
|
||||
|
||||
Те саме правило назв deployment застосовується до викликів генерації зображень,
|
||||
маршрутизованих через вбудований провайдер `openai`.
|
||||
Те саме правило назв deployment застосовується до викликів генерації зображень, маршрутизованих через
|
||||
вбудований провайдер `openai`.
|
||||
|
||||
### Регіональна доступність
|
||||
|
||||
Генерація зображень Azure наразі доступна лише в підмножині регіонів
|
||||
Наразі генерація зображень Azure доступна лише в частині регіонів
|
||||
(наприклад, `eastus2`, `swedencentral`, `polandcentral`, `westus3`,
|
||||
`uaenorth`). Перевірте актуальний список регіонів Microsoft перед створенням
|
||||
deployment і підтвердьте, що конкретна модель доступна у вашому регіоні.
|
||||
deployment, а також підтвердьте, що конкретна модель доступна у вашому регіоні.
|
||||
|
||||
### Відмінності параметрів
|
||||
|
||||
Azure OpenAI і публічний OpenAI не завжди приймають однакові параметри зображень.
|
||||
Azure може відхиляти опції, які дозволяє публічний OpenAI (наприклад певні
|
||||
значення `background` у `gpt-image-2`) або надавати їх лише для певних версій
|
||||
моделей. Ці відмінності походять від Azure і базової моделі, а не від
|
||||
OpenClaw. Якщо запит до Azure завершується помилкою валідації, перевірте
|
||||
Azure може відхиляти параметри, які дозволяє публічний OpenAI (наприклад, певні
|
||||
значення `background` у `gpt-image-2`) або надавати їх лише в конкретних
|
||||
версіях моделей. Ці відмінності походять від Azure і базової моделі, а не від
|
||||
OpenClaw. Якщо запит Azure завершується помилкою валідації, перевірте
|
||||
набір параметрів, який підтримується вашим конкретним deployment і версією API в
|
||||
порталі Azure.
|
||||
|
||||
<Note>
|
||||
Azure OpenAI використовує нативний транспорт і поведінку сумісності, але не отримує
|
||||
прихованих заголовків attribution від OpenClaw — див. accordion **Нативні vs OpenAI-compatible
|
||||
маршрути** в розділі [Розширена конфігурація](#advanced-configuration).
|
||||
Azure OpenAI використовує нативну транспортну та сумісну поведінку, але не отримує
|
||||
приховані заголовки атрибуції OpenClaw — див. акордеон **Нативні та OpenAI-сумісні
|
||||
маршрути** у розділі [Розширена конфігурація](#advanced-configuration).
|
||||
|
||||
Для трафіку chat або Responses в Azure (крім генерації зображень) використовуйте
|
||||
потік onboarding або окрему конфігурацію провайдера Azure — одного лише
|
||||
`openai.baseUrl` недостатньо, щоб застосувати формат API/автентифікації Azure. Існує окремий
|
||||
Для трафіку chat або Responses на Azure (поза генерацією зображень) використовуйте
|
||||
потік онбордингу або окрему конфігурацію провайдера Azure — одного лише `openai.baseUrl`
|
||||
недостатньо, щоб підхопити форму API/автентифікації Azure. Існує окремий
|
||||
провайдер `azure-openai-responses/*`; див.
|
||||
accordion про server-side Compaction нижче.
|
||||
акордеон Server-side compaction нижче.
|
||||
</Note>
|
||||
|
||||
## Розширена конфігурація
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Транспорт (WebSocket vs SSE)">
|
||||
OpenClaw використовує WebSocket-first із резервним переходом на SSE (`"auto"`) для `openai/*` і `openai-codex/*`.
|
||||
<Accordion title="Транспорт (WebSocket чи SSE)">
|
||||
OpenClaw використовує спочатку WebSocket із fallback на SSE (`"auto"`) і для `openai/*`, і для `openai-codex/*`.
|
||||
|
||||
У режимі `"auto"` OpenClaw:
|
||||
- Повторює одну ранню помилку WebSocket перед переходом на SSE
|
||||
- Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час періоду охолодження
|
||||
- Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час охолодження
|
||||
- Додає стабільні заголовки ідентичності сесії та ходу для повторів і перепідключень
|
||||
- Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) між варіантами транспорту
|
||||
|
||||
| Значення | Поведінка |
|
||||
|-------|----------|
|
||||
| `"auto"` (стандартно) | Спочатку WebSocket, резервно SSE |
|
||||
| `"auto"` (стандартно) | Спочатку WebSocket, fallback на SSE |
|
||||
| `"sse"` | Примусово лише SSE |
|
||||
| `"websocket"` | Примусово лише WebSocket |
|
||||
|
||||
@ -617,17 +635,17 @@ accordion про server-side Compaction нижче.
|
||||
}
|
||||
```
|
||||
|
||||
Повʼязані docs OpenAI:
|
||||
Пов’язана документація OpenAI:
|
||||
- [Realtime API with WebSocket](https://platform.openai.com/docs/guides/realtime-websocket)
|
||||
- [Streaming API responses (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Прогрів WebSocket">
|
||||
OpenClaw за замовчуванням вмикає прогрів WebSocket для `openai/*` і `openai-codex/*`, щоб зменшити затримку першого ходу.
|
||||
<Accordion title="Прогрівання WebSocket">
|
||||
OpenClaw за замовчуванням вмикає прогрівання WebSocket для `openai/*` і `openai-codex/*`, щоб зменшити затримку першого ходу.
|
||||
|
||||
```json5
|
||||
// Disable warm-up
|
||||
// Вимкнути прогрівання
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
@ -643,13 +661,13 @@ accordion про server-side Compaction нижче.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Fast mode">
|
||||
OpenClaw надає спільний перемикач fast mode для `openai/*` і `openai-codex/*`:
|
||||
<Accordion title="Швидкий режим">
|
||||
OpenClaw надає спільний перемикач швидкого режиму для `openai/*` і `openai-codex/*`:
|
||||
|
||||
- **Chat/UI:** `/fast status|on|off`
|
||||
- **Config:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
- **Конфігурація:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
|
||||
Коли він увімкнений, OpenClaw зіставляє fast mode з пріоритетною обробкою OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, а fast mode не переписує `reasoning` або `text.verbosity`.
|
||||
Коли його ввімкнено, OpenClaw зіставляє швидкий режим із пріоритетною обробкою OpenAI (`service_tier = "priority"`). Наявні значення `service_tier` зберігаються, а швидкий режим не переписує `reasoning` або `text.verbosity`.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -664,13 +682,13 @@ accordion про server-side Compaction нижче.
|
||||
```
|
||||
|
||||
<Note>
|
||||
Перевизначення сесії мають пріоритет над конфігурацією. Очищення перевизначення сесії в UI Sessions повертає сесію до стандартного налаштування з конфігурації.
|
||||
Перевизначення сесії мають пріоритет над конфігурацією. Очищення перевизначення сесії в UI Sessions повертає сесію до стандартного налаштованого значення.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Пріоритетна обробка (service_tier)">
|
||||
API OpenAI надає пріоритетну обробку через `service_tier`. Задавайте її для кожної моделі в OpenClaw:
|
||||
API OpenAI надає пріоритетну обробку через `service_tier`. Установлюйте її для кожної моделі в OpenClaw:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -687,23 +705,23 @@ accordion про server-side Compaction нижче.
|
||||
Підтримувані значення: `auto`, `default`, `flex`, `priority`.
|
||||
|
||||
<Warning>
|
||||
`serviceTier` передається лише до нативних endpoint OpenAI (`api.openai.com`) і нативних endpoint Codex (`chatgpt.com/backend-api`). Якщо ви маршрутизуєте будь-якого з цих провайдерів через проксі, OpenClaw залишає `service_tier` без змін.
|
||||
`serviceTier` передається лише до нативних endpoint-ів OpenAI (`api.openai.com`) і нативних endpoint-ів Codex (`chatgpt.com/backend-api`). Якщо ви маршрутизуєте будь-якого з цих провайдерів через проксі, OpenClaw залишає `service_tier` без змін.
|
||||
</Warning>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Server-side Compaction (Responses API)">
|
||||
Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) stream wrapper Pi-harness плагіна OpenAI автоматично вмикає server-side Compaction:
|
||||
<Accordion title="Server-side compaction (Responses API)">
|
||||
Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) обгортка потоку Pi-harness плагіна OpenAI автоматично вмикає Server-side compaction:
|
||||
|
||||
- Примусово встановлює `store: true` (якщо compat моделі не задає `supportsStore: false`)
|
||||
- Вставляє `context_management: [{ type: "compaction", compact_threshold: ... }]`
|
||||
- Стандартний `compact_threshold`: 70% від `contextWindow` (або `80000`, якщо він недоступний)
|
||||
- Примусово встановлює `store: true` (якщо лише сумісність моделі не задає `supportsStore: false`)
|
||||
- Впроваджує `context_management: [{ type: "compaction", compact_threshold: ... }]`
|
||||
- Стандартний `compact_threshold`: 70% від `contextWindow` (або `80000`, коли він недоступний)
|
||||
|
||||
Це застосовується до вбудованого шляху harness Pi і до хуків провайдера OpenAI, які використовуються в embedded-запусках. Нативний harness app-server Codex керує власним контекстом через Codex і налаштовується окремо через `agents.defaults.embeddedHarness.runtime`.
|
||||
Це застосовується до вбудованого шляху Pi harness і до хуків провайдера OpenAI, які використовуються в embedded-запусках. Нативний каркас app-server Codex керує власним контекстом через Codex і налаштовується окремо через `agents.defaults.embeddedHarness.runtime`.
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Явно ввімкнути">
|
||||
Корисно для сумісних endpoint, таких як Azure OpenAI Responses:
|
||||
Корисно для сумісних endpoint-ів, таких як Azure OpenAI Responses:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -719,7 +737,7 @@ accordion про server-side Compaction нижче.
|
||||
}
|
||||
```
|
||||
</Tab>
|
||||
<Tab title="Власний поріг">
|
||||
<Tab title="Користувацький поріг">
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
@ -755,7 +773,7 @@ accordion про server-side Compaction нижче.
|
||||
</Tabs>
|
||||
|
||||
<Note>
|
||||
`responsesServerCompaction` керує лише вставкою `context_management`. Прямі моделі OpenAI Responses усе одно примусово встановлюють `store: true`, якщо compat не задає `supportsStore: false`.
|
||||
`responsesServerCompaction` керує лише впровадженням `context_management`. Прямі моделі OpenAI Responses усе одно примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
@ -773,44 +791,44 @@ accordion про server-side Compaction нижче.
|
||||
}
|
||||
```
|
||||
|
||||
Із `strict-agentic` OpenClaw:
|
||||
З `strict-agentic` OpenClaw:
|
||||
- Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента
|
||||
- Повторює хід зі спрямуванням діяти негайно
|
||||
- Повторює хід із настановою діяти зараз
|
||||
- Автоматично вмикає `update_plan` для суттєвої роботи
|
||||
- Показує явний заблокований стан, якщо модель продовжує планувати без дії
|
||||
|
||||
<Note>
|
||||
Застосовується лише до OpenAI і Codex запусків сімейства GPT-5. Інші провайдери та старіші сімейства моделей зберігають стандартну поведінку.
|
||||
Поширюється лише на запуски сімейства GPT-5 OpenAI і Codex. Інші провайдери та старіші сімейства моделей зберігають стандартну поведінку.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Нативні vs OpenAI-compatible маршрути">
|
||||
OpenClaw по-різному обробляє прямі endpoint OpenAI, Codex і Azure OpenAI порівняно з загальними OpenAI-compatible проксі `/v1`:
|
||||
<Accordion title="Нативні та OpenAI-сумісні маршрути">
|
||||
OpenClaw по-різному обробляє прямі endpoints OpenAI, Codex і Azure OpenAI та загальні OpenAI-сумісні проксі `/v1`:
|
||||
|
||||
**Нативні маршрути** (`openai/*`, Azure OpenAI):
|
||||
- Зберігають `reasoning: { effort: "none" }` лише для моделей, які підтримують `none` effort у OpenAI
|
||||
- Зберігають `reasoning: { effort: "none" }` лише для моделей, які підтримують OpenAI `none` effort
|
||||
- Пропускають вимкнений reasoning для моделей або проксі, які відхиляють `reasoning.effort: "none"`
|
||||
- За замовчуванням використовують strict mode для схем інструментів
|
||||
- Додають приховані заголовки attribution лише на перевірених нативних хостах
|
||||
- Зберігають формування запитів, властиве лише OpenAI (`service_tier`, `store`, compat reasoning, підказки кешу prompt)
|
||||
- За замовчуванням встановлюють строгий режим для схем інструментів
|
||||
- Додають приховані заголовки атрибуції лише на перевірених нативних хостах
|
||||
- Зберігають форму запитів, специфічну для OpenAI (`service_tier`, `store`, сумісність reasoning, підказки кешу промптів)
|
||||
|
||||
**Проксі/сумісні маршрути:**
|
||||
- Використовують мʼякшу поведінку compat
|
||||
- Видаляють Completions `store` із ненативних payload `openai-completions`
|
||||
- Приймають наскрізний JSON `params.extra_body`/`params.extraBody` для розширених параметрів OpenAI-compatible проксі Completions
|
||||
- Не примушують strict-схеми інструментів або нативні заголовки
|
||||
- Використовують м’якшу сумісну поведінку
|
||||
- Видаляють Completions `store` з ненативних payload `openai-completions`
|
||||
- Приймають розширену наскрізну JSON-передачу `params.extra_body`/`params.extraBody` для OpenAI-сумісних проксі Completions
|
||||
- Не примушують до строгих схем інструментів або заголовків лише для нативних маршрутів
|
||||
|
||||
Azure OpenAI використовує нативний транспорт і поведінку compat, але не отримує прихованих заголовків attribution.
|
||||
Azure OpenAI використовує нативну транспортну та сумісну поведінку, але не отримує приховані заголовки атрибуції.
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Повʼязане
|
||||
## Пов’язане
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Вибір провайдерів, посилань моделей і поведінки failover.
|
||||
Вибір провайдерів, посилань на моделі та поведінки failover.
|
||||
</Card>
|
||||
<Card title="Генерація зображень" href="/uk/tools/image-generation" icon="image">
|
||||
Спільні параметри інструмента зображень і вибір провайдера.
|
||||
@ -819,6 +837,6 @@ accordion про server-side Compaction нижче.
|
||||
Спільні параметри інструмента відео і вибір провайдера.
|
||||
</Card>
|
||||
<Card title="OAuth і автентифікація" href="/uk/gateway/authentication" icon="key">
|
||||
Деталі автентифікації та правила повторного використання облікових даних.
|
||||
Докладно про автентифікацію та правила повторного використання облікових даних.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
@ -1,29 +1,29 @@
|
||||
---
|
||||
read_when:
|
||||
- Генерування зображень через агента
|
||||
- Налаштування провайдерів і моделей для генерування зображень
|
||||
- Генерація зображень через агента
|
||||
- Налаштування провайдерів і моделей для генерації зображень
|
||||
- Розуміння параметрів інструмента `image_generate`
|
||||
summary: Генеруйте та редагуйте зображення за допомогою налаштованих провайдерів (OpenAI, OpenAI Codex OAuth, Google Gemini, OpenRouter, LiteLLM, fal, MiniMax, ComfyUI, Vydra, xAI)
|
||||
title: Генерація зображень
|
||||
x-i18n:
|
||||
generated_at: "2026-04-25T18:14:47Z"
|
||||
generated_at: "2026-04-25T18:33:42Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 40ec0e9a004e769b3db8b98b1a687097cb4bc6aa78dc903e4f6a17c3731156c0
|
||||
source_hash: 787624476525ff5b8ed7d62a7cb0bac473cc9671136daf10f41d668ef2ddf3c5
|
||||
source_path: tools/image-generation.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
Інструмент `image_generate` дає агенту змогу створювати та редагувати зображення за допомогою налаштованих провайдерів. Згенеровані зображення автоматично доставляються як медіавкладення у відповіді агента.
|
||||
Інструмент `image_generate` дає агенту змогу створювати та редагувати зображення за допомогою ваших налаштованих провайдерів. Згенеровані зображення автоматично доставляються як медіавкладення у відповіді агента.
|
||||
|
||||
<Note>
|
||||
Інструмент з’являється лише тоді, коли доступний щонайменше один провайдер генерування зображень. Якщо ви не бачите `image_generate` у списку інструментів вашого агента, налаштуйте `agents.defaults.imageGenerationModel`, задайте API-ключ провайдера або увійдіть через OpenAI Codex OAuth.
|
||||
Інструмент з’являється лише тоді, коли доступний щонайменше один провайдер генерації зображень. Якщо ви не бачите `image_generate` серед інструментів вашого агента, налаштуйте `agents.defaults.imageGenerationModel`, укажіть API-ключ провайдера або увійдіть через OpenAI Codex OAuth.
|
||||
</Note>
|
||||
|
||||
## Швидкий старт
|
||||
|
||||
1. Установіть API-ключ щонайменше для одного провайдера (наприклад, `OPENAI_API_KEY`, `GEMINI_API_KEY` або `OPENROUTER_API_KEY`) або увійдіть через OpenAI Codex OAuth.
|
||||
2. За бажанням задайте бажану модель:
|
||||
1. Установіть API-ключ принаймні для одного провайдера (наприклад, `OPENAI_API_KEY`, `GEMINI_API_KEY` або `OPENROUTER_API_KEY`) або увійдіть через OpenAI Codex OAuth.
|
||||
2. За бажанням установіть бажану модель:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -31,7 +31,7 @@ x-i18n:
|
||||
defaults: {
|
||||
imageGenerationModel: {
|
||||
primary: "openai/gpt-image-2",
|
||||
// Необов’язковий типовий тайм-аут запиту провайдера для image_generate.
|
||||
// Необов’язковий типовий тайм-аут запиту до провайдера для image_generate.
|
||||
timeoutMs: 180_000,
|
||||
},
|
||||
},
|
||||
@ -39,51 +39,40 @@ 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`. Жодного allow-list для інструментів не потрібно — він увімкнений типово, коли провайдер доступний.
|
||||
Агент автоматично викликає `image_generate`. Жодного списку дозволених інструментів не потрібно — він увімкнений за замовчуванням, коли доступний провайдер.
|
||||
|
||||
## Поширені маршрути
|
||||
|
||||
| Ціль | Посилання на модель | Автентифікація |
|
||||
| ---------------------------------------------------- | -------------------------------------------------- | ----------------------------------- |
|
||||
| Генерування зображень OpenAI з оплатою через API | `openai/gpt-image-2` | `OPENAI_API_KEY` |
|
||||
| Генерування зображень OpenAI з автентифікацією через підписку Codex | `openai/gpt-image-2` | OpenAI Codex OAuth |
|
||||
| Генерування зображень OpenRouter | `openrouter/google/gemini-3.1-flash-image-preview` | `OPENROUTER_API_KEY` |
|
||||
| Генерування зображень LiteLLM | `litellm/gpt-image-2` | `LITELLM_API_KEY` |
|
||||
| Генерування зображень Google Gemini | `google/gemini-3.1-flash-image-preview` | `GEMINI_API_KEY` or `GOOGLE_API_KEY` |
|
||||
| Ціль | Посилання на модель | Автентифікація |
|
||||
| ---------------------------------------------------- | ------------------------------------------------- | ------------------------------------- |
|
||||
| Генерація зображень OpenAI з оплатою через API | `openai/gpt-image-2` | `OPENAI_API_KEY` |
|
||||
| Генерація зображень OpenAI з автентифікацією за підпискою Codex | `openai/gpt-image-2` | OpenAI Codex OAuth |
|
||||
| OpenAI PNG/WebP із прозорим тлом | `openai/gpt-image-1.5` | `OPENAI_API_KEY` або OpenAI Codex OAuth |
|
||||
| Генерація зображень OpenRouter | `openrouter/google/gemini-3.1-flash-image-preview` | `OPENROUTER_API_KEY` |
|
||||
| Генерація зображень LiteLLM | `litellm/gpt-image-2` | `LITELLM_API_KEY` |
|
||||
| Генерація зображень Google Gemini | `google/gemini-3.1-flash-image-preview` | `GEMINI_API_KEY` або `GOOGLE_API_KEY` |
|
||||
|
||||
Той самий інструмент `image_generate` обробляє як генерацію з тексту в зображення, так і
|
||||
редагування за еталонним зображенням. Використовуйте `image` для одного еталона або `images` для
|
||||
кількох еталонів. Підказки щодо виходу, які підтримуються провайдером, такі як `quality`, `outputFormat` і
|
||||
специфічний для OpenAI `background`, передаються далі, коли це можливо, і позначаються як
|
||||
проігноровані, якщо провайдер їх не підтримує.
|
||||
Той самий інструмент `image_generate` обробляє як генерацію з тексту в зображення, так і редагування за еталонним зображенням. Використовуйте `image` для одного еталона або `images` для кількох еталонів. Підказки щодо виводу, які підтримує провайдер, як-от `quality`, `outputFormat` і специфічний для OpenAI параметр `background`, передаються далі, коли це можливо, а якщо провайдер їх не підтримує — позначаються як проігноровані.
|
||||
|
||||
## Підтримувані провайдери
|
||||
|
||||
| Провайдер | Типова модель | Підтримка редагування | Автентифікація |
|
||||
| ---------- | -------------------------------------- | ----------------------------------- | ----------------------------------------------------- |
|
||||
| OpenAI | `gpt-image-2` | Так (до 4 зображень) | `OPENAI_API_KEY` або OpenAI Codex OAuth |
|
||||
| OpenRouter | `google/gemini-3.1-flash-image-preview`| Так (до 5 вхідних зображень) | `OPENROUTER_API_KEY` |
|
||||
| LiteLLM | `gpt-image-2` | Так (до 5 вхідних зображень) | `LITELLM_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` |
|
||||
| Провайдер | Типова модель | Підтримка редагування | Автентифікація |
|
||||
| --------- | -------------------------------------- | ----------------------------------- | ----------------------------------------------------- |
|
||||
| OpenAI | `gpt-image-2` | Так (до 4 зображень) | `OPENAI_API_KEY` або OpenAI Codex OAuth |
|
||||
| OpenRouter | `google/gemini-3.1-flash-image-preview` | Так (до 5 вхідних зображень) | `OPENROUTER_API_KEY` |
|
||||
| LiteLLM | `gpt-image-2` | Так (до 5 вхідних зображень) | `LITELLM_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
|
||||
@ -92,19 +81,19 @@ Codex OAuth використовує те саме посилання на мо
|
||||
## Параметри інструмента
|
||||
|
||||
<ParamField path="prompt" type="string" required>
|
||||
Промпт для генерування зображення. Обов’язковий для `action: "generate"`.
|
||||
Підказка для генерації зображення. Обов’язкова для `action: "generate"`.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="action" type="'generate' | 'list'" default="generate">
|
||||
Використовуйте `"list"`, щоб переглянути доступні провайдери й моделі під час виконання.
|
||||
Використовуйте `"list"`, щоб переглянути доступні провайдери та моделі під час виконання.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="model" type="string">
|
||||
Перевизначення провайдера/моделі, наприклад `openai/gpt-image-2`.
|
||||
Перевизначення провайдера/моделі, наприклад `openai/gpt-image-2`; використовуйте `openai/gpt-image-1.5` для прозорого тла OpenAI.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="image" type="string">
|
||||
Шлях або URL одного еталонного зображення для режиму редагування.
|
||||
Шлях до одного еталонного зображення або URL для режиму редагування.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="images" type="string[]">
|
||||
@ -112,7 +101,7 @@ Codex OAuth використовує те саме посилання на мо
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="size" type="string">
|
||||
Підказка розміру: `1024x1024`, `1536x1024`, `1024x1536`, `2048x2048`, `3840x2160`.
|
||||
Підказка щодо розміру: `1024x1024`, `1536x1024`, `1024x1536`, `2048x2048`, `3840x2160`.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="aspectRatio" type="string">
|
||||
@ -120,36 +109,36 @@ Codex OAuth використовує те саме посилання на мо
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="resolution" type="'1K' | '2K' | '4K'">
|
||||
Підказка роздільної здатності.
|
||||
Підказка щодо роздільної здатності.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="quality" type="'low' | 'medium' | 'high' | 'auto'">
|
||||
Підказка якості, якщо провайдер її підтримує.
|
||||
Підказка щодо якості, якщо провайдер її підтримує.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="outputFormat" type="'png' | 'jpeg' | 'webp'">
|
||||
Підказка формату виходу, якщо провайдер її підтримує.
|
||||
Підказка щодо формату виводу, якщо провайдер її підтримує.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="count" type="number">
|
||||
Кількість зображень для генерування (1–4).
|
||||
Кількість зображень для генерації (1–4).
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="timeoutMs" type="number">
|
||||
Необов’язковий тайм-аут запиту провайдера в мілісекундах.
|
||||
Необов’язковий тайм-аут запиту до провайдера в мілісекундах.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="filename" type="string">
|
||||
Підказка імені вихідного файлу.
|
||||
Підказка щодо імені вихідного файла.
|
||||
</ParamField>
|
||||
|
||||
<ParamField path="openai" type="object">
|
||||
Підказки лише для OpenAI: `background`, `moderation`, `outputCompression` і `user`.
|
||||
</ParamField>
|
||||
|
||||
Не всі провайдери підтримують усі параметри. Коли резервний провайдер підтримує близький варіант геометрії замість точно запитаного, OpenClaw перед відправленням переналаштовує запит до найближчого підтримуваного розміру, співвідношення сторін або роздільної здатності. Непідтримувані підказки виходу, такі як `quality` або `outputFormat`, відкидаються для провайдерів, які не заявляють такої підтримки, і зазначаються в результаті інструмента.
|
||||
Не всі провайдери підтримують усі параметри. Коли резервний провайдер підтримує близький варіант геометрії замість точно запитаного, OpenClaw перед відправленням зіставляє його з найближчим підтримуваним `size`, `aspectRatio` або `resolution`. Непідтримувані підказки виводу, як-от `quality` або `outputFormat`, відкидаються для провайдерів, які не декларують їх підтримку, і відображаються в результаті інструмента.
|
||||
|
||||
Результати інструмента показують застосовані налаштування. Коли OpenClaw переналаштовує геометрію під час резервного переходу між провайдерами, повернуті значення `size`, `aspectRatio` і `resolution` відображають те, що було фактично надіслано, а `details.normalization` фіксує перетворення від запитаного до застосованого.
|
||||
Результати інструмента показують застосовані налаштування. Коли OpenClaw змінює геометрію під час резервного переходу між провайдерами, повернуті значення `size`, `aspectRatio` і `resolution` відображають те, що було фактично надіслано, а `details.normalization` фіксує перетворення від запитаного до застосованого.
|
||||
|
||||
## Конфігурація
|
||||
|
||||
@ -175,35 +164,29 @@ Codex OAuth використовує те саме посилання на мо
|
||||
|
||||
### Порядок вибору провайдера
|
||||
|
||||
Під час генерування зображення OpenClaw пробує провайдерів у такому порядку:
|
||||
Під час генерації зображення OpenClaw пробує провайдерів у такому порядку:
|
||||
|
||||
1. **Параметр `model`** з виклику інструмента (якщо агент його вказує)
|
||||
2. **`imageGenerationModel.primary`** з конфігурації
|
||||
3. **`imageGenerationModel.fallbacks`** у заданому порядку
|
||||
4. **Автовизначення** — використовує лише типові значення провайдерів, підкріплені автентифікацією:
|
||||
- спочатку поточний типовий провайдер
|
||||
- потім решта зареєстрованих провайдерів генерування зображень у порядку provider-id
|
||||
- далі решта зареєстрованих провайдерів генерації зображень у порядку `provider-id`
|
||||
|
||||
Якщо провайдер не спрацьовує (помилка автентифікації, обмеження швидкості тощо), автоматично пробується наступний налаштований кандидат. Якщо не спрацьовують усі, помилка містить деталі кожної спроби.
|
||||
Якщо провайдер завершується помилкою (помилка автентифікації, обмеження швидкості тощо), автоматично пробується наступний налаштований кандидат. Якщо всі завершаться помилкою, помилка міститиме подробиці кожної спроби.
|
||||
|
||||
Примітки:
|
||||
|
||||
- Перевизначення `model` для окремого виклику є точним: OpenClaw пробує лише цю пару провайдер/модель
|
||||
і не переходить далі до налаштованих primary/fallback або автовизначених
|
||||
провайдерів.
|
||||
- Автовизначення враховує автентифікацію. Типове значення провайдера потрапляє до списку кандидатів
|
||||
лише тоді, коли OpenClaw справді може автентифікувати цей провайдер.
|
||||
- Автовизначення типово ввімкнене. Установіть
|
||||
`agents.defaults.mediaGenerationAutoProviderFallback: false`, якщо хочете, щоб генерація зображень
|
||||
використовувала лише явні записи `model`, `primary` і `fallbacks`.
|
||||
- Перевизначення `model` для окремого виклику є точним: OpenClaw пробує лише цього провайдера/цю модель і не переходить далі до налаштованого primary/fallback або автовизначених провайдерів.
|
||||
- Автовизначення враховує автентифікацію. Типовий провайдер потрапляє до списку кандидатів лише тоді, коли OpenClaw справді може автентифікуватися в цього провайдера.
|
||||
- Автовизначення ввімкнено за замовчуванням. Установіть `agents.defaults.mediaGenerationAutoProviderFallback: false`, якщо хочете, щоб генерація зображень використовувала лише явні записи `model`, `primary` і `fallbacks`.
|
||||
- Установіть `agents.defaults.imageGenerationModel.timeoutMs` для повільних бекендів зображень.
|
||||
Параметр інструмента `timeoutMs` для окремого виклику перевизначає налаштоване типове значення.
|
||||
- Використовуйте `action: "list"`, щоб переглянути наразі зареєстрованих провайдерів, їхні
|
||||
типові моделі та підказки щодо env var для автентифікації.
|
||||
Параметр інструмента `timeoutMs` для окремого виклику перевизначає налаштоване значення за замовчуванням.
|
||||
- Використовуйте `action: "list"`, щоб переглянути поточно зареєстрованих провайдерів, їхні типові моделі та підказки щодо env-змінних для автентифікації.
|
||||
|
||||
### Редагування зображень
|
||||
|
||||
OpenAI, OpenRouter, Google, fal, MiniMax, ComfyUI і xAI підтримують редагування еталонних зображень. Передайте шлях або URL еталонного зображення:
|
||||
OpenAI, OpenRouter, Google, fal, MiniMax, ComfyUI і xAI підтримують редагування еталонних зображень. Передайте шлях до еталонного зображення або URL:
|
||||
|
||||
```
|
||||
"Згенеруй акварельну версію цього фото" + image: "/path/to/photo.jpg"
|
||||
@ -213,7 +196,7 @@ OpenAI, OpenRouter, Google і xAI підтримують до 5 еталонни
|
||||
|
||||
### Моделі зображень OpenRouter
|
||||
|
||||
Генерування зображень OpenRouter використовує той самий `OPENROUTER_API_KEY` і маршрутизується через image API chat completions OpenRouter. Вибирайте моделі зображень OpenRouter з префіксом `openrouter/`:
|
||||
Генерація зображень OpenRouter використовує той самий `OPENROUTER_API_KEY` і маршрутизується через image API chat completions OpenRouter. Вибирайте моделі зображень OpenRouter з префіксом `openrouter/`:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -231,26 +214,11 @@ OpenClaw передає до OpenRouter `prompt`, `count`, еталонні зо
|
||||
|
||||
### OpenAI `gpt-image-2`
|
||||
|
||||
Генерування зображень OpenAI типово використовує `openai/gpt-image-2`. Якщо
|
||||
налаштовано OAuth-профіль `openai-codex`, OpenClaw повторно використовує той самий OAuth-профіль,
|
||||
що й для чат-моделей за підпискою Codex, і надсилає запит на зображення
|
||||
через бекенд Codex Responses. Застарілі base URL Codex, такі як
|
||||
`https://chatgpt.com/backend-api`, канонікалізуються до
|
||||
`https://chatgpt.com/backend-api/codex` для запитів на зображення. Для такого запиту він не
|
||||
переходить мовчки до `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. Застарілі базові URL Codex, як-от `https://chatgpt.com/backend-api`, канонізуються до `https://chatgpt.com/backend-api/codex` для запитів на зображення. Для такого запиту немає безшумного резервного переходу на `OPENAI_API_KEY`. Щоб примусово використовувати пряме маршрутизування через OpenAI Images API, явно налаштуйте `models.providers.openai` з API-ключем, власним base URL або ендпойнтом Azure. Моделі `openai/gpt-image-1.5`, `openai/gpt-image-1` і `openai/gpt-image-1-mini` усе ще можна явно вибрати. Використовуйте `gpt-image-1.5` для виводу PNG/WebP із прозорим тлом; поточний API `gpt-image-2` відхиляє `background: "transparent"`.
|
||||
|
||||
`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
|
||||
{
|
||||
@ -265,78 +233,92 @@ OpenClaw відображає їх у підтримуваний `size`, іна
|
||||
}
|
||||
```
|
||||
|
||||
`openai.background` приймає значення `transparent`, `opaque` або `auto`; прозорі
|
||||
вихідні дані потребують `outputFormat` `png` або `webp`. `openai.outputCompression`
|
||||
застосовується до виходів JPEG/WebP.
|
||||
`openai.background` приймає значення `transparent`, `opaque` або `auto`; для прозорого виводу потрібні `outputFormat` `png` або `webp` і модель зображень OpenAI з підтримкою прозорості. OpenClaw спрямовує запити на прозоре тло для типового `gpt-image-2` до `gpt-image-1.5`. `openai.outputCompression` застосовується до виводу JPEG/WebP.
|
||||
|
||||
Коли ви просите агента створити зображення OpenAI з прозорим тлом, очікуваний виклик інструмента має такий вигляд:
|
||||
|
||||
```json
|
||||
{
|
||||
"model": "openai/gpt-image-1.5",
|
||||
"prompt": "Проста червона кругла наліпка на прозорому тлі",
|
||||
"outputFormat": "png",
|
||||
"openai": {
|
||||
"background": "transparent"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Явна модель `openai/gpt-image-1.5` зберігає переносимість запиту між зведеннями інструментів і harnesses. Якщо агент натомість використовує типовий `openai/gpt-image-2` з `openai.background: "transparent"` у публічному маршруті OpenAI або OpenAI Codex OAuth, OpenClaw переписує запит до провайдера на `gpt-image-1.5`. Azure та користувацькі OpenAI-сумісні ендпойнти зберігають свої налаштовані назви deployment/model.
|
||||
|
||||
Згенерувати одне ландшафтне зображення 4K:
|
||||
|
||||
```
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="A clean editorial poster for OpenClaw image generation" size=3840x2160 count=1
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Чистий редакційний постер для генерації зображень OpenClaw" size=3840x2160 count=1
|
||||
```
|
||||
|
||||
Згенерувати прозорий PNG:
|
||||
|
||||
```
|
||||
/tool image_generate action=generate model=openai/gpt-image-1.5 prompt="Проста червона кругла наліпка на прозорому тлі" outputFormat=png openai='{"background":"transparent"}'
|
||||
```
|
||||
|
||||
Згенерувати два квадратні зображення:
|
||||
|
||||
```
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Two visual directions for a calm productivity app icon" size=1024x1024 count=2
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Два візуальні напрями для іконки спокійного застосунку продуктивності" size=1024x1024 count=2
|
||||
```
|
||||
|
||||
Відредагувати одне локальне еталонне зображення:
|
||||
|
||||
```
|
||||
/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="Зберегти об’єкт, замінити тло на яскраву студійну постановку" 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
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Поєднати ідентичність персонажа з першого зображення з палітрою кольорів із другого" 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 через deployment Azure OpenAI замість `api.openai.com`, див. [ендпойнти Azure OpenAI](/uk/providers/openai#azure-openai-endpoints) у документації провайдера OpenAI.
|
||||
|
||||
Генерування зображень MiniMax доступне через обидва вбудовані шляхи автентифікації MiniMax:
|
||||
Генерація зображень MiniMax доступна через обидва вбудовані шляхи автентифікації MiniMax:
|
||||
|
||||
- `minimax/image-01` для конфігурацій з API-ключем
|
||||
- `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 зображень) |
|
||||
| Керування розміром | Так (до 4K) | Так | Так | Ні | Ні | Ні | Ні |
|
||||
| Співвідношення сторін | Ні | Так | Так (лише генерування) | Так | Ні | Ні | Так |
|
||||
| Можливість | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra | xAI |
|
||||
| -------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ------- | -------------------- |
|
||||
| Генерація | Так (до 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` для запитів лише з prompt і `/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
|
||||
- Роздільні здатності: `1K`, `2K`
|
||||
- Вивід: повертається як вкладення зображень, керовані OpenClaw
|
||||
|
||||
OpenClaw навмисно не відкриває нативні для xAI `quality`, `mask`, `user` або
|
||||
додаткові співвідношення сторін, доступні лише нативно, доки ці елементи керування не з’являться у спільному
|
||||
міжпровайдерному контракті `image_generate`.
|
||||
OpenClaw навмисно не відкриває специфічні для xAI параметри `quality`, `mask`, `user` або додаткові власні співвідношення сторін, доки ці елементи керування не з’являться у спільному міжпровайдерному контракті `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) — налаштування зображень, відео, пошуку, виконання коду та TTS Grok
|
||||
- [Довідник із конфігурації](/uk/gateway/config-agents#agent-defaults) — конфігурація `imageGenerationModel`
|
||||
- [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання на резервні варіанти
|
||||
- [xAI](/uk/providers/xai) — налаштування Grok для зображень, відео, пошуку, виконання коду та TTS
|
||||
- [Довідник з конфігурації](/uk/gateway/config-agents#agent-defaults) — конфігурація `imageGenerationModel`
|
||||
- [Моделі](/uk/concepts/models) — конфігурація моделей і перемикання на резервний варіант
|
||||
|
||||
Loading…
Reference in New Issue
Block a user