chore(i18n): refresh uk translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
c634943daf
commit
ad1b87f5df
@ -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-адреси.
|
||||
|
||||
## Початок роботи
|
||||
|
||||
<Steps>
|
||||
<Step title="Отримайте свій API-ключ">
|
||||
Створіть API-ключ на [openrouter.ai/keys](https://openrouter.ai/keys).
|
||||
<Step title="Отримайте свій ключ API">
|
||||
Створіть ключ API на [openrouter.ai/keys](https://openrouter.ai/keys).
|
||||
</Step>
|
||||
<Step title="Запустіть початкове налаштування">
|
||||
<Step title="Запустіть onboarding">
|
||||
```bash
|
||||
openclaw onboard --auth-choice openrouter-api-key
|
||||
```
|
||||
</Step>
|
||||
<Step title="(Необов’язково) Перейдіть на конкретну модель">
|
||||
За замовчуванням під час початкового налаштування використовується `openrouter/auto`. Пізніше виберіть конкретну модель:
|
||||
Onboarding за замовчуванням використовує `openrouter/auto`. Виберіть конкретну модель пізніше:
|
||||
|
||||
```bash
|
||||
openclaw models set openrouter/<provider>/<model>
|
||||
@ -59,16 +59,16 @@ OpenRouter надає **уніфікований API**, який маршрут
|
||||
доступних провайдерів і моделей див. у [/concepts/model-providers](/uk/concepts/model-providers).
|
||||
</Note>
|
||||
|
||||
Приклади вбудованих резервних варіантів:
|
||||
Вбудовані приклади 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` |
|
||||
|
||||
<Warning>
|
||||
Якщо ви перенаправите провайдера OpenRouter на інший proxy або базову URL-адресу, OpenClaw
|
||||
**не** вставлятиме ці специфічні для OpenRouter заголовки чи маркери кешу Anthropic.
|
||||
Якщо ви перенаправите провайдер OpenRouter на інший проксі або базову URL-адресу, OpenClaw
|
||||
**не** вставлятиме ці специфічні для OpenRouter заголовки або маркери кешу Anthropic.
|
||||
</Warning>
|
||||
|
||||
## Розширена конфігурація
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Кешування відповідей">
|
||||
Кешування відповідей 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 проксі.
|
||||
|
||||
</Accordion>
|
||||
|
||||
@ -199,42 +199,42 @@ OpenRouter використовує Bearer-токен із вашим API-клю
|
||||
кращого повторного використання кешу промптів у блоках системних/розробницьких промптів.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Попереднє заповнення міркувань Anthropic">
|
||||
На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненими міркуваннями
|
||||
відкидають кінцеві ходи попереднього заповнення асистента до того, як запит потрапить до OpenRouter,
|
||||
відповідно до вимоги Anthropic, що розмови з міркуваннями мають завершуватися ходом користувача.
|
||||
<Accordion title="Попереднє заповнення міркування Anthropic">
|
||||
На перевірених маршрутах OpenRouter посилання на моделі Anthropic з увімкненим міркуванням
|
||||
відкидають кінцеві ходи попереднього заповнення асистента до того, як запит досягне OpenRouter,
|
||||
відповідно до вимоги Anthropic, щоб розмови з міркуванням завершувалися ходом користувача.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Вставлення мислення / міркувань">
|
||||
На підтримуваних маршрутах, відмінних від `auto`, OpenClaw зіставляє вибраний рівень мислення з
|
||||
payload міркувань proxy OpenRouter. Непідтримувані підказки моделі та
|
||||
`openrouter/auto` пропускають це вставлення міркувань. Hunter Alpha також пропускає
|
||||
proxy-міркування для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг
|
||||
повертати текст фінальної відповіді в полях міркувань для цього вилученого маршруту.
|
||||
<Accordion title="Ін’єкція thinking / reasoning">
|
||||
На підтримуваних не-`auto` маршрутах OpenClaw зіставляє вибраний рівень thinking із
|
||||
payloads reasoning проксі OpenRouter. Непідтримувані підказки моделей і
|
||||
`openrouter/auto` пропускають цю ін’єкцію reasoning. Hunter Alpha також пропускає
|
||||
reasoning проксі для застарілих налаштованих посилань на моделі, оскільки OpenRouter міг
|
||||
повертати текст остаточної відповіді в полях reasoning для цього вилученого маршруту.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Повторення міркувань DeepSeek V4">
|
||||
<Accordion title="Повтор reasoning DeepSeek V4">
|
||||
На перевірених маршрутах OpenRouter `openrouter/deepseek/deepseek-v4-flash` і
|
||||
`openrouter/deepseek/deepseek-v4-pro` заповнюють відсутній `reasoning_content` у
|
||||
повторених ходах асистента, щоб розмови з мисленням/інструментами зберігали потрібну для DeepSeek V4
|
||||
повторно відтворених ходах асистента, щоб розмови thinking/tool зберігали потрібну для DeepSeek V4
|
||||
форму продовження.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Формування запитів лише для OpenAI">
|
||||
OpenRouter усе ще проходить через proxy-style шлях, сумісний з OpenAI, тому
|
||||
OpenRouter усе ще проходить шлях OpenAI-сумісного проксі-стилю, тому
|
||||
нативне формування запитів лише для OpenAI, як-от `serviceTier`, Responses `store`,
|
||||
payload сумісності з міркуваннями OpenAI та підказки кешу промптів, не пересилається.
|
||||
payloads сумісності reasoning OpenAI і підказки кешу промптів, не пересилається.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Маршрути на основі Gemini">
|
||||
Посилання OpenRouter на основі Gemini залишаються на proxy-Gemini шляху: OpenClaw зберігає
|
||||
там очищення сигнатур мислення Gemini, але не вмикає нативну валідацію повторення Gemini
|
||||
<Accordion title="Маршрути на базі Gemini">
|
||||
Посилання OpenRouter на базі Gemini залишаються на proxy-Gemini шляху: OpenClaw зберігає
|
||||
очищення thought-signature Gemini там, але не вмикає нативну валідацію повтору Gemini
|
||||
або bootstrap-переписування.
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Метадані маршрутизації провайдера">
|
||||
Якщо ви передаєте маршрутизацію провайдера OpenRouter у параметрах моделі, OpenClaw пересилає
|
||||
її як метадані маршрутизації OpenRouter до запуску спільних обгорток stream.
|
||||
її як метадані маршрутизації OpenRouter до запуску спільних обгорток потоку.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
@ -244,7 +244,7 @@ OpenRouter використовує Bearer-токен із вашим API-клю
|
||||
<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