Подключение к провайдеру ИИ

Для чата приложению Marinara Engine нужна модель ИИ. Можно добавить аккаунт сервиса ИИ, вставить его ключ API и выбрать модель. Ключ API – это секретный код от сервиса, который позволяет Marinara пользоваться вашим аккаунтом в этом сервисе. Обращайтесь с ним как с паролем. Можно также использовать встроенную модель – небольшую модель, которая работает на вашем компьютере без ключа.

Добавление аккаунта

Перед началом получите ключ API у сервиса, которым хотите пользоваться. В окне Add account (добавить аккаунт) для каждого сервиса есть ссылка Where do I find my key? (где найти ключ). Вот страницы, которые она открывает для популярных сервисов.

• OpenRouter (есть бесплатные модели): openrouter.ai/keys
• NanoGPT: nano-gpt.com/api
• OpenAI: platform.openai.com/api-keys
• Anthropic: console.anthropic.com/settings/keys
• Google Gemini: aistudio.google.com/apikey

Большинство сервисов просят зарегистрироваться, а некоторые – пополнить баланс, прежде чем ключ заработает. Другие сервисы описаны в руководстве Поддерживаемые провайдеры ИИ. Чтобы использовать модель на своем компьютере без ключа, см. Настройка встроенной модели.

1. Нажмите Connections (подключения) на верхней панели. Справа откроется панель. Если аккаунтов у вас еще нет, она спрашивает Where do your models come from? (откуда берутся ваши модели) и показывает несколько сервисов. Нажмите на сервис, только не на Built-in model (встроенная модель). Окно Add account откроется сразу на шаге ключа. Переходите к шагу 4.
2. Нажмите Add (добавить). Откроется окно Add account.
3. Нажмите на нужный сервис. Чтобы найти его, начните вводить название в поле Search providers (искать провайдеров). В списке есть разделы Chat (чат), Images & video (изображения и видео), Voice (голос) и Decisions (решения). Обычную модель для чата ищите в разделе Chat.
4. Нажмите на поле API key (ключ API) и вставьте ключ. Нажмите кнопку с глазом, чтобы проверить, что ключ вставлен целиком.
5. Нажмите Connect (подключиться). Marinara проверяет ключ. Если он работает, вы увидите Connected и число найденных моделей.
6. Что будет дальше, зависит от того, есть ли у вас уже основная модель. Main – это задача написания ответов в ваших чатах.

• Основной модели еще нет или вы открыли Add из нового чата: окно показывает модели сервиса. Модели с пометкой Recommended (рекомендуется) стоят вверху. Нажмите на модель, чтобы добавить ее, или введите название в поле Search or enter model ID… (искать или ввести идентификатор модели). Если не знаете, что выбрать, возьмите модель с пометкой Recommended. Позже ее можно сменить. Оставьте отмеченным Make … my Main model (сделать … моей основной моделью). Этот флажок показывается, только когда основной модели нет. Если вы открыли Add из нового чата, а основная модель уже есть, вместо него появляется кнопка Set … as Main (назначить … основной моделью). Затем нажмите Done (готово) или, в новом чате, Start chatting (начать чат).
• Основная модель уже есть: окно закрывается, а сообщение говорит, что аккаунт добавлен, и называет число его моделей. Чтобы добавить еще модели, нажмите ⋯ у аккаунта и выберите Add model (добавить модель).

Панель показывает ваш аккаунт. Надпись Connected на шаге 5 уже означает, что ключ работает. Если новая модель стала основной, начните чат и отправьте сообщение: если пришел ответ, все работает. Если основная модель у вас уже была, новые чаты по-прежнему используют ее. Чтобы пользоваться новым аккаунтом, добавьте в него модель (⋯ → Add model), затем выберите эту модель для чата или задачи (см. Выбор модели для каждой задачи).

Если не получилось:

• The key was not accepted. Check that you copied all of it. Вставьте ключ еще раз и нажмите Try again (попробовать снова). Ключ должен быть от того сервиса, который вы выбрали.
• The service is busy, or your credit is used up. Пополните баланс на сайте сервиса или подождите и попробуйте снова.
• Сообщение Marinara could not reach с названием сервиса означает, что Marinara не удалось связаться с сервисом. Проверьте подключение к интернету, затем нажмите Try again.

Необязательные поля аккаунта

На шаге ключа есть еще такие поля. Если они вам не нужны, оставьте их пустыми.

• Name (optional) (название, необязательно): название, которое показывается в панели. Если поле пустое, используется название сервиса. Второй аккаунт того же сервиса получает последние 4 символа своего ключа, например OpenAI · …a1b2.
• Address (адрес): куда Marinara отправляет запросы. Если поле пустое, Marinara использует собственный адрес сервиса. Заполняйте его только для прокси, шлюза или сервера, который вы запускаете сами. У сервисов со входом на вашем компьютере этого поля нет.
• Requests per minute (запросов в минуту): замедляет работу Marinara с этим аккаунтом. Пустое поле означает, что ограничения нет. Допустимые значения – от 1 до 600.
• Parallel jobs (параллельные задачи): сколько запросов выполняется одновременно. Пустое поле означает, что ограничения нет. Допустимые значения – от 1 до 16. В окне Edit account (изменить аккаунт) та же настройка называется Parallel requests (параллельные запросы).

Некоторые сервисы вместо ключа используют вход на вашем компьютере. У них есть пометка Sign in (вход), а поля для ключа нет. См. Подключения по подписке Claude, ChatGPT и Grok. О сервере на вашем компьютере читайте в руководстве Подключение локальной модели или модели на своем сервере. После неудачной проверки появляется кнопка Continue anyway (все равно продолжить). Она сохраняет аккаунт без пройденной проверки.

