Подключение к API
Base URL, ключ, модель и типовые ошибки подключения.
Что такое Base URL
Base URL – адрес сервера, который принимает запросы к модели. Мира добавляет к нему путь конкретного метода, например /chat/completions.
- Указывайте адрес так, как его даёт поставщик:
https://api.example.ru/v1. - Если у сервера есть префикс пути (
https://gw.company.ru/llm/v1), он сохраняется – Мира не добавляет/v1повторно. - Адрес должен начинаться с
https://. Логин и пароль внутри адреса не допускаются.
Ключ API
Ключ вводится в поле «Ключ API» и хранится в защищённом хранилище Windows. На экране он показывается скрытым. В журналы и отчёты об ошибках ключ не попадает.
Модель
Идентификатор модели вводится вручную – так, как он указан у поставщика. Если сервер отдаёт список моделей, Мира предложит выбрать из него.
Проверка подключения
Кнопка «Проверить подключение» сначала запрашивает список моделей, а если сервер его не поддерживает – отправляет минимальный запрос к модели. Такой запрос может быть платным по тарифу поставщика.
Типовые ошибки
| Сообщение | Что значит | Что делать |
|---|---|---|
| Сервер не найден | Ошибка в адресе или DNS | Проверьте Base URL |
| Ошибка защищённого соединения | Проблема с сертификатом сервера | Проверьте адрес; обратитесь к администратору сервера |
| Сервер не ответил вовремя | Тайм-аут | Повторите позже, проверьте интернет |
| 401 / 403 | Ключ неверный или без доступа | Проверьте ключ |
| 402 | Закончились средства на балансе | Пополните баланс у поставщика |
| 429 | Превышен лимит запросов | Подождите или проверьте лимиты |
| 5xx | Ошибка на стороне сервера | Повторите позже |
Несколько подключений
В разделе «Подключение к модели» можно сохранить несколько серверов и выбрать активный. Новое подключение действует со следующего запроса; ответ, который уже генерируется, не прерывается.