diff --git a/docs/uk/providers/openai.md b/docs/uk/providers/openai.md index 29a3caf22..1000d8be6 100644 --- a/docs/uk/providers/openai.md +++ b/docs/uk/providers/openai.md @@ -1,27 +1,27 @@ --- read_when: - Ви хочете використовувати моделі OpenAI в OpenClaw - - Ви хочете автентифікацію за підпискою Codex замість API-ключів + - Ви хочете автентифікацію підписки Codex замість API-ключів - Вам потрібна суворіша поведінка виконання агента GPT-5 summary: Використовуйте OpenAI через API-ключі або підписку Codex в OpenClaw title: OpenAI x-i18n: - generated_at: "2026-04-21T01:38:05Z" + generated_at: "2026-04-21T01:46:58Z" model: gpt-5.4 provider: openai - source_hash: 4db510f037ec0dab5c2b419b242f182324543ad7feeaba515f71ed17f05a9486 + source_hash: 348c864a1bcdec93534dd1a08748788013abf530ac91823fa5f0deb95b20a72c source_path: providers/openai.md workflow: 15 --- # OpenAI -OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два варіанти автентифікації: +OpenAI надає API для розробників для моделей GPT. OpenClaw підтримує два способи автентифікації: -- **API-ключ** — прямий доступ до OpenAI Platform з оплатою за використання (`openai/*` моделі) -- **Підписка Codex** — вхід через ChatGPT/Codex із доступом за підпискою (`openai-codex/*` моделі) +- **API-ключ** — прямий доступ до OpenAI Platform з тарифікацією за використанням (моделі `openai/*`) +- **Підписка Codex** — вхід через ChatGPT/Codex із доступом за підпискою (моделі `openai-codex/*`) -OpenAI прямо підтримує використання OAuth-підписки в зовнішніх інструментах і робочих процесах, таких як OpenClaw. +OpenAI прямо підтримує використання OAuth підписки в зовнішніх інструментах і робочих процесах, таких як OpenClaw. ## Початок роботи @@ -29,11 +29,11 @@ OpenAI прямо підтримує використання OAuth-підпис - **Найкраще підходить для:** прямого доступу до API та оплати за використання. + **Найкраще підходить для:** прямого доступу до API та тарифікації за використанням. - Створіть або скопіюйте API-ключ у [панелі OpenAI Platform](https://platform.openai.com/api-keys). + Створіть або скопіюйте API-ключ з [панелі керування OpenAI Platform](https://platform.openai.com/api-keys). ```bash @@ -46,7 +46,7 @@ OpenAI прямо підтримує використання OAuth-підпис openclaw onboard --openai-api-key "$OPENAI_API_KEY" ``` - + ```bash openclaw models list --provider openai ``` @@ -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-ключа. Codex cloud потребує входу через ChatGPT. + **Найкраще підходить для:** використання вашої підписки ChatGPT/Codex замість окремого API-ключа. Codex cloud вимагає входу через ChatGPT. @@ -94,12 +94,12 @@ OpenAI прямо підтримує використання OAuth-підпис openclaw models auth login --provider openai-codex ``` - + ```bash openclaw config set agents.defaults.model.primary openai-codex/gpt-5.4 ``` - + ```bash openclaw models list --provider openai-codex ``` @@ -114,7 +114,7 @@ OpenAI прямо підтримує використання OAuth-підпис | `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Вхід Codex (залежить від entitlement) | - Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API-ключем для прямого доступу до Platform, а `openai-codex/*` — для доступу за підпискою Codex. + Цей маршрут навмисно відокремлений від `openai/gpt-5.4`. Використовуйте `openai/*` з API-ключем для прямого доступу до Platform і `openai-codex/*` для доступу через підписку Codex. ### Приклад конфігурації @@ -126,19 +126,19 @@ OpenAI прямо підтримує використання OAuth-підпис ``` - Якщо онбординг повторно використовує наявний вхід Codex CLI, цими обліковими даними й надалі керує Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex. + Якщо онбординг повторно використовує наявний вхід Codex CLI, ці облікові дані й надалі керуються Codex CLI. Після завершення строку дії OpenClaw спочатку повторно зчитує зовнішнє джерело Codex, а потім записує оновлені облікові дані назад у сховище Codex. ### Обмеження вікна контексту - OpenClaw розглядає метадані моделі та обмеження контексту під час виконання як окремі значення. + OpenClaw розглядає метадані моделі та обмеження контексту середовища виконання як окремі значення. Для `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`, щоб обмежити бюджет контексту середовища виконання. @@ -166,7 +166,7 @@ OpenAI прямо підтримує використання OAuth-підпис | Можливість | Значення | | ------------------------- | ---------------------------------- | | Модель за замовчуванням | `openai/gpt-image-1` | -| Макс. кількість зображень на запит | 4 | +| Максимум зображень на запит | 4 | | Режим редагування | Увімкнено (до 5 еталонних зображень) | | Перевизначення розміру | Підтримується | | Співвідношення сторін / роздільна здатність | Не передається до OpenAI Images API | @@ -182,7 +182,7 @@ OpenAI прямо підтримує використання OAuth-підпис ``` -Дивіться [Генерація зображень](/uk/tools/image-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover. +Див. [Генерація зображень](/uk/tools/image-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. ## Генерація відео @@ -192,8 +192,8 @@ OpenAI прямо підтримує використання OAuth-підпис | Можливість | Значення | | ---------------- | --------------------------------------------------------------------------------- | | Модель за замовчуванням | `openai/sora-2` | -| Режими | Текст у відео, зображення у відео, редагування одного відео | -| Вхідні посилання | 1 зображення або 1 відео | +| Режими | Текст у відео, зображення у відео, редагування одного відео | +| Еталонні входи | 1 зображення або 1 відео | | Перевизначення розміру | Підтримується | | Інші перевизначення | `aspectRatio`, `resolution`, `audio`, `watermark` ігноруються з попередженням інструмента | @@ -208,18 +208,18 @@ OpenAI прямо підтримує використання OAuth-підпис ``` -Дивіться [Генерація відео](/uk/tools/video-generation), щоб дізнатися про спільні параметри інструмента, вибір провайдера та поведінку failover. +Див. [Генерація відео](/uk/tools/video-generation), щоб ознайомитися зі спільними параметрами інструмента, вибором провайдера та поведінкою failover. ## Внесок у промпт 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 додає позначений контракт поведінки для форми виводу, наполегливості інструментів, перевірок залежностей, паралельного пошуку, перевірок завершення, верифікації та автономності за замовчуванням. Ці настанови завжди ввімкнені для відповідних моделей GPT-5. Рівень дружнього стилю взаємодії є окремим і налаштовуваним. | Значення | Ефект | | ---------------------- | ------------------------------------------ | -| `"friendly"` (типово) | Увімкнути рівень дружнього стилю взаємодії | +| `"friendly"` (за замовчуванням) | Увімкнути рівень дружнього стилю взаємодії | | `"on"` | Псевдонім для `"friendly"` | | `"off"` | Вимкнути лише рівень дружнього стилю | @@ -252,7 +252,7 @@ OpenClaw додає специфічний для OpenAI внесок у про Вбудований Plugin `openai` реєструє синтез мовлення для поверхні `messages.tts`. - | Налаштування | Шлях конфігурації | Типово | + | Налаштування | Шлях конфігурації | За замовчуванням | |---------|------------|---------| | Модель | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` | | Голос | `messages.tts.providers.openai.voice` | `coral` | @@ -277,7 +277,7 @@ OpenClaw додає специфічний для OpenAI внесок у про ``` - Установіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL для TTS, не впливаючи на кінцеву точку API чату. + Встановіть `OPENAI_TTS_BASE_URL`, щоб перевизначити базовий URL TTS без впливу на кінцеву точку API чату. @@ -285,7 +285,7 @@ OpenClaw додає специфічний для OpenAI внесок у про Вбудований Plugin `openai` реєструє транскрипцію в реальному часі для Plugin Voice Call. - | Налаштування | Шлях конфігурації | Типово | + | Налаштування | Шлях конфігурації | За замовчуванням | |---------|------------|---------| | Модель | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` | | Тривалість тиші | `...openai.silenceDurationMs` | `800` | @@ -301,7 +301,7 @@ OpenClaw додає специфічний для OpenAI внесок у про Вбудований Plugin `openai` реєструє голос у реальному часі для Plugin Voice Call. - | Налаштування | Шлях конфігурації | Типово | + | Налаштування | Шлях конфігурації | За замовчуванням | |---------|------------|---------| | Модель | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` | | Голос | `...openai.voice` | `alloy` | @@ -311,7 +311,7 @@ OpenClaw додає специфічний для OpenAI внесок у про | API-ключ | `...openai.apiKey` | Резервно використовує `OPENAI_API_KEY` | - Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двоспрямований виклик інструментів. Використовує аудіоформат G.711 u-law. + Підтримує Azure OpenAI через ключі конфігурації `azureEndpoint` і `azureDeployment`. Підтримує двонапрямлений виклик інструментів. Використовує аудіоформат G.711 u-law. @@ -320,18 +320,18 @@ OpenClaw додає специфічний для OpenAI внесок у про ## Розширена конфігурація - - OpenClaw використовує спочатку WebSocket із резервним переходом на SSE (`"auto"`) як для `openai/*`, так і для `openai-codex/*`. + + OpenClaw використовує WebSocket-first із резервним переходом на SSE (`"auto"`) для `openai/*` і `openai-codex/*`. У режимі `"auto"` OpenClaw: - Повторює одну ранню помилку WebSocket перед переходом на SSE - Після помилки позначає WebSocket як деградований приблизно на 60 секунд і використовує SSE під час охолодження - - Додає стабільні заголовки ідентифікації сеансу й ходу для повторних спроб і повторних з’єднань - - Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) між варіантами транспорту + - Прикріплює стабільні заголовки ідентифікації сесії та ходу для повторів і повторних підключень + - Нормалізує лічильники використання (`input_tokens` / `prompt_tokens`) у різних варіантах транспорту | Значення | Поведінка | |-------|----------| - | `"auto"` (типово) | Спочатку WebSocket, резервно SSE | + | `"auto"` (за замовчуванням) | Спочатку WebSocket, резервно SSE | | `"sse"` | Примусово лише SSE | | `"websocket"` | Примусово лише WebSocket | @@ -355,11 +355,11 @@ OpenClaw додає специфічний для OpenAI внесок у про - - OpenClaw за замовчуванням вмикає прогрівання WebSocket для `openai/*`, щоб зменшити затримку першого ходу. + + OpenClaw за замовчуванням вмикає попередній прогрів WebSocket для `openai/*`, щоб зменшити затримку першого ходу. ```json5 - // Вимкнути прогрівання + // Вимкнути попередній прогрів { agents: { defaults: { @@ -397,7 +397,7 @@ OpenClaw додає специфічний для OpenAI внесок у про ``` - Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в UI Sessions повертає сеанс до налаштованого значення за замовчуванням. + Перевизначення сеансу мають пріоритет над конфігурацією. Очищення перевизначення сеансу в UI сеансів повертає сеанс до налаштованого значення за замовчуванням. @@ -421,7 +421,7 @@ 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` без змін. @@ -429,7 +429,7 @@ OpenClaw додає специфічний для OpenAI внесок у про Для прямих моделей OpenAI Responses (`openai/*` на `api.openai.com`) OpenClaw автоматично вмикає Server-side Compaction: - - Примусово встановлює `store: true` (якщо compat моделі не задає `supportsStore: false`) + - Примусово встановлює `store: true` (якщо сумісність моделі не задає `supportsStore: false`) - Вставляє `context_management: [{ type: "compaction", compact_threshold: ... }]` - `compact_threshold` за замовчуванням: 70% від `contextWindow` (або `80000`, якщо недоступно) @@ -487,13 +487,13 @@ OpenClaw додає специфічний для OpenAI внесок у про - `responsesServerCompaction` керує лише вставкою `context_management`. Прямі моделі OpenAI Responses однаково примусово встановлюють `store: true`, якщо compat не задає `supportsStore: false`. + `responsesServerCompaction` керує лише вставленням `context_management`. Прямі моделі OpenAI Responses однаково примусово встановлюють `store: true`, якщо сумісність не задає `supportsStore: false`. - Для запусків сімейства GPT-5 на `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання: + Для запусків сімейства GPT-5 у `openai/*` і `openai-codex/*` OpenClaw може використовувати суворіший вбудований контракт виконання: ```json5 { @@ -506,31 +506,31 @@ OpenClaw додає специфічний для OpenAI внесок у про ``` З `strict-agentic` OpenClaw: - - Більше не вважає хід лише з планом успішним прогресом, якщо доступна дія інструмента - - Повторює хід із вказівкою діяти зараз + - Більше не вважає хід лише з планом успішним прогресом, коли доступна дія інструмента + - Повторює хід зі спрямуванням на негайну дію - Автоматично вмикає `update_plan` для суттєвої роботи - Показує явний заблокований стан, якщо модель продовжує планувати без дій - Застосовується лише до запусків сімейства OpenAI і Codex GPT-5. Інші провайдери та старіші сімейства моделей зберігають типову поведінку. + Поширюється лише на запуски сімейства GPT-5 OpenAI і Codex. Інші провайдери та старіші сімейства моделей зберігають поведінку за замовчуванням. - - OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI та загальні сумісні з OpenAI проксі `/v1`: + + OpenClaw по-різному обробляє прямі кінцеві точки OpenAI, Codex і Azure OpenAI порівняно із загальними OpenAI-compatible проксі `/v1`: **Нативні маршрути** (`openai/*`, `openai-codex/*`, Azure OpenAI): - Зберігають `reasoning: { effort: "none" }` без змін, коли reasoning явно вимкнено - За замовчуванням використовують строгий режим для схем інструментів - Додають приховані заголовки атрибуції лише на перевірених нативних хостах - - Зберігають формування запитів, специфічне для OpenAI (`service_tier`, `store`, reasoning-compat, підказки кешу промптів) + - Зберігають формування запитів лише для OpenAI (`service_tier`, `store`, reasoning-compat, підказки кешу промптів) **Проксі/сумісні маршрути:** - - Використовують м’якшу compat-поведінку + - Використовують м’якшу сумісну поведінку - Не примушують строгі схеми інструментів або нативні заголовки - Azure OpenAI використовує нативний транспорт і compat-поведінку, але не отримує прихованих заголовків атрибуції. + Azure OpenAI використовує нативний транспорт і сумісну поведінку, але не отримує приховані заголовки атрибуції. @@ -545,9 +545,9 @@ OpenClaw додає специфічний для OpenAI внесок у про Спільні параметри інструмента зображень і вибір провайдера. - Спільні параметри відеоінструмента й вибір провайдера. + Спільні параметри інструмента відео і вибір провайдера. - - Деталі автентифікації та правила повторного використання облікових даних. + + Докладніше про автентифікацію та правила повторного використання облікових даних.