Как начать чат без аккаунта

Если вы начинаете чат, когда модели еще нет, Marinara сначала открывает окно Add account. После Connect нажмите на модель, затем нажмите Start chatting.

Панель Connections

Аккаунтами вы управляете в панели Connections. Сверху вниз в ней расположены:

• Поле поиска, которое фильтрует список по мере ввода. Оно подписано Search models and accounts (искать модели и аккаунты).
• Кнопка Add, которая открывает окно Add account, и меню More actions (другие действия; три точки) с пунктами Import account (импортировать аккаунт), Export all accounts (экспортировать все аккаунты), сворачиванием и группировкой. В широкой панели раскрывающийся список сортировки стоит рядом с поиском. В узкой панели сортировка находится в меню More actions.
• Блок Jobs (задачи). Он показывает, какая модель выполняет каждую задачу.
• Карточка Built-in model. См. Настройка встроенной модели.
• Ваши аккаунты, под каждым – его сохраненные модели. См. Порядок в подключениях.

Аккаунт – это один сохраненный ключ, вход или адрес для одного сервиса. Если у вас два ключа от одного сервиса, значит, у вас два аккаунта. Модель – это одна модель ИИ, которую вы сохранили из аккаунта. Каждая сохраненная модель хранит собственные настройки.

Выбор модели для каждой задачи

Задача – это то, что модель делает для вас. Блок Jobs перечисляет задачи в четырех группах:

В каждой строке видна модель, которая выполняет задачу, или то, что задача делает без модели, например Follows Main (следует за основной моделью) или Off (выключено). Для задачи, которой нужна модель, показано Choose a model (выбрать модель). Нажмите Jobs, чтобы свернуть блок.

Чтобы сменить модель для задачи, нажмите на ее строку. Откроется окно Model for (модель для) этой задачи. Исключений три. Decision и Embeddings открывают собственные элементы управления (см. Модели решений и Поддерживаемые провайдеры ИИ). Dictation (Speech to Text) открывает настройку распознавания речи.

В окне Model for:

1. Просмотрите список.
2. Нажмите на модель. Список показывает ее в разделе Now (сейчас), затем ваши модели из раздела Starred (отмеченные звездочкой), затем сохраненные модели по аккаунтам. Пункт All models (все модели) под аккаунтом открывает его полный список. Введите текст в поле Search all models or paste a model ID (искать по всем моделям или вставить идентификатор модели), чтобы искать сразу по всем аккаунтам. Сохранять модель заранее не нужно.

Пункт If it fails (если не сработает) вверху окна выбирает вторую модель, которая отвечает, когда первая дает сбой. Кнопка Add account внизу открывает окно добавления аккаунта.

Когда функции нужна модель

Функция, которая не может работать без модели определенного вида, показывает пометку Needs an image model (или такую же пометку для видео, аудио, решений или чата). Она видна на карточке агента в панели Agents, в панели Chat Settings (настройки чата), в редакторе агента и в окнах изображений и видео. Нажмите Set up (настроить) рядом с ней, затем выберите модель или нажмите Add account. Пометка исчезает, как только у задачи появляется модель.

Проверка аккаунта

Кнопка Connect уже проверяет ключ. Чтобы проверить еще раз позже, откройте меню ⋯ аккаунта в панели и нажмите Test (проверить). В редакторе аккаунта (Edit account) есть кнопка Test account (проверить аккаунт): она проверяет ключ и адрес в том виде, в каком вы их ввели, еще до сохранения.

Выбор модели для одного чата

Новый чат использует вашу модель Main. Чтобы задать одному чату другую модель, нажмите кнопку модели в поле ввода чата (значок ссылки с названием текущей модели) или воспользуйтесь полем Model (модель) в Chat Settings → Connection. И то и другое открывает окно Model for this chat (модель для этого чата):

• Now показывает модель, которую использует чат. This chat only означает, что у чата свой выбор. follows Main означает, что чат использует Main.
• Recent (недавние) и Starred показывают ваши модели по аккаунтам.
• Поле Search models or paste an ID… (искать модели или вставить идентификатор) ищет по всем аккаунтам. Browse (обзор) открывает полный список одного аккаунта.
• Follow Main (следовать за основной моделью) сбрасывает собственный выбор чата. Shuffle (перемешивание) каждый раз выбирает другую модель.

Выбор меняет модель только в этом чате. Сообщение после выбора предлагает Make it my Main model (сделать ее моей основной моделью) и Undo (отменить). В режиме Game Mode поле подписано Game Master model (модель ведущего игры).

Частые ошибки

Если проверка или сообщение не проходит, сначала проверьте вот что:

• Неверный или истекший ключ. Нажмите ⋯ у аккаунта, выберите Replace key (заменить ключ) и вставьте ключ заново. Аккаунт без ключа помечен Needs key.
• Выключенный аккаунт. Он помечен Off. Нажмите Turn on (включить) в его меню ⋯.
• Ключ от другого сервиса. Каждому сервису нужен свой ключ.
• Заблокированный адрес в поле Address. Пустое поле означает собственный адрес сервиса.

Другие способы устранить ошибки собраны в руководстве Устранение неполадок в приложении Marinara Engine.

Смежные руководства

• Порядок в подключениях
• Поддерживаемые провайдеры ИИ
• Подключения по подписке Claude, ChatGPT и Grok
• Подключение локальной модели или модели на своем сервере