PandaNpc хранит подключения провайдеров и записи моделей, которые вы настраиваете. Начните с API-ключа, базового URL, протокола и идентификатора модели, предоставленных вашим сервисом. Добавление записи не создает учетную запись вышестоящего сервиса и не предоставляет доступ к модели.
О различии между провайдером и моделью читайте в Управление собственным списком моделей.
Перед началом работы
Уточните у своего провайдера или самостоятельно размещенного сервиса следующее:
- Базовый адрес API, а не адрес веб-сайта провайдера.
- Метод аутентификации и любые необходимые учетные данные.
- Протокол API, поддерживаемый функцией или движком, который вы собираетесь использовать.
- Точный идентификатор модели, который может вызывать ваша учетная запись.
- Ограничения по контексту и выводу, если вы планируете вводить их вручную.
Храните учетные данные в форме провайдера, а не в подсказках, скриншотах или общих заметках. Сервис, рекламируемый как совместимый с OpenAI, может отличаться в потоковой передаче, вызовах инструментов или поддержке изображений.
1. Добавление или настройка провайдера
Откройте Конфигурация моделей. Добавьте провайдера, настройте существующий пресет или скопируйте пресет, если вам нужно независимо редактируемое подключение.
| Поле | Что вводить |
|---|---|
| Отображаемое имя | Узнаваемое имя для этого подключения |
| Идентификатор провайдера | Идентификатор конфигурации провайдера |
| API-ключ | Учетные данные, требуемые вашим сервисом |
| Базовый URL | Базовый адрес API, ожидаемый выбранной интеграцией |
| Протокол | Формат, который фактически реализует вышестоящий API |
| Секрет, Организация, Проект | Только значения, явно требуемые вашим сервисом |
| Поддержка массива содержимого | Принимает ли сервис структурированное содержимое сообщений |
Форма базового URL зависит от протокола и функции, выполняющей запросы. Не добавляйте полный путь операции, если интеграция уже добавляет его. Например, интеграция, которая добавляет /chat/completions, требует соответствующий базовый адрес, а не адрес, уже заканчивающийся этим путем. Не применяйте этот пример к каждому протоколу.
При редактировании сохраненных учетных данных, оставление поля API-ключ или Секрет пустым сохраняет настроенное значение. Замаскированное значение, показанное в списке, не является исходным ключом, и его не следует вставлять обратно как замену.
2. Добавление модели
Сохраните провайдера, выберите его и нажмите Добавить модель.
| Поле | Значение |
|---|---|
| Отображаемое имя | Ваша метка в списке моделей |
| Значение модели | Точный идентификатор вышестоящей модели |
| Тип модели | Применимая категория в форме конфигурации |
| Провайдер | Подключение, которое использует эта запись |
| Контекстное окно | Документированная емкость контекста, если указано |
| Максимальное количество токенов | Лимит вывода, если указан |
Используйте идентификатор из документации сервиса или списка моделей. Маркетинговое название не обязательно является идентификатором API. Оставьте необязательные лимиты неустановленными, если вы не можете их проверить; неустановленное значение не означает, что реальные лимиты были обнаружены. Использующая функция может применять свои значения по умолчанию.
3. Проверка конфигурации
В функции или движке, использующем эти настройки:
- Выберите новую запись и начните тестовый разговор.
- Отправьте короткий запрос, например
Ответь: connected. - Подтвердите нормальный ответ и, где доступно, соответствующий запрос в записях использования провайдера.
- Отправьте последующее сообщение, чтобы проверить непрерывный разговор.
- Протестируйте изображения или вызовы инструментов отдельно, если ваша работа требует их.
Сохранение записи не является проверкой подключения. Текстовый ответ не устанавливает совместимость с каждой функцией. Изменение записи модели также не перенастраивает автоматически существующий процесс Claude Code или Codex; см. PandaPaw.
Устранение неполадок
Не удается выполнить аутентификацию
Проверьте, активен ли ключ, имеет ли учетная запись доступ к модели и требует ли сервис дополнительные поля аутентификации. Замените истекшие учетные данные через форму провайдера.
Конечная точка или модель не найдена
Проверьте как базовый URL, так и значение модели. Ищите重复 пути операций, отсутствующий префикс API или идентификатор модели, недоступный для вашей учетной записи. Одна и та же ошибка может иметь разные причины у разных провайдеров.
Появляется сетевая ошибка или ошибка браузера
Проверьте подключение с устройства, которое фактически отправляет запрос. Запросы, исходящие из браузера, подчиняются ограничениям CORS и HTTPS; успешный запрос с другого компьютера не доказывает, что путь через браузер работает.
Не удается связаться с локальным сервером модели
localhost относится к компьютеру, отправляющему запрос. Он не автоматически указывает на ваш удаленный компьютер PandaPaw. Уточните, где работает использующая функция, прежде чем выбирать адрес вашего локального сервера.
Текст работает, но изображения, инструменты или длинные сеансы завершаются ошибкой
Проверьте точную комбинацию движка, протокола API и возможностей модели. Используйте поддерживаемые провайдером лимиты и проверяйте каждый требуемый тип ввода. Увеличение контекстного окна или изменение типа модели не добавляет вышестоящие возможности.
О различии между членством в платформе и использованием провайдера см. учетные записи и стоимость моделей.