Ask OpenRouter (Спросить у OpenRouter)

• Автор: Abdel.

Это дополнение для NVDA позволяет взаимодействовать с моделями искусственного интеллекта, предоставляемыми платформой OpenRouter, непосредственно с помощью скринридера.

Дополнение поддерживает:
* Автоматический случайный выбор бесплатных моделей.
* Ручной выбор любой доступной модели (включая платные).

Основные возможности

• Быстрый доступ: открывайте интерфейс чата в любой момент с помощью глобальной комбинации клавиш.
• Управление беседой: начните новый разговор или продолжите предыдущий.
• Умная ротация бесплатных моделей: автоматически выбирает случайную бесплатную модель для оптимального распределения дневных квот.
• Ручной выбор модели: выберите конкретную модель (включая платные) на панели настроек.
• Доступные результаты: просматривайте ответы в понятном, удобном для навигации окне с возможностью отображения полной истории.

Настройка: получение и установка вашего API-ключа

Чтобы использовать это дополнение, вам необходимо иметь API-ключ OpenRouter.

Даже при использовании бесплатных моделей ключ требуется для идентификации ваших запросов.

1. Как получить API-ключ

1. Перейдите на сайт OpenRouter.ai.
2. Создайте учётную запись, нажав «Sign up» (вы можете войти с помощью учётной записи GitHub, Google или MetaMask, либо по адресу электронной почты).
3. После входа в систему перейдите в раздел «Keys» на панели управления или напрямую по ссылке: https://openrouter.ai/keys
4. Нажмите кнопку «Create Key».
5. Дайте ключу имя (например: «Мой API-ключ OpenRouter») и нажмите «Create».
6. Важно: ключ будет отображён только один раз. Скопируйте его немедленно и сохраните в надёжном месте.

2. Настройка ключа в NVDA

1. Откройте меню NVDA (NVDA + N).
2. Перейдите в Параметры, затем Настройки.
3. В списке категорий выберите «Ask OpenRouter».
4. Вставьте ваш API-ключ в поле «API-ключ OpenRouter».
5. Нажмите OK для сохранения.

Показать API-ключ

На панели настроек NVDA, сразу после поля «API-ключ OpenRouter», находится флажок с надписью:

«Показывать API-ключ»

Если он отмечен, символы API-ключа становятся видимыми.
По умолчанию они скрыты из соображений безопасности.

Настройки выбора модели

В категории настроек Ask OpenRouter вы найдёте новую опцию:

«Использовать все модели, включая платные»

Эта опция управляет тем, как выбираются модели.

Когда опция НЕ ОТМЕЧЕНА (поведение по умолчанию)

• Дополнение автоматически выбирает случайную бесплатную модель для каждого нового разговора.
• Оно переключается между доступными бесплатными моделями.
• Это помогает распределять нагрузку и избегать ограничений на количество запросов.

Когда опция ОТМЕЧЕНА

Когда эта опция включена, список доступных моделей автоматически появляется после флажка.

• Список отсортирован в порядке возрастания цены токенов запроса (стоимость за входной токен), от наименьшей к наибольшей.
• Отображаются только непомеченные как устаревшие модели с действительными провайдерами.

Что можно делать, когда эта опция включена?

• Выбирать любую доступную модель.
• Использовать платные модели (если у вас достаточно кредитов OpenRouter).
• Выбирать модель, которая наилучшим образом соответствует вашим потребностям.
• Продолжать использовать ту же выбранную модель для ваших бесед (автоматическая ротация не производится).

Что такое токен запроса?

Токен запроса представляет собой небольшую единицу текста, отправляемую модели (ваш вопрос или ввод).

Модели обычно тарифицируются отдельно за:
* Входные токены (запрос)
* Выходные токены (ответ)

Как использовать

Открытие диалога чата

Нажмите:

Ctrl + Alt + A

Вы можете изменить эту комбинацию в:
Меню NVDA → Параметры → Жесты ввода → Ask OpenRouter

Основной интерфейс

Диалоговое окно содержит три кнопки:

1. Новый чат – начинает совершенно новый разговор.
2. Продолжить чат – возобновляет предыдущий разговор (сохраняет историю).
3. Закрыть – закрывает диалог (также работает клавиша Escape).

Ввод вашего запроса

После выбора «Новый чат» или «Продолжить чат»:

• Появляется многострочное текстовое поле.
• Нажатие Enter вставляет новую строку.
• Чтобы отправить ваше сообщение:
  • Нажмите Tab, чтобы перейти к кнопке OK.
  • Нажмите Enter.

Чтение ответа

После обработки появляется окно с результатами, содержащее:

• «Вы сказали:» с последующим вашим сообщением.
• «Модель ответила:» с последующим ответом.
• Кнопка «Копировать» для копирования ответа.

Если включено отображение полной истории, каждый обмен сообщениями четко разделен заголовками, что позволяет легко перемещаться по ним с помощью клавиш быстрой навигации NVDA.

Параметры отображения

Если вы предпочитаете отображать только последний ответ вместо полной истории разговора:

1. Откройте меню NVDA (NVDA + N).
2. Перейдите в Параметры → Настройки.
3. Выберите Ask OpenRouter.
4. Снимите флажок:
   «Отображать полную историю чата для непрерывных обсуждений».
5. Нажмите OK.

Неназначенные скрипты

Следующие скрипты не имеют назначенных жестов.
Вы можете определить их в:

Параметры → Жесты ввода → Ask OpenRouter

Доступные скрипты:

• Открыть панель настроек дополнения.
• Начать новый чат напрямую.
• Продолжить существующий чат напрямую.

Бесплатные модели, платные модели и квоты

Использование бесплатных моделей

Когда «Использовать все модели, включая платные» не отмечено:

• Используются только модели, помеченные как бесплатные на OpenRouter.
• Бесплатные модели имеют:
  • Ограниченные дневные квоты.
  • Общие ограничения на количество запросов.
  • Возможную временную недоступность.

Дополнение автоматически переключается между бесплатными моделями для улучшения доступности.

Использование платных моделей

Когда «Использовать все модели, включая платные» отмечено:

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

Ошибки, такие как:
* 402 (недостаточно кредитов).
* 429 (превышен лимит запросов).
* 404 (модель не разрешена настройками конфиденциальности).

отображаются непосредственно для информирования вас о проблеме.

Напоминание о настройках конфиденциальности

Если вы используете бесплатные модели и получаете сообщение об ошибке:

«No endpoints found matching your data policy»

Возможно, вам потребуется настроить параметры конфиденциальности OpenRouter:

https://openrouter.ai/settings/privacy

Убедитесь, что разрешены публичные/бесплатные конечные точки моделей.

Совместимость

• Это дополнение совместимо с версиями NVDA от 2025.1 и выше.

Изменения в версии 20260221.0.0

• Добавлен ручной выбор любой доступной модели на панели настроек.
• Добавлена возможность использования платных моделей.

Изменения в версии 20260217.0.0

• Начальная версия