# Плагин RouterAI для DeepSeek Harness: вход в один клик, баланс, стоимость сессии, картинки и видео

[DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness "DeepSeek Harness") (`dsh`) — открытый агент-харнес от DeepSeek: чат, рабочие пространства с файлами, инструменты и плагины. Раньше RouterAI подключался к нему вручную, через форму «Custom model API». Теперь есть официальный плагин **RouterAI для DeepSeek Harness** — пакет `@router-ai/dsh-plugin-routerai`.

Плагин добавляет RouterAI как провайдера моделей и берёт на себя всё, что касается денег и ключей: вход в один клик без копирования ключа, баланс в боковой панели, стоимость каждой сессии под полем ввода. Через тот же ключ агент рисует и правит картинки, снимает видео, озвучивает текст и распознаёт речь. Claude, GPT, Gemini, DeepSeek, Qwen и сотни других моделей работают из России без VPN, с оплатой в рублях.

![Агент рисует логотип через RouterAI: картинка появляется в чате, под полем ввода видна стоимость сессии](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/10f6caf745b7086937b1253c66596fdb.gif)

## Что даёт плагин

* **Не нужно копировать ключи.** Нажали «Войти», подтвердили доступ на routerai.ru — ключ сохранился сам. Лимит расходов для него задаётся там же, на странице подтверждения.
* **Деньги на виду.** Остаток на счёте — в боковой панели, стоимость текущей сессии — под полем ввода, с разбивкой по моделям и долей входа из кэша.
* **Защита от неожиданных трат.** Лимит ключа, предупреждение о низком балансе, видео выключено по умолчанию, у ролика есть потолок стоимости.
* **Весь каталог под рукой.** Более 350 чат-моделей с ценами в рублях: поиск, фильтр по производителю, готовые наборы.
* **Не только текст.** Агент рисует и правит картинки, снимает видео, озвучивает текст, а голосовой ввод распознаёт речь — всё через тот же аккаунт.
* **Экономия на мелочах.** Названия сессий и сжатие контекста выполняет недорогая служебная модель, а не основная.

## Требования

