diff --git a/docs/uk/providers/openrouter.md b/docs/uk/providers/openrouter.md index 9818722ab..9bd601bbe 100644 --- a/docs/uk/providers/openrouter.md +++ b/docs/uk/providers/openrouter.md @@ -1,22 +1,22 @@ --- read_when: - - Вам потрібен єдиний API-ключ для багатьох LLM + - Вам потрібен єдиний ключ API для багатьох LLM - Ви хочете запускати моделі через OpenRouter в OpenClaw - Ви хочете використовувати OpenRouter для генерації зображень - Ви хочете використовувати OpenRouter для генерації відео -summary: Використовуйте уніфікований API OpenRouter, щоб отримати доступ до багатьох моделей в OpenClaw +summary: Використовуйте уніфікований API OpenRouter для доступу до багатьох моделей в OpenClaw title: OpenRouter x-i18n: - generated_at: "2026-05-02T09:53:06Z" + generated_at: "2026-05-04T00:07:11Z" model: gpt-5.5 provider: openai - source_hash: e98b8b540265b6d11681390c02cb68312f33625bf223823a2dbca17e877c0422 + source_hash: c262c43c2b8835f85f8e556b081bad8504a8c9b3b876f46e6decbab561e9be0e source_path: providers/openrouter.md workflow: 16 --- -OpenRouter надає **уніфікований API**, який маршрутизує запити до багатьох моделей за одним -endpoint і API-ключем. Він сумісний з OpenAI, тому більшість OpenAI SDK працюють після зміни базової URL-адреси. +OpenRouter надає **уніфікований API**, який маршрутизує запити до багатьох моделей через одну +кінцеву точку та API-ключ. Він сумісний з OpenAI, тому більшість OpenAI SDK працюють після зміни базової URL-адреси. ## Початок роботи @@ -24,13 +24,13 @@ endpoint і API-ключем. Він сумісний з OpenAI, тому біл Створіть API-ключ на [openrouter.ai/keys](https://openrouter.ai/keys). - + ```bash openclaw onboard --auth-choice openrouter-api-key ``` - За замовчуванням onboarding використовує `openrouter/auto`. Виберіть конкретну модель пізніше: + За замовчуванням під час початкового налаштування використовується `openrouter/auto`. Пізніше виберіть конкретну модель: ```bash openclaw models set openrouter// @@ -56,10 +56,10 @@ endpoint і API-ключем. Він сумісний з OpenAI, тому біл Посилання на моделі мають шаблон `openrouter//`. Повний список -доступних провайдерів і моделей дивіться в [/concepts/model-providers](/uk/concepts/model-providers). +доступних провайдерів і моделей див. у [/concepts/model-providers](/uk/concepts/model-providers). -Вбудовані приклади резервних варіантів: +Приклади вбудованих резервних варіантів: | Посилання на модель | Примітки | | --------------------------------- | -------------------------------- | @@ -84,11 +84,11 @@ OpenRouter також може забезпечувати роботу інст } ``` -OpenClaw надсилає запити на зображення до API зображень chat completions OpenRouter з `modalities: ["image", "text"]`. Моделі зображень Gemini отримують підтримувані підказки `aspectRatio` і `resolution` через `image_config` OpenRouter. Використовуйте `agents.defaults.imageGenerationModel.timeoutMs` для повільніших моделей зображень OpenRouter; параметр `timeoutMs` для окремого виклику інструмента `image_generate` усе одно має пріоритет. +OpenClaw надсилає запити на зображення до API зображень чат-завершень OpenRouter з `modalities: ["image", "text"]`. Моделі зображень Gemini отримують підтримувані підказки `aspectRatio` і `resolution` через `image_config` OpenRouter. Використовуйте `agents.defaults.imageGenerationModel.timeoutMs` для повільніших моделей зображень OpenRouter; параметр `timeoutMs` для окремого виклику інструмента `image_generate` все одно має пріоритет. ## Генерація відео -OpenRouter також може забезпечувати роботу інструмента `video_generate` через свій асинхронний API `/videos`. Використовуйте відеомодель OpenRouter у `agents.defaults.videoGenerationModel`: +OpenRouter також може забезпечувати роботу інструмента `video_generate` через свій асинхронний API `/videos`. Використовуйте модель відео OpenRouter у `agents.defaults.videoGenerationModel`: ```json5 { @@ -103,20 +103,20 @@ OpenRouter також може забезпечувати роботу інст } ``` -OpenClaw надсилає в OpenRouter завдання text-to-video та image-to-video, опитує -повернений `polling_url` і завантажує готове відео з -`unsigned_urls` OpenRouter або задокументованого endpoint вмісту завдання. -Еталонні зображення за замовчуванням надсилаються як зображення першого/останнього кадру; зображення, -позначені `reference_image`, надсилаються як вхідні посилання OpenRouter. Вбудований -типовий варіант `google/veo-3.1-fast` оголошує наразі підтримувані тривалості 4/6/8 +OpenClaw надсилає завдання text-to-video та image-to-video до OpenRouter, опитує +повернений `polling_url` і завантажує завершене відео з +`unsigned_urls` OpenRouter або документованої кінцевої точки вмісту завдання. +Еталонні зображення за замовчуванням надсилаються як зображення першого/останнього кадру; зображення +з тегом `reference_image` надсилаються як вхідні посилання OpenRouter. Вбудований +стандартний варіант `google/veo-3.1-fast` оголошує поточно підтримувані тривалості 4/6/8 секунд, роздільні здатності `720P`/`1080P` і співвідношення сторін `16:9`/`9:16`. Video-to-video не зареєстровано для OpenRouter, оскільки upstream API генерації відео наразі приймає текст і посилання на зображення. ## Text-to-speech -OpenRouter також можна використовувати як TTS-провайдера через його сумісний з OpenAI -endpoint `/audio/speech`. +OpenRouter також можна використовувати як TTS-провайдера через його сумісну з OpenAI +кінцеву точку `/audio/speech`. ```json5 { @@ -136,15 +136,15 @@ endpoint `/audio/speech`. } ``` -Якщо `messages.tts.providers.openrouter.apiKey` пропущено, TTS повторно використовує +Якщо `messages.tts.providers.openrouter.apiKey` опущено, TTS повторно використовує `models.providers.openrouter.apiKey`, а потім `OPENROUTER_API_KEY`. ## Автентифікація та заголовки -OpenRouter під капотом використовує Bearer-токен із вашим API-ключем. +OpenRouter використовує Bearer-токен із вашим API-ключем під капотом. -Для реальних запитів OpenRouter (`https://openrouter.ai/api/v1`) OpenClaw також додає -задокументовані заголовки атрибуції застосунку OpenRouter: +У реальних запитах OpenRouter (`https://openrouter.ai/api/v1`) OpenClaw також додає +документовані заголовки атрибуції застосунку OpenRouter: | Заголовок | Значення | | ------------------------- | --------------------- | @@ -153,55 +153,88 @@ OpenRouter під капотом використовує Bearer-токен із | `X-OpenRouter-Categories` | `cli-agent` | -Якщо ви перенаправите провайдера OpenRouter на інший проксі або базову URL-адресу, OpenClaw -**не** вставляє ці специфічні для OpenRouter заголовки або маркери кешу Anthropic. +Якщо ви перенаправите провайдера OpenRouter на інший proxy або базову URL-адресу, OpenClaw +**не** вставлятиме ці специфічні для OpenRouter заголовки чи маркери кешу Anthropic. ## Розширена конфігурація + + Кешування відповідей OpenRouter вмикається явно. Увімкніть його для кожної моделі OpenRouter за допомогою + параметрів моделі: + + ```json5 + { + agents: { + defaults: { + models: { + "openrouter/auto": { + params: { + responseCache: true, + responseCacheTtlSeconds: 300, + }, + }, + }, + }, + }, + } + ``` + + OpenClaw надсилає `X-OpenRouter-Cache: true` і, якщо налаштовано, + `X-OpenRouter-Cache-TTL`. `responseCacheClear: true` примусово оновлює + поточний запит і зберігає замінну відповідь. Також приймаються snake_case-псевдоніми + (`response_cache`, `response_cache_ttl_seconds` і + `response_cache_clear`). + + Це окремо від кешування промптів провайдера та від маркерів + Anthropic `cache_control` OpenRouter. Воно застосовується лише на перевірених + маршрутах `openrouter.ai`, а не на користувацьких базових URL proxy. + + + На перевірених маршрутах OpenRouter посилання на моделі Anthropic зберігають специфічні для OpenRouter маркери Anthropic `cache_control`, які OpenClaw використовує для кращого повторного використання кешу промптів у блоках системних/розробницьких промптів. - - На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненим reasoning - вилучають кінцеві ходи попереднього заповнення assistant до того, як запит потрапляє в OpenRouter, - відповідно до вимоги Anthropic, щоб reasoning-розмови завершувалися ходом користувача. + + На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненими міркуваннями + відкидають кінцеві ходи попереднього заповнення асистента до того, як запит потрапить до OpenRouter, + відповідно до вимоги Anthropic, що розмови з міркуваннями мають завершуватися ходом користувача. - - На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень thinking з - reasoning-навантаженнями проксі OpenRouter. Непідтримувані підказки моделей і - `openrouter/auto` пропускають цю reasoning-ін’єкцію. Hunter Alpha також пропускає - reasoning проксі для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг - повертати текст фінальної відповіді в reasoning-полях для цього вилученого маршруту. + + На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень мислення з + payload міркувань proxy OpenRouter. Непідтримувані підказки моделі та + `openrouter/auto` пропускають це вставлення міркувань. Hunter Alpha також пропускає + proxy-міркування для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг + повертати текст фінальної відповіді в полях міркувань для цього вилученого маршруту. - + На перевірених маршрутах OpenRouter `openrouter/deepseek/deepseek-v4-flash` і `openrouter/deepseek/deepseek-v4-pro` заповнюють відсутній `reasoning_content` у - повторно відтворених ходах assistant, щоб розмови thinking/tool зберігали потрібну - форму подальших відповідей DeepSeek V4. + повторених ходах асистента, щоб розмови з мисленням/інструментами зберігали потрібну для DeepSeek V4 + форму продовження. - OpenRouter усе ще працює через проксі-стиль сумісного з OpenAI шляху, тому + OpenRouter усе ще проходить через proxy-style шлях, сумісний з OpenAI, тому нативне формування запитів лише для OpenAI, як-от `serviceTier`, Responses `store`, - reasoning-сумісні навантаження OpenAI і підказки кешу промптів, не пересилаються. + payload сумісності з міркуваннями OpenAI та підказки кешу промптів, не пересилається. - - Посилання OpenRouter на базі Gemini залишаються на шляху proxy-Gemini: OpenClaw зберігає - там очищення thought-signature Gemini, але не вмикає нативну валідацію повторного відтворення Gemini - або переписування bootstrap. + + Посилання OpenRouter на основі Gemini залишаються на proxy-Gemini шляху: OpenClaw зберігає + там очищення сигнатур мислення Gemini, але не вмикає нативну валідацію повторення Gemini + або bootstrap-переписування. Якщо ви передаєте маршрутизацію провайдера OpenRouter у параметрах моделі, OpenClaw пересилає - її як метадані маршрутизації OpenRouter до запуску спільних stream-обгорток. + її як метадані маршрутизації OpenRouter до запуску спільних обгорток stream. @@ -211,7 +244,7 @@ OpenRouter під капотом використовує Bearer-токен із Вибір провайдерів, посилань на моделі та поведінки failover. - + Повний довідник конфігурації для агентів, моделей і провайдерів.