diff --git a/docs/uk/providers/openai.md b/docs/uk/providers/openai.md index 1b70eb266..89571422b 100644 --- a/docs/uk/providers/openai.md +++ b/docs/uk/providers/openai.md @@ -2,14 +2,14 @@ read_when: - Ви хочете використовувати моделі OpenAI в OpenClaw - Ви хочете автентифікацію за підпискою Codex замість API-ключів - - Вам потрібна суворіша поведінка виконання агента GPT-5 + - Вам потрібні суворіші правила виконання агента GPT-5 summary: Використовуйте OpenAI через API-ключі або підписку Codex в OpenClaw title: OpenAI x-i18n: - generated_at: "2026-04-21T04:00:21Z" + generated_at: "2026-04-21T05:16:49Z" model: gpt-5.4 provider: openai - source_hash: e9ed926ed4d3cd7a0fd4e9e9859fcd81ab62134de625ccf0c66fc92c4273449f + source_hash: 172beb28b099e3d71998458408c9a6b32b03790d2b016351f724bc3f0d9d3245 source_path: providers/openai.md workflow: 15 --- @@ -18,22 +18,22 @@ x-i18n: OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два шляхи автентифікації: -- **API key** — прямий доступ до OpenAI Platform з оплатою за використання (`openai/*` models) -- **Codex subscription** — вхід через ChatGPT/Codex із доступом за підпискою (`openai-codex/*` models) +- **API-ключ** — прямий доступ до OpenAI Platform з оплатою за використання (`openai/*` моделі) +- **Підписка Codex** — вхід через ChatGPT/Codex з доступом за підпискою (`openai-codex/*` моделі) -OpenAI прямо підтримує використання OAuth-підписки у зовнішніх інструментах і робочих процесах, таких як OpenClaw. +OpenAI явно підтримує використання OAuth за підпискою у зовнішніх інструментах і робочих процесах, таких як OpenClaw. ## Початок роботи Виберіть бажаний спосіб автентифікації та виконайте кроки налаштування. - + **Найкраще підходить для:** прямого доступу до API та оплати за використання. - - Створіть або скопіюйте API key з [панелі керування OpenAI Platform](https://platform.openai.com/api-keys). + + Створіть або скопіюйте API-ключ у [панелі керування OpenAI Platform](https://platform.openai.com/api-keys). ```bash @@ -53,7 +53,7 @@ OpenAI прямо підтримує використання OAuth-підпис - ### Короткий опис маршруту + ### Підсумок маршрутів | Model ref | Маршрут | Автентифікація | |-----------|-------|------| @@ -61,7 +61,7 @@ OpenAI прямо підтримує використання OAuth-підпис | `openai/gpt-5.4-pro` | Прямий API OpenAI Platform | `OPENAI_API_KEY` | - Вхід через ChatGPT/Codex спрямовується через `openai-codex/*`, а не `openai/*`. + Вхід через ChatGPT/Codex маршрутизується через `openai-codex/*`, а не `openai/*`. ### Приклад конфігурації @@ -74,13 +74,13 @@ OpenAI прямо підтримує використання OAuth-підпис ``` - OpenClaw **не** надає `openai/gpt-5.3-codex-spark` у прямому шляху API. Живі запити до OpenAI API відхиляють цю модель. Spark доступний лише для Codex. + OpenClaw **не** надає `openai/gpt-5.3-codex-spark` через прямий шлях API. Живі запити до OpenAI API відхиляють цю модель. Spark доступний лише в Codex. - - **Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API key. Codex cloud потребує входу в ChatGPT. + + **Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API-ключа. Codex cloud потребує входу через ChatGPT. @@ -94,7 +94,7 @@ OpenAI прямо підтримує використання OAuth-підпис openclaw models auth login --provider openai-codex ``` - + ```bash openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4 ``` @@ -106,15 +106,15 @@ OpenAI прямо підтримує використання OAuth-підпис - ### Короткий опис маршруту + ### Підсумок маршрутів | Model ref | Маршрут | Автентифікація | |-----------|-------|------| - | `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | Вхід через Codex | - | `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Вхід через Codex (залежить від entitlement) | + | `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | вхід Codex | + | `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | вхід Codex (залежить від прав доступу) | - Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API key для прямого доступу до Platform, а `openai-codex/*` — для доступу за підпискою Codex. + Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API-ключем для прямого доступу до Platform, а `openai-codex/*` — для доступу за підпискою Codex. ### Приклад конфігурації @@ -126,7 +126,7 @@ OpenAI прямо підтримує використання OAuth-підпис ``` - Якщо онбординг повторно використовує наявний вхід Codex CLI, цими обліковими даними й надалі керує Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex. + Якщо онбординг повторно використовує наявний вхід Codex CLI, ці облікові дані залишаються під керуванням Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex. ### Обмеження вікна контексту @@ -135,10 +135,10 @@ OpenAI прямо підтримує використання OAuth-підпис Для `openai-codex/gpt-5.4`: - - Нативний `contextWindow`: `1050000` - - Обмеження `contextTokens` під час виконання за замовчуванням: `272000` + - Власний `contextWindow`: `1050000` + - Типове обмеження `contextTokens` під час виконання: `272000` - Менше обмеження за замовчуванням на практиці забезпечує кращі характеристики затримки та якості. Ви можете перевизначити його через `contextTokens`: + Менше типове обмеження на практиці має кращі характеристики затримки та якості. Перевизначте його за допомогою `contextTokens`: ```json5 { @@ -153,7 +153,7 @@ OpenAI прямо підтримує використання OAuth-підпис ``` - Використовуйте `contextWindow`, щоб оголосити нативні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту під час виконання. + Використовуйте `contextWindow`, щоб указати власні метадані моделі. Використовуйте `contextTokens`, щоб обмежити бюджет контексту під час виконання. @@ -182,7 +182,7 @@ OpenAI прямо підтримує використання OAuth-підпис ``` -Дивіться [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. +Див. [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку резервного перемикання. ## Генерація відео @@ -191,10 +191,10 @@ OpenAI прямо підтримує використання OAuth-підпис | Можливість | Значення | | ---------------- | --------------------------------------------------------------------------------- | -| Модель за замовчуванням | `openai/sora-2` | -| Режими | Text-to-video, image-to-video, редагування одного відео | -| Еталонні вхідні дані | 1 зображення або 1 відео | -| Перевизначення розміру | Підтримується | +| Модель за замовчуванням | `openai/sora-2` | +| Режими | Текст у відео, зображення у відео, редагування одного відео | +| Еталонні вхідні дані | 1 зображення або 1 відео | +| Перевизначення розміру | Підтримується | | Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням інструмента | ```json5 @@ -208,19 +208,19 @@ OpenAI прямо підтримує використання OAuth-підпис ``` -Дивіться [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. +Див. [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку резервного перемикання. -## Внесок підказки GPT-5 +## Внесок GPT-5 до промпта -OpenClaw додає специфічний для OpenAI внесок у підказку GPT-5 для запусків сімейства GPT-5 через `openai/*` і `openai-codex/*`. Він міститься у вбудованому Plugin OpenAI, застосовується до ідентифікаторів моделей, таких як `gpt-5`, `gpt-5.2`, `gpt-5.4` і `gpt-5.4-mini`, і не застосовується до старіших моделей GPT-4.x. +OpenClaw додає специфічний для OpenAI внесок GPT-5 до промпта для запусків сімейства GPT-5 у `openai/*` і `openai-codex/*`. Він знаходиться у вбудованому Plugin OpenAI, застосовується до ідентифікаторів моделей, таких як `gpt-5`, `gpt-5.2`, `gpt-5.4` і `gpt-5.4-mini`, і не застосовується до старіших моделей GPT-4.x. -Внесок GPT-5 додає тегований контракт поведінки для форми виводу, наполегливості інструментів, перевірок залежностей, паралельного пошуку, перевірок завершення, верифікації та автономності за замовчуванням. Ці настанови завжди ввімкнені для відповідних моделей GPT-5. Рівень дружнього стилю взаємодії є окремим і налаштовуваним. +Внесок GPT-5 додає тегований контракт поведінки для збереження персони, безпеки виконання, дисципліни використання інструментів, форми виводу, перевірок завершення та верифікації. Специфічна для каналу поведінка відповіді та тихих повідомлень залишається в спільному системному промпті OpenClaw і політиці вихідної доставки. Настанови GPT-5 завжди ввімкнені для відповідних моделей. Рівень дружнього стилю взаємодії є окремим і налаштовуваним. | Значення | Ефект | -| ---------------------- | ------------------------------------------- | +| --------------------- | ------------------------------------------ | | `"friendly"` (типово) | Увімкнути рівень дружнього стилю взаємодії | -| `"on"` | Псевдонім для `"friendly"` | +| `"on"` | Псевдонім для `"friendly"` | | `"off"` | Вимкнути лише рівень дружнього стилю | @@ -243,7 +243,7 @@ OpenClaw додає специфічний для OpenAI внесок у під -Під час виконання значення нечутливі до регістру, тому і `"Off"`, і `"off"` вимикають рівень дружнього стилю. +Під час виконання значення не чутливі до регістру, тому і `"Off"`, і `"off"` вимикають дружній стиль. ## Голос і мовлення @@ -252,14 +252,14 @@ OpenClaw додає специфічний для OpenAI внесок у під Вбудований Plugin `openai` реєструє синтез мовлення для поверхні `messages.tts`. - | Налаштування | Шлях конфігурації | Типово | + | Налаштування | Шлях конфігурації | Типове значення | |---------|------------|---------| | Модель | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` | | Голос | `messages.tts.providers.openai.voice` | `coral` | | Швидкість | `messages.tts.providers.openai.speed` | (не задано) | | Інструкції | `messages.tts.providers.openai.instructions` | (не задано, лише `gpt-4o-mini-tts`) | | Формат | `messages.tts.providers.openai.responseFormat` | `opus` для голосових нотаток, `mp3` для файлів | - | API key | `messages.tts.providers.openai.apiKey` | Резервно використовується `OPENAI_API_KEY` | + | API-ключ | `messages.tts.providers.openai.apiKey` | Використовує `OPENAI_API_KEY`, якщо не задано | | 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`. @@ -277,7 +277,7 @@ OpenClaw додає специфічний для OpenAI внесок у під ``` - Встановіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS, не впливаючи на кінцеву точку chat API. + Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL для TTS, не впливаючи на кінцеву точку chat API. @@ -285,12 +285,12 @@ OpenClaw додає специфічний для OpenAI внесок у під Вбудований Plugin `openai` реєструє транскрипцію в реальному часі для Plugin Voice Call. - | Налаштування | Шлях конфігурації | Типово | + | Налаштування | Шлях конфігурації | Типове значення | |---------|------------|---------| | Модель | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` | | Тривалість тиші | `...openai.silenceDurationMs` | `800` | | Поріг VAD | `...openai.vadThreshold` | `0.5` | - | API key | `...openai.apiKey` | Резервно використовується `OPENAI_API_KEY` | + | API-ключ | `...openai.apiKey` | Використовує `OPENAI_API_KEY`, якщо не задано | Використовує WebSocket-з’єднання з `wss://api.openai.com/v1/realtime` з аудіо G.711 u-law. @@ -301,17 +301,17 @@ OpenClaw додає специфічний для OpenAI внесок у під Вбудований Plugin `openai` реєструє голос у реальному часі для Plugin Voice Call. - | Налаштування | Шлях конфігурації | Типово | + | Налаштування | Шлях конфігурації | Типове значення | |---------|------------|---------| | Модель | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` | | Голос | `...openai.voice` | `alloy` | | Temperature | `...openai.temperature` | `0.8` | | Поріг VAD | `...openai.vadThreshold` | `0.5` | | Тривалість тиші | `...openai.silenceDurationMs` | `500` | - | API key | `...openai.apiKey` | Резервно використовується `OPENAI_API_KEY` | + | API-ключ | `...openai.apiKey` | Використовує `OPENAI_API_KEY`, якщо не задано | - Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонаправлений виклик інструментів. Використовує формат аудіо G.711 u-law. + Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двоспрямований виклик інструментів. Використовує аудіоформат G.711 u-law. @@ -324,9 +324,9 @@ OpenClaw додає специфічний для OpenAI внесок у під OpenClaw використовує WebSocket-first із резервним переходом на SSE (`"auto"`) як для `openai/*`, так і для `openai-codex/*`. У режимі `"auto"` OpenClaw: - - Повторює одну ранню невдачу WebSocket перед переходом на SSE - - Після збою позначає WebSocket як degraded приблизно на 60 секунд і використовує SSE під час охолодження - - Прикріплює стабільні заголовки ідентичності сеансу та ходу для повторів і перепідключень + - Повторює одну ранню помилку WebSocket перед переходом на SSE + - Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час охолодження + - Додає стабільні заголовки ідентичності сесії та ходу для повторів і перепідключень - Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) між варіантами транспорту | Значення | Поведінка | @@ -355,11 +355,11 @@ OpenClaw додає специфічний для OpenAI внесок у під - - OpenClaw за замовчуванням вмикає прогрівання WebSocket для `openai/*`, щоб зменшити затримку першого ходу. + + OpenClaw типово вмикає прогрів WebSocket для `openai/*`, щоб зменшити затримку першого ходу. ```json5 - // Вимкнути прогрівання + // Вимкнути прогрів { agents: { defaults: { @@ -376,7 +376,7 @@ OpenClaw додає специфічний для OpenAI внесок у під - OpenClaw надає спільний перемикач швидкого режиму для `openai/*` і `openai-codex/*`: + OpenClaw надає спільний перемикач швидкого режиму як для `openai/*`, так і для `openai-codex/*`: - **Chat/UI:** `/fast status|on|off` - **Конфігурація:** `agents.defaults.models["/"].params.fastMode` @@ -397,13 +397,13 @@ OpenClaw додає специфічний для OpenAI внесок у під ``` - Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в інтерфейсі Sessions повертає сеанс до налаштованого значення за замовчуванням. + Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в інтерфейсі Sessions повертає сеанс до налаштованого типового значення. - API OpenAI надає пріоритетну обробку через `service_tier`. Налаштуйте її для кожної моделі в OpenClaw: + API OpenAI надає пріоритетну обробку через `service_tier`. Установлюйте її для кожної моделі в OpenClaw: ```json5 { @@ -421,20 +421,20 @@ OpenClaw додає специфічний для OpenAI внесок у під Підтримувані значення: `auto`, `default`, `flex`, `priority`. - `serviceTier` передається лише до нативних кінцевих точок OpenAI (`api.openai.com`) і нативних кінцевих точок Codex (`chatgpt.com/backend-api`). Якщо ви спрямовуєте будь-якого з цих провайдерів через проксі, OpenClaw залишає `service_tier` без змін. + `serviceTier` передається лише до нативних кінцевих точок OpenAI (`api.openai.com`) і нативних кінцевих точок Codex (`chatgpt.com/backend-api`). Якщо ви маршрутизуєте будь-якого з цих провайдерів через проксі, OpenClaw залишає `service_tier` без змін. - Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає Server-side Compaction: + Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає server-side Compaction: - - Примусово встановлює `store: true` (якщо тільки сумісність моделі не задає `supportsStore: false`) + - Примусово встановлює `store: true` (якщо сумісність моделі не задає `supportsStore: false`) - Вставляє `context_management: [{ type: "compaction", compact_threshold: ... }]` - - Типовий `compact_threshold`: 70% від `contextWindow` (або `80000`, якщо воно недоступне) + - Типове значення `compact_threshold`: 70% від `contextWindow` (або `80000`, якщо недоступно) - + Корисно для сумісних кінцевих точок, таких як Azure OpenAI Responses: ```json5 @@ -487,13 +487,13 @@ OpenClaw додає специфічний для OpenAI внесок у під - `responsesServerCompaction` керує лише вставленням `context_management`. Прямі моделі OpenAI Responses усе одно примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`. + `responsesServerCompaction` керує лише вставленням `context_management`. Прямі моделі OpenAI Responses усе одно примусово використовують `store: true`, якщо сумісність не задає `supportsStore: false`. - Для запусків сімейства GPT-5 через `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання: + Для запусків сімейства GPT-5 у `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання: ```json5 { @@ -505,33 +505,33 @@ OpenClaw додає специфічний для OpenAI внесок у під } ``` - З `strict-agentic` OpenClaw: + Із `strict-agentic` OpenClaw: - Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента - - Повторює хід із настановою діяти негайно - - Автоматично вмикає `update_plan` для суттєвої роботи - - Показує явний стан блокування, якщо модель продовжує планувати без дії + - Повторює хід із вказівкою діяти негайно + - Автоматично вмикає `update_plan` для значної роботи + - Показує явний заблокований стан, якщо модель продовжує планувати без дії - Застосовується лише до запусків сімейства GPT-5 OpenAI і Codex. Для інших провайдерів і старіших сімейств моделей зберігається типова поведінка. + Поширюється лише на OpenAI і запуски сімейства GPT-5 у Codex. Інші провайдери та старіші сімейства моделей зберігають типову поведінку. - - OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними проксі `/v1`, сумісними з OpenAI: + + OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними OpenAI-compatible проксі `/v1`: **Нативні маршрути** (`openai/*`, `openai-codex/*`, Azure OpenAI): - - Зберігають `reasoning: { effort: "none" }` лише для моделей, які підтримують OpenAI effort `none` + - Зберігають `reasoning: { effort: "none" }` лише для моделей, що підтримують OpenAI `none` effort - Пропускають вимкнений reasoning для моделей або проксі, які відхиляють `reasoning.effort: "none"` - - Типово використовують строгий режим для схем інструментів + - Типово використовують суворий режим для схем інструментів - Додають приховані заголовки атрибуції лише на перевірених нативних хостах - - Зберігають формування запитів, властиве лише OpenAI (`service_tier`, `store`, сумісність reasoning, підказки кешу підказок) + - Зберігають формування запитів, специфічне для OpenAI (`service_tier`, `store`, compatibility reasoning, підказки кешу промптів) - **Проксі/сумісні маршрути:** + **Проксі/compatible маршрути:** - Використовують м’якшу поведінку сумісності - - Не примушують до строгих схем інструментів або заголовків, властивих лише нативним маршрутам + - Не примушують суворі схеми інструментів або заголовки, призначені лише для нативних маршрутів - Azure OpenAI використовує нативний транспорт і поведінку сумісності, але не отримує прихованих заголовків атрибуції. + Azure OpenAI використовує нативний транспорт і поведінку сумісності, але не отримує приховані заголовки атрибуції. @@ -540,13 +540,13 @@ OpenClaw додає специфічний для OpenAI внесок у під - Вибір провайдерів, посилань на моделі та поведінки failover. + Вибір провайдерів, посилань на моделі та поведінки резервного перемикання. - Спільні параметри інструмента для зображень і вибір провайдера. + Спільні параметри інструмента зображень і вибір провайдера. - Спільні параметри інструмента для відео і вибір провайдера. + Спільні параметри інструмента відео і вибір провайдера. Відомості про автентифікацію та правила повторного використання облікових даних.