PandaNpc зберігає з'єднання з провайдерами та записи моделей, які ви налаштовуєте. Почніть з API-ключа, базової URL-адреси, протоколу та ідентифікатора моделі, наданих вашим сервісом. Додавання запису не створює обліковий запис у провайдера чи доступ до моделі.
Щодо відмінності між провайдером і моделлю, див. Керування власним списком моделей.
Перед початком
Уточніть у свого провайдера або self-hosted сервісу таке:
- Базова адреса API, а не веб-сайт провайдера.
- Метод автентифікації та необхідні облікові дані.
- Протокол API, який підтримує функція або рушій, який ви плануєте використовувати.
- Точний ідентифікатор моделі, який може викликати ваш обліковий запис.
- Ліміти контексту та виводу, якщо ви плануєте вводити їх вручну.
Зберігайте облікові дані у формі провайдера, а не в підказках, скріншотах або спільних нотатках. Сервіс, який рекламується як OpenAI-сумісний, може відрізнятися в потоковій передачі, викликах інструментів або підтримці зображень.
1. Додати або налаштувати провайдера
Відкрийте Model Configuration. Додайте провайдера, налаштуйте наявний пресет або скопіюйте пресет, якщо вам потрібне незалежне редаговане з'єднання.
| Поле | Що вводити |
|---|---|
| Display Name | Впізнавана назва для цього з'єднання |
| Provider ID | Ідентифікатор конфігурації провайдера |
| API Key | Облікові дані, необхідні вашому сервісу |
| Base URL | Базова адреса API, очікувана вибраною інтеграцією |
| Protocol | Формат, який фактично реалізує API провайдера |
| Secret, Organization, Project | Тільки значення, які явно вимагає ваш сервіс |
| Support content array | Чи приймає сервіс структурований вміст повідомлень |
Форма Base URL залежить від протоколу та функції, яка надсилає запити. Не додавайте повний шлях операції, якщо інтеграція вже додає його. Наприклад, інтеграція, яка додає /chat/completions, потребує відповідної базової адреси, а не адреси, яка вже закінчується цим шляхом. Не застосовуйте цей приклад до кожного протоколу.
Під час редагування збережених облікових даних залишення поля API Key або Secret порожнім зберігає налаштоване значення. Замасковане значення, показане в списку, не є оригінальним ключем, і його не слід вставляти як заміну.
2. Додати модель
Збережіть провайдера, виберіть його та оберіть Add Model.
| Поле | Значення |
|---|---|
| Display Name | Ваша позначка в списку моделей |
| Model Value | Точний ідентифікатор моделі провайдера |
| Model Type | Відповідна категорія у формі конфігурації |
| Provider | З'єднання, яке використовує цей запис |
| Context Window | Документована ємність контексту, якщо вказано |
| Max Tokens | Ліміт виводу, якщо вказано |
Використовуйте ідентифікатор із документації або списку моделей сервісу. Маркетингова назва не обов'язково є ідентифікатором API. Залиште необов'язкові ліміти невстановленими, якщо ви не можете їх перевірити; невстановлений не означає, що реальні ліміти було виявлено. Функція, що використовує ці налаштування, може застосовувати власні значення за замовчуванням.
3. Перевірте конфігурацію
У функції або рушії, який використовує ці налаштування:
- Виберіть новий запис і почніть тестову розмову.
- Надішліть короткий запит, наприклад
Reply with: connected. - Підтвердьте нормальну відповідь і, якщо доступно, відповідний запит у записах використання провайдера.
- Надішліть наступне повідомлення, щоб перевірити безперервну розмову.
- Протестуйте зображення або виклики інструментів окремо, якщо ваша робота цього вимагає.
Збереження запису не є тестом з'єднання. Текстова відповідь не підтверджує сумісність з усіма можливостями. Зміна запису моделі також не переналаштовує автоматично наявний процес Claude Code або Codex; див. PandaPaw.
Усунення неполадок
Автентифікація не вдається
Перевірте, чи активний ключ, чи має обліковий запис доступ до моделі, і чи вимагає сервіс додаткових полів автентифікації. Замініть прострочені облікові дані через форму провайдера.
Кінцеву точку або модель не знайдено
Перевірте як Base URL, так і Model Value. Шукайте дубльовані шляхи операцій, відсутній префікс API або ідентифікатор моделі, недоступний для вашого облікового запису. Та сама помилка може мати різні причини у різних провайдерів.
З'являється мережева або браузерна помилка
Перевірте з'єднання з пристрою, який фактично надсилає запит. Запити, ініційовані браузером, підпадають під обмеження CORS та HTTPS; успішний запит з іншого комп'ютера не доводить, що шлях через браузер працює.
Не вдається досягти локального сервера моделі
localhost стосується машини, яка надсилає запит. Він не автоматично вказує на ваш віддалений комп'ютер PandaPaw. Підтвердьте, де працює функція, що використовує ці налаштування, перед вибором адреси вашого локального сервера.
Текст працює, але зображення, інструменти або довгі сесії не працюють
Перевірте точну комбінацію рушія, протоколу API та можливостей моделі. Використовуйте ліміти, підтримувані провайдером, і перевірте кожен необхідний тип введення. Збільшення Context Window або зміна Model Type не додає можливостей провайдера.
Щодо відмінності між членством у платформі та використанням провайдера, див. облікові записи та вартість моделей.