* DeepSeek Harness 0.2.x. Как установить и запустить сам harness — в статье [DeepSeek Harness: настройка через RouterAI](/pages/deepseek-harness-routerai#zapusk-dsh "DeepSeek Harness: настройка через RouterAI")
* Аккаунт на [routerai.ru](https://routerai.ru "RouterAI") с положительным балансом. Ключ заранее создавать не нужно — плагин получит его при входе

## Установка

В приложении откройте **Плагины → Добавить плагин** и укажите имя пакета:

```
@router-ai/dsh-plugin-routerai
```

То же самое из терминала:

```bash
dsh plugin --profile desktop add @router-ai/dsh-plugin-routerai
```

`desktop` — профиль настольного приложения. Если вы работаете в другом профиле, подставьте его имя. После установки перезапустите приложение.

## Вход в RouterAI {#vhod}

Откройте **Настройки → RouterAI** и нажмите **Войти через RouterAI**.

![Раздел RouterAI в настройках до входа: кнопка «Войти через RouterAI» и поле «Уже есть ключ?»](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/e1e0002db1a26fc62e21c4328d354ffa.png)

В браузере откроется routerai.ru: выберите аккаунт, при желании задайте лимит расходов и подтвердите доступ. Ключ сохранится в приложении автоматически.

Если ключ уже создан в [личном кабинете](/settings/keys "личном кабинете"), вставьте его в поле «Уже есть ключ?» — выглядит он как `sk-xxxxxxxxxxxxxxxx`.

После входа в разделе появятся баланс, остаток лимита и расход ключа:

![Аккаунт RouterAI в настройках: баланс, лимит ключа, расход и список моделей пикера](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/a8d9d5ad53415d4a2c9717cb9d29684d.png)

## Выбор моделей {#vybor-modeley}

Ниже в том же разделе — каталог RouterAI. Отметьте модели, которые хотите видеть в пикере, расставьте их по порядку стрелками и нажмите **Применить**. Цены указаны в рублях за миллион токенов: вход / выход.

![Каталог RouterAI в настройках: поиск, фильтр по производителю, готовые наборы и цены в рублях](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/7eb72aaa2a8086468fadfa03a9beabb6.png)

Можно начать с готового набора: «На каждый день», «Для кода» или «Экономный». Что в них входит и сколько это стоит на момент написания:

| Модель | Наборы | Вход, ₽ за 1 млн токенов | Выход, ₽ за 1 млн токенов |
| --- | --- | --- | --- |
| `anthropic/claude-sonnet-5.5` | На каждый день | 213,59 | 1 067,97 |
| `anthropic/claude-opus-5.5` | На каждый день, Для кода | 427,19 | 2 135,94 |
| `openai/gpt-6.1-sol` | На каждый день, Для кода | 213,59 | 1 067,97 |
| `google/gemini-4-argon` | На каждый день, Для кода | 213,59 | 1 067,97 |
| `moonshotai/kimi-k3.1-pro` | На каждый день, Для кода | 130,29 | 651,46 |
| `deepseek/deepseek-v4.1-flash` | На каждый день, Экономный | 5,96 | 23,82 |
| `z-ai/glm-5.3-flash` | Все три | 4,69 | 9,21 |

Актуальные цены — в [каталоге моделей](/models "каталоге моделей").

## Проверка подключения

Модели RouterAI появятся в пикере под полем ввода отдельной группой. Выберите любую и отправьте сообщение — если ответ пришёл, а под полем ввода появилась стоимость сессии, всё работает.

![Модели RouterAI в пикере под полем ввода](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/60ac9180ba99fafa0eee40145eab28ec.png)

## Стоимость сессии и баланс

Под полем ввода видно, сколько стоила текущая сессия. По нажатию — подробности: последний запрос, число запросов, токены, доля входа из кэша и разбивка по моделям, включая служебную и модель для картинок.

![Стоимость сессии с разбивкой по моделям](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/26150cea691e112d073ee3b88b24dba1.png)

Стоимость текста — расчёт по числу токенов и ценам каталога; стоимость картинок и видео RouterAI сообщает точно. Итоговые списания всегда можно сверить в личном кабинете.

Остаток на счёте виден в боковой панели. Когда он опускается ниже порога (по умолчанию 100 ₽, меняется в настройках), строка подсвечивается; по нажатию — сводка и кнопка пополнения.

![Баланс RouterAI в боковой панели и остаток лимита ключа](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/9e376c1b0e7ca8a9ffaefb46558e5eb0.png)

Если деньги закончились, ключ упёрся в лимит или был отключён, вместо технической ошибки вы увидите, что именно произошло и что с этим делать — со ссылкой на пополнение или на страницу ключей.

## Картинки, видео и голос

Модели для картинок, видео, озвучки и распознавания речи, служебная модель и порог предупреждения о балансе выбираются в блоке **Дополнительно**. У каждой модели указана цена.

![Блок «Дополнительно»: служебная модель, модели для картинок, видео и распознавания речи](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/da5af4a2fc30c7712c27ec78cc70203e.png)

### Картинки

Попросите агента: «нарисуй логотип для…», «сделай иллюстрацию к статье». Картинка появится в чате и сохранится в папку `routerai-media` проекта — ею сразу можно пользоваться в работе. По умолчанию рисует Seedream 5.5; модель можно сменить, а рисование — выключить, и агент перестанет тратить на него деньги.

![Нарисованный логотип в чате: модель, стоимость и файл в проекте](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/5380feb158fbe9bd6724168a10eb3a6f.png)

Агент умеет и править картинки из проекта: «убери фон у логотипа», «нарисуй в том же стиле баннер», «сделай версию для тёмной темы». Можно задать размер, качество, формат и прозрачный фон — если выбранная модель это поддерживает. По умолчанию рисуется размер 1K, за который указана цена в каталоге; крупнее стоит дороже.

У каждой модели свои возможности — число картинок за запрос, соотношения сторон, формат. Плагин берёт их из каталога RouterAI и сообщает агенту; неподдерживаемое значение заменяется ближайшим допустимым, о чём сказано в результате. Векторные модели сохраняют SVG в файл проекта.

### Видео

«Сними ролик, где…» или «оживи эту картинку» — агент создаст задачу, дождётся результата и сохранит mp4 в `routerai-media`. Картинка из проекта может стать первым кадром: так можно оживить логотип, который агент только что нарисовал.

![Агент оживил логотип: карточка видео с моделью, стоимостью и файлом](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/ce4d3a1cdf54fd2e7e9e1068e76c09a3.png)

Вот что получилось в этом примере — четыре секунды, 9,61 ₽:

![Оживший логотип: пар поднимается над чашкой и огибает маяк](https://b51bc417-3ee0-451a-a83b-8a681d027a96.selstorage.ru/public/00de7260767b725e2a96ec1da0b6cc8f.gif)

Кроме первого кадра можно задать последний — получится плавный переход между двумя картинками, — передать картинки-референсы персонажа или стиля и попросить звуковую дорожку. Агент работает и с готовым роликом из проекта: продлевает его, изменяет или увеличивает разрешение (апскейл). Что из этого доступно, зависит от выбранной модели.

Видео включается выбором модели в настройках: ролик делается несколько минут и стоит заметно дороже картинки. Там же задаётся потолок стоимости одного ролика (по умолчанию 100 ₽) — дороже инструмент снимать не станет и объяснит почему. Стоимость оценивается до запроса по ценам каталога RouterAI: с учётом разрешения, звука, входных картинок и видео.

Длительность, разрешение и соотношение сторон подгоняются под модель: если она не поддерживает запрошенное значение, берётся ближайшее допустимое. Если разрешение не названо, ролик снимается в 720p или ближайшем доступном — цена секунды зависит от разрешения.

### Озвучка текста

«Озвучь этот текст» — агент синтезирует речь и сохранит аудиофайл в `routerai-media`. Модель и голос задаются в настройках; у каждой модели свой набор голосов, он указан на её странице в [каталоге](/models "каталоге"). По умолчанию озвучивает Grok Voice TTS 1.0; озвучку можно выключить.

### Выбор модели под задачу

Одной модели на всё может не хватить: фотореалистичной картинке нужна одна, векторному логотипу — другая. В настройках под моделью для картинок и для видео можно добавить ещё несколько, до восьми, — агент увидит, чем они отличаются по цене и возможностям, и возьмёт подходящую. Без этого списка он всегда работает основной моделью.

### Голосовой ввод

RouterAI работает как служба распознавания речи для голосового ввода DeepSeek Harness. Голосовой ввод — отдельный экспериментальный пакет harness: установите `@deepseek-ai/dsh-experimental-voice-input-bundle` и выберите службу **RouterAI**. Модель распознавания задаётся в настройках плагина.

### Служебная модель

Названия сессий и сжатие длинного контекста harness по умолчанию поручает той же модели, что ведёт разговор. Плагин переводит эти запросы на недорогую модель (по умолчанию DeepSeek V4.1 Flash) — на качество ответов это не влияет. Модель можно сменить или отключить подмену.

## Команда /routerai

Те же действия доступны из чата:

| Команда | Что делает |
| --- | --- |
| `/routerai login` | вход через routerai.ru |
| `/routerai key sk-…` | сохранить готовый ключ |
| `/routerai logout` | удалить сохранённый ключ |
| `/routerai status` | баланс аккаунта и состояние ключа |
| `/routerai models` | модели пикера с ценами |
| `/routerai find <текст>` | поиск по каталогу RouterAI |

## Настройка без интерфейса

Ключ можно передать переменной окружения `ROUTERAI_API_KEY` или записать в `.env`. Параметры плагина задаются в файле профиля `~/.dsh/profiles/<профиль>/cordis.patch.yml`:

```yaml
- id: llm-routerai
  config:
    models:
      - anthropic/claude-sonnet-5.5
      - deepseek/deepseek-v4.1-flash
```

| Параметр | По умолчанию | Назначение |
| --- | --- | --- |
| `models` | набор «На каждый день» | модели пикера по порядку; выбор в настройках приложения важнее |
| `apiKeyEnv` | `ROUTERAI_API_KEY` | имя, под которым хранится ключ |
| `baseURL` | `https://routerai.ru/api/v1` | адрес API |
| `catalogRefreshHours` | `4` | как часто обновлять каталог и цены |

Идентификаторы моделей — как в [каталоге RouterAI](/models "каталоге RouterAI"): `производитель/модель`.

## Решение проблем

### В настройках нет раздела RouterAI

Перезапустите приложение после установки плагина. Проверьте версию harness: плагин рассчитан на DeepSeek Harness 0.2.x.

### Модели нет в пикере

В пикер попадают только модели, отмеченные в каталоге. Откройте **Настройки → RouterAI**, найдите модель поиском, отметьте её и нажмите **Применить**.

### Сообщение о нехватке средств или лимите ключа

Пополните баланс в разделе [Биллинг](/settings/billing "Биллинг"). Если упёрлись в лимит ключа — поднимите его на [странице ключей](/settings/keys "странице ключей") или войдите заново и задайте новый лимит.

### Агент не снимает видео

Видео выключено, пока в блоке **Дополнительно** не выбрана модель. Если модель выбрана, а агент отказывается — ролик по оценке выходит дороже заданного потолка стоимости: поднимите потолок, попросите ролик короче или в меньшем разрешении.

### В голосовом вводе нет службы RouterAI

Установите пакет `@deepseek-ai/dsh-experimental-voice-input-bundle` и перезапустите приложение — после этого RouterAI появится в списке служб распознавания.

## Что дальше

* [Каталог моделей](/models "Каталог моделей") — все модели и цены
* [DeepSeek Harness: настройка через RouterAI](/pages/deepseek-harness-routerai "DeepSeek Harness: настройка через RouterAI") — ручное подключение через Custom model API и плагин dsh-image-gen
* [router-ai/dsh-plugin-routerai](https://github.com/router-ai/dsh-plugin-routerai "Плагин RouterAI для DeepSeek Harness") — исходники плагина, история изменений и задачи; вопросы можно задать и по почте [support@routerai.ru](mailto:support@routerai.ru)
* [Codex](/pages/vibe-coding-codex "Вайб-кодинг в Codex") и [Claude Code](/pages/vibe-coding-claude-code "Вайб-кодинг в Claude Code") — другие агенты через RouterAI

Статья описывает плагин версии 0.7.0 для DeepSeek Harness 0.2.x.