Подключение провайдера моделей
Укажите тип API, endpoint, API-ключ и ID модели, узнайте, как Yenpo строит URL запроса, и устраните типичные ошибки подключения.
AI Reader использует провайдера, выбранного в настройках. Аккаунт провайдера определяет доступные модели и стоимость. Для чтения и поиска файлов это подключение не нужно.
Добавьте провайдера
Откройте Настройки → Модели, нажмите Добавить провайдера (кнопка плюса) и выберите новую запись в поле Текущий провайдер. Дайте понятное имя, например «Шлюз команды». Имя служит только меткой и не влияет на выбор API.
Затем заполните:
| Поле | Что указать |
|---|---|
| Тип API | Протокол сервиса: OpenAI Chat Completions, OpenAI Responses или Anthropic Messages |
| Endpoint | URL сервиса, включая префикс пути, необходимый шлюзу |
| Аутентификация / Ключ API | API-ключ или вариант входа, предлагаемый провайдером |
| Модель | Точный ID модели, доступной вашему аккаунту |
Вводите API-ключи только в настройках, никогда в чате или файле проекта. Некоторые провайдеры предлагают вход в аккаунт вместо ключа; выберите его в поле Способ входа, если он доступен.
Согласуйте endpoint с типом API
Имя модели не определяет протокол: один шлюз может предоставлять похожие имена через разные API. Следуйте документации API сервиса и сохраняйте нужный префикс пути.
Эти URL показывают, как Yenpo строит URL запроса. Это примеры, а не работающие сервисы:
| Тип API | Пример поля endpoint | Итоговый URL запроса |
|---|---|---|
| Chat Completions | https://gateway.example/v1 |
https://gateway.example/v1/chat/completions |
| Responses | https://gateway.example |
https://gateway.example/v1/responses |
| Messages | https://gateway.example |
https://gateway.example/v1/messages |
Если endpoint уже заканчивается на /chat/completions, /responses или /messages, Yenpo использует его как есть для соответствующего типа API. Для Responses и Messages к endpoint с окончанием /v1 добавляется последний сегмент. Chat Completions всегда добавляет /chat/completions к введённому адресу и не дополняет отсутствующий /v1.
При ошибке не переключайте типы API наугад. Выясните поддерживаемый протокол и полный ожидаемый путь запроса.
ID модели
Введите ID в поле Модель или нажмите Получить список, если сервис публикует список моделей. Получение списка и вызов модели — разные запросы; модель может работать при сбое получения списка. Попробуйте ввести ID из документации напрямую.
Длина контекста влияет на бюджеты входа и выхода Yenpo, момент сжатия чата и объём сохраняемого контекста. Укажите лимит модели из документации; пустое поле использует значение Yenpo по умолчанию. Слишком малое значение вызывает лишнее сжатие, слишком большое — запросы, которые модель отклоняет.
Цены используются для оценки стоимости в подробностях запуска. Укажите тарифы провайдера; эти значения не меняют фактические платежи и не дают доступ к модели. Пока настраиваете первое подключение, не меняйте остальные параметры модели.
Ввод изображений по умолчанию отключён для каждого провайдера. Включайте Принимать изображения, только если модель и API поддерживают нужные изображения.
Проверьте небольшим вопросом
Откройте небольшой файл, который разрешено отправлять этому сервису, и спросите:
Что возвращает функция при пустом вводе? Укажи соответствующую ветку.
Если ответ пришёл, подключение работает. Правильность ответа — отдельный вопрос; проверьте его по коду.
Запрос включает сообщение и нужный код, найденный AI Reader в проекте, а не только набранный текст. Прочитайте Данные, разрешение на правки и терминал перед отправкой конфиденциального кода на удалённый endpoint.
Если запрос не удался
| Симптом | Что проверить |
|---|---|
| Ошибка аутентификации или доступа | Выбранный аккаунт или ключ, владелец endpoint, доступ к модели |
| Не найдено или API не поддерживается | Тип API и полный путь запроса, включая префиксы шлюза |
| Модель не найдена | Точный ID модели и доступность для аккаунта |
| Сбой получения моделей | Публикует ли сервис список; введите ID из документации напрямую |
| Тайм-аут или прерывание потока | Доступ к сети, поведение прокси или шлюза, доступность провайдера |
Один HTTP-статус редко объясняет причину, а шлюзы могут переписывать ошибки вышестоящего сервиса. При сообщении о проблеме укажите текст ошибки, тип API и endpoint без частных данных. Никогда не добавляйте API-ключ.
Если запуск с разрешёнными правками прерван, проверьте рабочее дерево перед повтором. Файлы могли измениться, даже если финальный ответ не пришёл.