chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
8fea6cee0b
commit
9feeb19cb0
@ -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, тому біл
|
||||
<Step title="Отримайте свій API-ключ">
|
||||
Створіть API-ключ на [openrouter.ai/keys](https://openrouter.ai/keys).
|
||||
</Step>
|
||||
<Step title="Запустіть onboarding">
|
||||
<Step title="Запустіть початкове налаштування">
|
||||
```bash
|
||||
openclaw onboard --auth-choice openrouter-api-key
|
||||
```
|
||||
</Step>
|
||||
<Step title="(Необов’язково) Перейдіть на конкретну модель">
|
||||
За замовчуванням onboarding використовує `openrouter/auto`. Виберіть конкретну модель пізніше:
|
||||
За замовчуванням під час початкового налаштування використовується `openrouter/auto`. Пізніше виберіть конкретну модель:
|
||||
|
||||
```bash
|
||||
openclaw models set openrouter/<provider>/<model>
|
||||
@ -56,10 +56,10 @@ endpoint і API-ключем. Він сумісний з OpenAI, тому біл
|
||||
|
||||
<Note>
|
||||
Посилання на моделі мають шаблон `openrouter/<provider>/<model>`. Повний список
|
||||
доступних провайдерів і моделей дивіться в [/concepts/model-providers](/uk/concepts/model-providers).
|
||||
доступних провайдерів і моделей див. у [/concepts/model-providers](/uk/concepts/model-providers).
|
||||
</Note>
|
||||
|
||||
Вбудовані приклади резервних варіантів:
|
||||
Приклади вбудованих резервних варіантів:
|
||||
|
||||
| Посилання на модель | Примітки |
|
||||
| --------------------------------- | -------------------------------- |
|
||||
@ -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` |
|
||||
|
||||
<Warning>
|
||||
Якщо ви перенаправите провайдера OpenRouter на інший проксі або базову URL-адресу, OpenClaw
|
||||
**не** вставляє ці специфічні для OpenRouter заголовки або маркери кешу Anthropic.
|
||||
Якщо ви перенаправите провайдера OpenRouter на інший proxy або базову URL-адресу, OpenClaw
|
||||
**не** вставлятиме ці специфічні для OpenRouter заголовки чи маркери кешу Anthropic.
|
||||
</Warning>
|
||||
|
||||
## Розширена конфігурація
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Кешування відповідей">
|
||||
Кешування відповідей 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.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Маркери кешу Anthropic">
|
||||
На перевірених маршрутах OpenRouter посилання на моделі Anthropic зберігають
|
||||
специфічні для OpenRouter маркери Anthropic `cache_control`, які OpenClaw використовує для
|
||||
кращого повторного використання кешу промптів у блоках системних/розробницьких промптів.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Попереднє заповнення reasoning Anthropic">
|
||||
На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненим reasoning
|
||||
вилучають кінцеві ходи попереднього заповнення assistant до того, як запит потрапляє в OpenRouter,
|
||||
відповідно до вимоги Anthropic, щоб reasoning-розмови завершувалися ходом користувача.
|
||||
<Accordion title="Попереднє заповнення міркувань Anthropic">
|
||||
На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненими міркуваннями
|
||||
відкидають кінцеві ходи попереднього заповнення асистента до того, як запит потрапить до OpenRouter,
|
||||
відповідно до вимоги Anthropic, що розмови з міркуваннями мають завершуватися ходом користувача.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Ін’єкція thinking / reasoning">
|
||||
На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень thinking з
|
||||
reasoning-навантаженнями проксі OpenRouter. Непідтримувані підказки моделей і
|
||||
`openrouter/auto` пропускають цю reasoning-ін’єкцію. Hunter Alpha також пропускає
|
||||
reasoning проксі для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг
|
||||
повертати текст фінальної відповіді в reasoning-полях для цього вилученого маршруту.
|
||||
<Accordion title="Вставлення мислення / міркувань">
|
||||
На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень мислення з
|
||||
payload міркувань proxy OpenRouter. Непідтримувані підказки моделі та
|
||||
`openrouter/auto` пропускають це вставлення міркувань. Hunter Alpha також пропускає
|
||||
proxy-міркування для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг
|
||||
повертати текст фінальної відповіді в полях міркувань для цього вилученого маршруту.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Повторне відтворення reasoning DeepSeek V4">
|
||||
<Accordion title="Повторення міркувань DeepSeek V4">
|
||||
На перевірених маршрутах OpenRouter `openrouter/deepseek/deepseek-v4-flash` і
|
||||
`openrouter/deepseek/deepseek-v4-pro` заповнюють відсутній `reasoning_content` у
|
||||
повторно відтворених ходах assistant, щоб розмови thinking/tool зберігали потрібну
|
||||
форму подальших відповідей DeepSeek V4.
|
||||
повторених ходах асистента, щоб розмови з мисленням/інструментами зберігали потрібну для DeepSeek V4
|
||||
форму продовження.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Формування запитів лише для OpenAI">
|
||||
OpenRouter усе ще працює через проксі-стиль сумісного з OpenAI шляху, тому
|
||||
OpenRouter усе ще проходить через proxy-style шлях, сумісний з OpenAI, тому
|
||||
нативне формування запитів лише для OpenAI, як-от `serviceTier`, Responses `store`,
|
||||
reasoning-сумісні навантаження OpenAI і підказки кешу промптів, не пересилаються.
|
||||
payload сумісності з міркуваннями OpenAI та підказки кешу промптів, не пересилається.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Маршрути на базі Gemini">
|
||||
Посилання OpenRouter на базі Gemini залишаються на шляху proxy-Gemini: OpenClaw зберігає
|
||||
там очищення thought-signature Gemini, але не вмикає нативну валідацію повторного відтворення Gemini
|
||||
або переписування bootstrap.
|
||||
<Accordion title="Маршрути на основі Gemini">
|
||||
Посилання OpenRouter на основі Gemini залишаються на proxy-Gemini шляху: OpenClaw зберігає
|
||||
там очищення сигнатур мислення Gemini, але не вмикає нативну валідацію повторення Gemini
|
||||
або bootstrap-переписування.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Метадані маршрутизації провайдера">
|
||||
Якщо ви передаєте маршрутизацію провайдера OpenRouter у параметрах моделі, OpenClaw пересилає
|
||||
її як метадані маршрутизації OpenRouter до запуску спільних stream-обгорток.
|
||||
її як метадані маршрутизації OpenRouter до запуску спільних обгорток stream.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
@ -211,7 +244,7 @@ OpenRouter під капотом використовує Bearer-токен із
|
||||
<Card title="Вибір моделі" href="/uk/concepts/model-providers" icon="layers">
|
||||
Вибір провайдерів, посилань на моделі та поведінки failover.
|
||||
</Card>
|
||||
<Card title="Довідник конфігурації" href="/uk/gateway/configuration-reference" icon="gear">
|
||||
<Card title="Довідник із конфігурації" href="/uk/gateway/configuration-reference" icon="gear">
|
||||
Повний довідник конфігурації для агентів, моделей і провайдерів.
|
||||
</Card>
|
||||
</CardGroup>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user