diff --git a/docs/uk/providers/openrouter.md b/docs/uk/providers/openrouter.md index 9bd601bbe..847738f79 100644 --- a/docs/uk/providers/openrouter.md +++ b/docs/uk/providers/openrouter.md @@ -1,36 +1,36 @@ --- read_when: - - Вам потрібен єдиний ключ API для багатьох LLM + - Вам потрібен єдиний API-ключ для багатьох LLM - Ви хочете запускати моделі через OpenRouter в OpenClaw - Ви хочете використовувати OpenRouter для генерації зображень - Ви хочете використовувати OpenRouter для генерації відео summary: Використовуйте уніфікований API OpenRouter для доступу до багатьох моделей в OpenClaw title: OpenRouter x-i18n: - generated_at: "2026-05-04T00:07:11Z" + generated_at: "2026-05-04T00:14:04Z" model: gpt-5.5 provider: openai - source_hash: c262c43c2b8835f85f8e556b081bad8504a8c9b3b876f46e6decbab561e9be0e + source_hash: f6b7299408aa0de7530e2248c7fa5dae8c09095e2d20a0e9d12a64cab83966fc source_path: providers/openrouter.md workflow: 16 --- -OpenRouter надає **уніфікований API**, який маршрутизує запити до багатьох моделей через одну -кінцеву точку та API-ключ. Він сумісний з OpenAI, тому більшість OpenAI SDK працюють після зміни базової URL-адреси. +OpenRouter надає **уніфікований API**, який спрямовує запити до багатьох моделей через одну +кінцеву точку й ключ API. Він сумісний з OpenAI, тому більшість SDK OpenAI працюють після зміни базової URL-адреси. ## Початок роботи - - Створіть API-ключ на [openrouter.ai/keys](https://openrouter.ai/keys). + + Створіть ключ 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// @@ -59,16 +59,16 @@ OpenRouter надає **уніфікований API**, який маршрут доступних провайдерів і моделей див. у [/concepts/model-providers](/uk/concepts/model-providers). -Приклади вбудованих резервних варіантів: +Вбудовані приклади fallback: -| Посилання на модель | Примітки | -| --------------------------------- | -------------------------------- | +| Посилання на модель | Примітки | +| --------------------------------- | ------------------------------------- | | `openrouter/auto` | Автоматична маршрутизація OpenRouter | -| `openrouter/moonshotai/kimi-k2.6` | Kimi K2.6 через MoonshotAI | +| `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 також може забезпечувати роботу інст } ``` -OpenClaw надсилає запити на зображення до API зображень чат-завершень OpenRouter з `modalities: ["image", "text"]`. Моделі зображень Gemini отримують підтримувані підказки `aspectRatio` і `resolution` через `image_config` OpenRouter. Використовуйте `agents.defaults.imageGenerationModel.timeoutMs` для повільніших моделей зображень OpenRouter; параметр `timeoutMs` для окремого виклику інструмента `image_generate` все одно має пріоритет. +OpenClaw надсилає запити зображень до image 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,19 +103,19 @@ OpenRouter також може забезпечувати роботу інст } ``` -OpenClaw надсилає завдання text-to-video та image-to-video до OpenRouter, опитує +OpenClaw надсилає до OpenRouter завдання text-to-video та image-to-video, опитує повернений `polling_url` і завантажує завершене відео з -`unsigned_urls` OpenRouter або документованої кінцевої точки вмісту завдання. -Еталонні зображення за замовчуванням надсилаються як зображення першого/останнього кадру; зображення -з тегом `reference_image` надсилаються як вхідні посилання OpenRouter. Вбудований -стандартний варіант `google/veo-3.1-fast` оголошує поточно підтримувані тривалості 4/6/8 -секунд, роздільні здатності `720P`/`1080P` і співвідношення сторін `16:9`/`9:16`. +`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 +OpenRouter також можна використовувати як провайдер TTS через його сумісну з OpenAI кінцеву точку `/audio/speech`. ```json5 @@ -136,32 +136,32 @@ OpenRouter також можна використовувати як TTS-про } ``` -Якщо `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 заголовки атрибуції застосунку: -| Заголовок | Значення | -| ------------------------- | --------------------- | -| `HTTP-Referer` | `https://openclaw.ai` | -| `X-OpenRouter-Title` | `OpenClaw` | -| `X-OpenRouter-Categories` | `cli-agent` | +| Заголовок | Значення | +| ------------------------- | ------------------------------------------------------------------------------------------------------ | +| `HTTP-Referer` | `https://openclaw.ai` | +| `X-OpenRouter-Title` | `OpenClaw` | +| `X-OpenRouter-Categories` | `cli-agent,cloud-agent,programming-app,creative-writing,writing-assistant,general-chat,personal-agent` | -Якщо ви перенаправите провайдера OpenRouter на інший proxy або базову URL-адресу, OpenClaw -**не** вставлятиме ці специфічні для OpenRouter заголовки чи маркери кешу Anthropic. +Якщо ви перенаправите провайдер OpenRouter на інший проксі або базову URL-адресу, OpenClaw +**не** вставлятиме ці специфічні для OpenRouter заголовки або маркери кешу Anthropic. ## Розширена конфігурація - Кешування відповідей OpenRouter вмикається явно. Увімкніть його для кожної моделі OpenRouter за допомогою + Кешування відповідей OpenRouter вмикається явно. Увімкніть його для окремої моделі OpenRouter за допомогою параметрів моделі: ```json5 @@ -181,15 +181,15 @@ OpenRouter використовує Bearer-токен із вашим API-клю } ``` - OpenClaw надсилає `X-OpenRouter-Cache: true` і, якщо налаштовано, + OpenClaw надсилає `X-OpenRouter-Cache: true` і, коли налаштовано, `X-OpenRouter-Cache-TTL`. `responseCacheClear: true` примусово оновлює - поточний запит і зберігає замінну відповідь. Також приймаються snake_case-псевдоніми + поточний запит і зберігає замінну відповідь. Також приймаються псевдоніми snake_case (`response_cache`, `response_cache_ttl_seconds` і `response_cache_clear`). Це окремо від кешування промптів провайдера та від маркерів - Anthropic `cache_control` OpenRouter. Воно застосовується лише на перевірених - маршрутах `openrouter.ai`, а не на користувацьких базових URL proxy. + Anthropic `cache_control` OpenRouter. Застосовується лише на перевірених + маршрутах `openrouter.ai`, а не на користувацьких базових URL проксі. @@ -199,42 +199,42 @@ OpenRouter використовує Bearer-токен із вашим API-клю кращого повторного використання кешу промптів у блоках системних/розробницьких промптів. - - На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненими міркуваннями - відкидають кінцеві ходи попереднього заповнення асистента до того, як запит потрапить до OpenRouter, - відповідно до вимоги Anthropic, що розмови з міркуваннями мають завершуватися ходом користувача. + + На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненим міркуванням + відкидають кінцеві ходи попереднього заповнення асистента до того, як запит досягне OpenRouter, + відповідно до вимоги Anthropic, щоб розмови з міркуванням завершувалися ходом користувача. - - На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень мислення з - payload міркувань proxy OpenRouter. Непідтримувані підказки моделі та - `openrouter/auto` пропускають це вставлення міркувань. Hunter Alpha також пропускає - proxy-міркування для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг - повертати текст фінальної відповіді в полях міркувань для цього вилученого маршруту. + + На підтримуваних не-`auto` маршрутах OpenClaw зіставляє вибраний рівень thinking із + payloads reasoning проксі OpenRouter. Непідтримувані підказки моделей і + `openrouter/auto` пропускають цю ін’єкцію reasoning. Hunter Alpha також пропускає + reasoning проксі для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг + повертати текст остаточної відповіді в полях reasoning для цього вилученого маршруту. - + На перевірених маршрутах OpenRouter `openrouter/deepseek/deepseek-v4-flash` і `openrouter/deepseek/deepseek-v4-pro` заповнюють відсутній `reasoning_content` у - повторених ходах асистента, щоб розмови з мисленням/інструментами зберігали потрібну для DeepSeek V4 + повторно відтворених ходах асистента, щоб розмови thinking/tool зберігали потрібну для DeepSeek V4 форму продовження. - OpenRouter усе ще проходить через proxy-style шлях, сумісний з OpenAI, тому + OpenRouter усе ще проходить шлях OpenAI-сумісного проксі-стилю, тому нативне формування запитів лише для OpenAI, як-от `serviceTier`, Responses `store`, - payload сумісності з міркуваннями OpenAI та підказки кешу промптів, не пересилається. + payloads сумісності reasoning OpenAI і підказки кешу промптів, не пересилається. - - Посилання OpenRouter на основі Gemini залишаються на proxy-Gemini шляху: OpenClaw зберігає - там очищення сигнатур мислення Gemini, але не вмикає нативну валідацію повторення Gemini + + Посилання OpenRouter на базі Gemini залишаються на proxy-Gemini шляху: OpenClaw зберігає + очищення thought-signature Gemini там, але не вмикає нативну валідацію повтору Gemini або bootstrap-переписування. Якщо ви передаєте маршрутизацію провайдера OpenRouter у параметрах моделі, OpenClaw пересилає - її як метадані маршрутизації OpenRouter до запуску спільних обгорток stream. + її як метадані маршрутизації OpenRouter до запуску спільних обгорток потоку. @@ -244,7 +244,7 @@ OpenRouter використовує Bearer-токен із вашим API-клю Вибір провайдерів, посилань на моделі та поведінки failover. - + Повний довідник конфігурації для агентів, моделей і провайдерів.