İçeriğe geç

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.
  • Base URL: sağlayıcınızın belgelerindeki API adresi. OpenAI SDK’sının base_url dediği değerle aynıdır, örneğin https://llm.example.com/v1. Belgelerde yazdığı gibi yapıştırın; atbridge.ai sondaki /v1 ile de, onsuz da kabul eder.
  • API anahtarı: sağlayıcınızın panelinde oluşturulur. Anahtarları denetlemeyen yerel bir sunucu, local gibi 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):

SunucuOlağan base URL
LM Studiohttp://localhost:1234/v1
vLLMhttp://localhost:8000/v1
llama.cpp serverhttp://localhost:8080/v1
LiteLLM proxyhttp://localhost:4000
  1. 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.

  2. Sağlayıcı açılır menüsünden OpenAI uyumlu (özel URL) seçeneğini seçin.

  3. 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.

  4. 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.

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.

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.

Aynı bağlantı bir terminalden; anahtar standart girdiden okunur, böylece kabuk geçmişinize girmez:

Terminal window
echo "$MY_API_KEY" | atbridge connect activate --provider openai-compatible \
--base-url https://llm.example.com/v1 --key-stdin
  • 404 veya “not found”: base URL yanlış. Sağlayıcının belgelerinden yeniden kopyalayın; genellikle /v1 ile 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.

Was this page helpful?