PandaNpc, sağlayıcı bağlantılarını ve yapılandırdığınız model girdilerini saklar. Hizmetinizin sağladığı API Anahtarı, Temel URL, protokol ve model kimliği ile başlayın. Bir girdi eklemek, yukarı akış hesabı oluşturmaz veya model erişimi sağlamaz.
Sağlayıcı ile model arasındaki fark için Özel model listenizi yönetme bölümünü okuyun.
Başlamadan önce
Sağlayıcınız veya kendi kendine barındırılan hizmetinizle aşağıdakileri doğrulayın:
- API temel adresi, sağlayıcının web sitesi adresi değil.
- Kimlik doğrulama yöntemi ve gerekli tüm kimlik bilgileri.
- Kullanmayı düşündüğünüz özellik veya motor tarafından desteklenen API protokolü.
- Hesabınızın çağırabileceği tam model kimliği.
- Sınırları manuel olarak girmeyi planlıyorsanız bağlam ve çıktı sınırları.
Kimlik bilgilerini sağlayıcı formunda saklayın, istemlerde, ekran görüntülerinde veya paylaşılan notlarda değil. OpenAI uyumlu olarak tanıtılan bir hizmet, akış, araç çağrıları veya görüntü desteği açısından farklılık gösterebilir.
1. Sağlayıcı ekleyin veya yapılandırın
Model Yapılandırması'nı açın. Bir sağlayıcı ekleyin, mevcut bir ön ayarı yapılandırın veya bağımsız olarak düzenlenebilir bir bağlantıya ihtiyacınız olduğunda bir ön ayarı kopyalayın.
| Alan | Ne girilir |
|---|---|
| Görünen Ad | Bu bağlantı için tanınabilir bir ad |
| Sağlayıcı Kimliği | Sağlayıcı yapılandırması için bir tanımlayıcı |
| API Anahtarı | Hizmetinizin gerektirdiği kimlik bilgisi |
| Temel URL | Seçilen entegrasyonun beklediği API temel adresi |
| Protokol | Yukarı akış API'sinin fiilen uyguladığı biçim |
| Gizli, Kuruluş, Proje | Yalnızca hizmetinizin açıkça gerektirdiği değerler |
| İçerik dizisi desteği | Hizmetin yapılandırılmış mesaj içeriğini kabul edip etmediği |
Temel URL'nin şekli, protokole ve istekte bulunan özelliğe bağlıdır. Entegrasyon zaten ekliyorsa tam bir işlem yolu eklemeyin. Örneğin, /chat/completions ekleyen bir entegrasyon, o yolla zaten bitmeyen bir adres değil, ilgili temel adres gerektirir. Bu örneği her protokole uygulamayın.
Saklanan kimlik bilgilerini düzenlerken API Anahtarı veya Gizli alanını boş bırakmak yapılandırılmış değeri korur. Bir listede gösterilen maskeli değer orijinal anahtar değildir ve değiştirme olarak geri yapıştırılmamalıdır.
2. Modeli ekleyin
Sağlayıcıyı kaydedin, seçin ve Model Ekle'yi seçin.
| Alan | Anlamı |
|---|---|
| Görünen Ad | Model listesindeki etiketiniz |
| Model Değeri | Yukarı akıştaki tam model kimliği |
| Model Türü | Yapılandırma formundaki geçerli kategori |
| Sağlayıcı | Bu girdinin kullandığı bağlantı |
| Bağlam Penceresi | Belgelendiğinde bağlam kapasitesi |
| Maks. Token | Belirtildiğinde çıktı sınırı |
Hizmetin belgelerinden veya model listesinden bir kimlik kullanın. Bir pazarlama adı mutlaka bir API tanımlayıcısı değildir. Doğrulayamıyorsanız isteğe bağlı sınırları boş bırakın; boş bırakmak gerçek sınırların algılandığı anlamına gelmez. Kullanan özellik kendi varsayılanlarını uygulayabilir.
3. Yapılandırmayı doğrulayın
Bu ayarları kullanan özellik veya motorda:
- Yeni girdiyi seçin ve bir test sohbeti başlatın.
Şununla yanıtla: bağlıgibi kısa bir istek gönderin.- Normal bir yanıtı ve varsa sağlayıcının kullanım kayıtlarında eşleşen bir isteği doğrulayın.
- Sürekli sohbeti kontrol etmek için bir takip mesajı gönderin.
- Çalışmanız gerektiriyorsa görüntüleri veya araç çağrılarını ayrı ayrı test edin.
Kaydı kaydetmek bir bağlantı testi değildir. Bir metin yanıtı, her özellikle uyumluluk sağlamaz. Bir model girdisini değiştirmek, mevcut bir Claude Code veya Codex sürecini otomatik olarak yeniden yapılandırmaz; bkz. PandaPaw.
Sorun giderme
Kimlik doğrulama başarısız oluyor
Anahtarın aktif olup olmadığını, hesabın modele erişip erişemediğini ve hizmetin ek kimlik doğrulama alanları gerektirip gerektirmediğini kontrol edin. Süresi dolmuş kimlik bilgilerini sağlayıcı formu üzerinden değiştirin.
Uç nokta veya model bulunamıyor
Hem Temel URL'yi hem de Model Değerini kontrol edin. Yinelenen işlem yollarını, eksik bir API önekini veya hesabınız için kullanılamayan bir model kimliğini arayın. Aynı hata sağlayıcılar arasında farklı nedenlere sahip olabilir.
Bir ağ veya tarayıcı hatası görünüyor
İsteği fiilen gönderen cihazdan bağlantıyı kontrol edin. Tarayıcı kaynaklı istekler CORS ve HTTPS kısıtlamalarına tabidir; başka bir bilgisayardan çalışan bir istek, tarayıcı yolunun çalıştığını kanıtlamaz.
Yerel model sunucusuna erişilemiyor
localhost, isteği yapan makineyi ifade eder. Otomatik olarak uzak PandaPaw bilgisayarınıza işaret etmez. Yerel sunucunuzun adresini seçmeden önce kullanan özelliğin nerede çalıştığını doğrulayın.
Metin çalışıyor ancak görüntüler, araçlar veya uzun oturumlar başarısız oluyor
Motor, API protokolü ve model yeteneklerinin tam kombinasyonunu kontrol edin. Sağlayıcı tarafından desteklenen sınırları kullanın ve gerekli her giriş türünü doğrulayın. Bağlam Penceresini artırmak veya Model Türünü değiştirmek yukarı akış yetenekleri eklemez.
Platform üyeliği ile sağlayıcı kullanımı arasındaki fark için bkz. hesaplar ve model maliyetleri.