OpenAI uyumlu bir API bağlayın
Birçok yapay zeka hizmeti ve sunucusu OpenAI ile aynı API formatını konuşur. atbridge.ai bunların hepsiyle tek bir sağlayıcı seçeneği üzerinden çalışır: OpenAI uyumlu (özel URL). Hiçbir şey kurmanız veya bir entegrasyon beklemeniz gerekmez: hizmetin Base URL’sini ve API anahtarını girin, atbridge AI Chat onu diğer sağlayıcılar gibi kullanır.
Tipik durumlar:
- Kendi bilgisayarınızda veya sunucunuzda çalışan bir model: LM Studio, vLLM, llama.cpp sunucusu, LocalAI.
- Şirketinizin çalıştırdığı bir proxy, örneğin birden fazla sağlayıcının önünde duran LiteLLM.
- Modellere OpenAI uyumlu bir uç nokta üzerinden erişim sağlayan bir API ağ geçidi veya bayi.
Neye ihtiyacınız var
Bölüm başlığı “Neye ihtiyacınız var”- Base URL: sağlayıcınızın belgelerindeki API adresi. OpenAI SDK’sının
base_urldediği değerle aynıdır, örneğinhttps://llm.example.com/v1. Belgelerde yazdığı gibi yapıştırın; atbridge.ai sondaki/v1ile de, onsuz da kabul eder. - API anahtarı: sağlayıcınızın panelinde oluşturulur. Anahtarları denetlemeyen
yerel bir sunucu,
localgibi herhangi bir yer tutucuyu kabul eder.
Hizmet, Authorization: Bearer kimlik doğrulamasıyla iki standart OpenAI uç
noktasını desteklemelidir: /v1/chat/completions (sohbetin kendisi) ve
/v1/models (atbridge.ai’in bağlantıyı denetlemek için de kullandığı model
listesi). OpenAI uyumlu hizmetlerin ve yerel sunucuların neredeyse tamamı ikisini
de sağlar.
Yaygın yerel sunucular ve olağan base URL’leri (kendi kurulumunuzu kontrol edin):
| Sunucu | Olağan base URL |
|---|---|
| LM Studio | http://localhost:1234/v1 |
| vLLM | http://localhost:8000/v1 |
| llama.cpp server | http://localhost:8080/v1 |
| LiteLLM proxy | http://localhost:4000 |
Bunu atbridge.ai’e ekleyin
Bölüm başlığı “Bunu atbridge.ai’e ekleyin”-
Thunderbird’de atbridge Ayarlar’ı açın: dişli veya Araçlar → Eklentiler ve Temalar → atbridge.ai → Seçenekler (bkz. atbridge uzantı ayarlarını açın). Yapay zeka sağlayıcıları sekmesine gidin.
-
Sağlayıcı açılır menüsünden OpenAI uyumlu (özel URL) seçeneğini seçin.
-
Base URL alanını doldurun ve anahtarınızı API anahtarı alanına yapıştırın. Anahtar bu cihazda şifrelenir ve atbridge.ai’in sunucularına asla ulaşmaz.
-
Bağlan’a tıklayın. atbridge.ai, model listesini isteyerek adresi ve anahtarı hemen denetler. Denetim başarılı olursa durum yeşil ✓‘e döner; başarısız olursa hiçbir şey kaydedilmez ve nedenini görürsünüz.
Bir model seçin ve sohbet edin
Bölüm başlığı “Bir model seçin ve sohbet edin”atbridge AI Chat’i açın (Thunderbird’deki @b düğmesi) ve hizmetin bildirdiği modelleri gösteren model açılır menüsünden bir model seçin. Bir ağ geçidi yüzlerce model listeleyebilir; birini tam adıyla kullanmak için adını Ayarlar → Tercih edilen yapay zeka sağlayıcısı ve modeli altındaki özel model kimliği alanına yazın.
Verilerinizi kim görür
Bölüm başlığı “Verilerinizi kim görür”OpenAI uyumlu bir sağlayıcıyla istemleriniz ve AI Chat’e verdiğiniz e-posta metinleri veya ekler girdiğiniz Base URL’ye gönderilir. atbridge.ai bunları aktarmaz (proxy’lemez) ve saklamaz. Bir hizmeti bağlamadan önce onu çalıştıran tarafa güvendiğinizden emin olun ve gizlilik ile veri saklama koşullarını okuyun. Bilgisayarınızdan çıkmaması gereken postalar için yerel bir sunucu (yukarıdaki tablo) veya Ollama kullanın.
Komut satırından kurun
Bölüm başlığı “Komut satırından kurun”Aynı bağlantı bir terminalden; anahtar standart girdiden okunur, böylece kabuk geçmişinize girmez:
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \ --base-url https://llm.example.com/v1 --key-stdinBağlanmazsa
Bölüm başlığı “Bağlanmazsa”- 404 veya “not found”: base URL yanlış. Sağlayıcının belgelerinden yeniden
kopyalayın; genellikle
/v1ile biten adrestir. - 401 veya 403: anahtar yanlış, süresi dolmuş ya da o modele erişimi yok.
- URL doğru ama Bağlan yine başarısız oluyor: hizmet, atbridge.ai’in bağlantıyı
denetlemek için ihtiyaç duyduğu model listesini (
/v1/models) sağlamıyor olabilir. Sağlayıcınıza bunu destekleyip desteklemediğini sorun. - Sohbet yanıt veriyor ama postalarınıza hiç bakmıyor: model araç çağırmayı desteklemiyor. Başka bir model seçin.
İlgili
Bölüm başlığı “İlgili”Was this page helpful?
Thanks for the feedback!