diff --git a/docs/uk/providers/openrouter.md b/docs/uk/providers/openrouter.md index 1612f7c16..9818722ab 100644 --- a/docs/uk/providers/openrouter.md +++ b/docs/uk/providers/openrouter.md @@ -1,22 +1,22 @@ --- read_when: - Вам потрібен єдиний API-ключ для багатьох LLM - - Ви хочете запускати моделі через OpenRouter у OpenClaw + - Ви хочете запускати моделі через OpenRouter в OpenClaw - Ви хочете використовувати OpenRouter для генерації зображень - Ви хочете використовувати OpenRouter для генерації відео -summary: Використовуйте уніфікований API OpenRouter для доступу до багатьох моделей в OpenClaw +summary: Використовуйте уніфікований API OpenRouter, щоб отримати доступ до багатьох моделей в OpenClaw title: OpenRouter x-i18n: - generated_at: "2026-05-02T05:53:06Z" + generated_at: "2026-05-02T09:53:06Z" model: gpt-5.5 provider: openai - source_hash: f6f7c6f9c77e2a62866fdeaa65667d3871930be2ce22a638accdb8baa76220fd + source_hash: e98b8b540265b6d11681390c02cb68312f33625bf223823a2dbca17e877c0422 source_path: providers/openrouter.md workflow: 16 --- -OpenRouter надає **уніфікований API**, який маршрутизує запити до багатьох моделей через єдину -кінцеву точку та API-ключ. Він сумісний з OpenAI, тож більшість OpenAI SDK працюють після зміни базового URL. +OpenRouter надає **уніфікований API**, який маршрутизує запити до багатьох моделей за одним +endpoint і API-ключем. Він сумісний з OpenAI, тому більшість OpenAI SDK працюють після зміни базової URL-адреси. ## Початок роботи @@ -24,13 +24,13 @@ OpenRouter надає **уніфікований API**, який маршрут Створіть API-ключ на [openrouter.ai/keys](https://openrouter.ai/keys). - + ```bash openclaw onboard --auth-choice openrouter-api-key ``` - Онбординг за замовчуванням використовує `openrouter/auto`. Пізніше виберіть конкретну модель: + За замовчуванням onboarding використовує `openrouter/auto`. Виберіть конкретну модель пізніше: ```bash openclaw models set openrouter// @@ -56,19 +56,19 @@ OpenRouter надає **уніфікований API**, який маршрут Посилання на моделі мають шаблон `openrouter//`. Повний список -доступних провайдерів і моделей див. у [/concepts/model-providers](/uk/concepts/model-providers). +доступних провайдерів і моделей дивіться в [/concepts/model-providers](/uk/concepts/model-providers). Вбудовані приклади резервних варіантів: -| Посилання на модель | Примітки | -| -------------------------------- | -------------------------------- | -| `openrouter/auto` | Автоматична маршрутизація OpenRouter | +| Посилання на модель | Примітки | +| --------------------------------- | -------------------------------- | +| `openrouter/auto` | Автоматична маршрутизація OpenRouter | | `openrouter/moonshotai/kimi-k2.6` | Kimi K2.6 через MoonshotAI | ## Генерація зображень -OpenRouter також може підтримувати інструмент `image_generate`. Використайте модель зображень OpenRouter у `agents.defaults.imageGenerationModel`: +OpenRouter також може забезпечувати роботу інструмента `image_generate`. Використовуйте модель зображень OpenRouter у `agents.defaults.imageGenerationModel`: ```json5 { @@ -84,11 +84,11 @@ OpenRouter також може підтримувати інструмент `im } ``` -OpenClaw надсилає запити зображень до OpenRouter API зображень chat completions із `modalities: ["image", "text"]`. Моделі зображень Gemini отримують підтримувані підказки `aspectRatio` і `resolution` через `image_config` OpenRouter. Використовуйте `agents.defaults.imageGenerationModel.timeoutMs` для повільніших моделей зображень OpenRouter; параметр `timeoutMs` інструмента `image_generate` для окремого виклику все одно має пріоритет. +OpenClaw надсилає запити на зображення до API зображень chat completions 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 також може підтримувати інструмент `vi } ``` -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`. +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 +секунд, роздільні здатності `720P`/`1080P` і співвідношення сторін `16:9`/`9:16`. Video-to-video не зареєстровано для OpenRouter, оскільки upstream API генерації відео наразі приймає текст і посилання на зображення. ## Text-to-speech -OpenRouter також можна використовувати як провайдера TTS через його сумісну з OpenAI -кінцеву точку `/audio/speech`. +OpenRouter також можна використовувати як TTS-провайдера через його сумісний з OpenAI +endpoint `/audio/speech`. ```json5 { @@ -143,7 +143,7 @@ OpenRouter також можна використовувати як прова OpenRouter під капотом використовує Bearer-токен із вашим API-ключем. -У реальних запитах OpenRouter (`https://openrouter.ai/api/v1`) OpenClaw також додає +Для реальних запитів OpenRouter (`https://openrouter.ai/api/v1`) OpenClaw також додає задокументовані заголовки атрибуції застосунку OpenRouter: | Заголовок | Значення | @@ -153,7 +153,7 @@ OpenRouter під капотом використовує Bearer-токен із | `X-OpenRouter-Categories` | `cli-agent` | -Якщо ви перенаправите провайдера OpenRouter на інший проксі або базовий URL, OpenClaw +Якщо ви перенаправите провайдера OpenRouter на інший проксі або базову URL-адресу, OpenClaw **не** вставляє ці специфічні для OpenRouter заголовки або маркери кешу Anthropic. @@ -166,35 +166,42 @@ OpenRouter під капотом використовує Bearer-токен із кращого повторного використання кешу промптів у блоках системних/розробницьких промптів. - - На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненими міркуваннями - видаляють кінцеві ходи попереднього заповнення асистента перед тим, як запит досягне OpenRouter, - відповідно до вимоги Anthropic, щоб розмови з міркуваннями завершувалися ходом користувача. + + На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненим reasoning + вилучають кінцеві ходи попереднього заповнення assistant до того, як запит потрапляє в OpenRouter, + відповідно до вимоги Anthropic, щоб reasoning-розмови завершувалися ходом користувача. - - На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень мислення з - payload міркувань проксі OpenRouter. Непідтримувані підказки моделей і - `openrouter/auto` пропускають це вставлення міркувань. Hunter Alpha також пропускає - проксі-міркування для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг - повертати текст фінальної відповіді в полях міркувань для цього вилученого маршруту. + + На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень thinking з + reasoning-навантаженнями проксі OpenRouter. Непідтримувані підказки моделей і + `openrouter/auto` пропускають цю reasoning-ін’єкцію. Hunter Alpha також пропускає + reasoning проксі для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг + повертати текст фінальної відповіді в reasoning-полях для цього вилученого маршруту. + + + + На перевірених маршрутах OpenRouter `openrouter/deepseek/deepseek-v4-flash` і + `openrouter/deepseek/deepseek-v4-pro` заповнюють відсутній `reasoning_content` у + повторно відтворених ходах assistant, щоб розмови thinking/tool зберігали потрібну + форму подальших відповідей DeepSeek V4. - OpenRouter усе ще проходить через проксі-стиль OpenAI-сумісного шляху, тому + OpenRouter усе ще працює через проксі-стиль сумісного з OpenAI шляху, тому нативне формування запитів лише для OpenAI, як-от `serviceTier`, Responses `store`, - payload сумісності міркувань OpenAI і підказки кешу промптів, не пересилається. + reasoning-сумісні навантаження OpenAI і підказки кешу промптів, не пересилаються. - Посилання OpenRouter на базі Gemini залишаються на проксі-Gemini шляху: OpenClaw зберігає - там очищення підписів думок Gemini, але не вмикає нативну перевірку відтворення Gemini + Посилання OpenRouter на базі Gemini залишаються на шляху proxy-Gemini: OpenClaw зберігає + там очищення thought-signature Gemini, але не вмикає нативну валідацію повторного відтворення Gemini або переписування bootstrap. Якщо ви передаєте маршрутизацію провайдера OpenRouter у параметрах моделі, OpenClaw пересилає - її як метадані маршрутизації OpenRouter перед запуском спільних обгорток потоку. + її як метадані маршрутизації OpenRouter до запуску спільних stream-обгорток.