Perplexity API, bir uygulamadan Perplexity'nin desteklediği yapay zekâ ve arama hizmetlerine erişmek içindir. Web sitesinde sohbet etmekle kendi uygulamana API bağlamak farklı işlemlerdir. Anahtar oluşturabilmek için geliştirici portalında bir proje gerekir. Projeyi, bu uygulamanın anahtarlarının ve kullanımının tutulduğu çalışma kutusu gibi düşünebilirsin. 3 Kasım 2026 tarihli güncel belgelerde Agent API anlatılıyor; eski Sonar örneklerini yeni bir kurulumun başlangıcı olarak kopyalama.
API, güncel belgelerde kullanım başına ücretlendirilen bir hizmet olarak açıklanıyor; başlamak için bir sohbet aboneliği satın alma zorunluluğu belirtilmiyor. API projesinde önceden alınan krediler kullanılır. Model kullanımı ve arama işlemleri maliyeti etkileyebilir. Kart eklemekle kredi satın almak veya otomatik yükleme açmak aynı adım değildir. Billing ekranında bakiye, ücretler ve varsa otomatik yükleme tercihini okuyarak ilerle; bir rehberdeki eski ücretsiz kredi vaadini kendi hesabın için garanti sayma.
Yukarıdaki console.perplexity.ai bağlantısına git. Sunulan Google, Apple, kurumsal giriş veya e-posta ile giriş seçeneklerinden sana uygun olanı kullan. E-posta yöntemi seçersen gelen bağlantı ya da tek kullanımlık kodla oturumu tamamla. Normal sohbet sayfasında kalmak yerine API portalına döndüğünü kontrol et.
İlk girişte kurulum yönlendirmesini izle. Mevcut bir ekibe katılacaksan proje yöneticisinin davetini kullan. Yeni kişisel deneme için anlaşılır bir proje adı seçebilirsin. Yalnız giriş yapmak projeyi otomatik olarak oluşturmuş sayılmaz; anahtar aşamasından önce proje bulunmalıdır.
Sol menüde Project altındaki Settings bölümünü aç. İstenen kuruluş, adres veya fatura bilgilerini kendi durumuna uygun ve doğru gir. İş hesabında bu bilgileri tahmin ederek doldurma; yöneticine sor. Proje ayarlarıyla anahtarın gizli değeri farklı alanlardır.
Billing, yani faturalandırma alanını aç. Bakiyeni ve kullanım görünümünü incele. Bu alan görünmüyorsa yönetici yetkin olmayabilir. Ücretli denemeye devam edeceksen ekrandaki ödeme ve kredi adımlarını okuyarak tamamla; otomatik yükleme seçeneğinin hesabına hangi koşullarda para ekleyeceğini anlamadan açma.
Sol menüde API keys alanını seç veya doğrudan anahtar bağlantısını aç. Hangi proje altında olduğunu yeniden kontrol et. Birden fazla projeyle çalışırken yanlış projenin anahtarını kopyalamak, hem erişimi hem de kullanım takibini karıştırabilir.
+ Generate API Key düğmesini kullan. Ad sorulursa hangi uygulamada kullanacağını anlatan bir etiket ver; örneğin YZF araştırma denemesi. Gösterilen tam gizli değeri hemen kopyalayıp parola yöneticine kaydet. Tam anahtar bir kez gösterilir; pencere kapandıktan sonra onu yeniden görmeyi bekleme.
Perplexity’nin resmî proje ve ücretlendirme belgesindeki boş anahtar listesi örneğidir. Kaynak: resmî ekran veya belge. Görseli büyütmek için üzerine dokunabilirsiniz.
Perplexity’nin resmî geliştirici belgesindeki gerçek anahtar oluşturma formu örneğidir. CRM Agent Prod Key yalnız örnek anahtar adıdır; gizli anahtar değeri değildir. Bu çalışma sırasında anahtar üretilmemiştir. Kaynak: resmî ekran veya belge. Görsele dokunarak büyütebilirsiniz.
Kırmızı numaraların gösterdiği alanlar:
Uygulamada Perplexity sağlayıcısı varsa hangi API biçimini desteklediğine bak. Yalnız eski Sonar Chat Completions örnekleri sunan bir araç güncel Agent API ile aynı biçimi kullanmayabilir. Uygulamanın güncel sürümünü ve resmî bağlantı talimatını esas al; sadece anahtar yapıştırmak her eski eklentiyi uyumlu hâle getirmez.
Desteklenen bağlantıya kendi anahtarını gir ve ayarı kaydet. İlk isteğini kısa tut: Bağlantı denemesi için tek cümle yaz. Güncel Agent API'de web araması ayrıca seçilir; yalın bir metin isteğinin kaynak bağlantıları getirmemesi, tek başına anahtarın bozuk olduğu anlamına gelmez.
Bağladığın uygulamada yanıt almayı ve proje kullanımında hareket görmeyi kontrol et. Portalın Playground alanı da deneme için yardımcıdır. Yardım isterken model adını, API biçimini ve gizli olmayan hata metnini paylaş; anahtarını veya kart bilgilerini mesaja ekleme.
Kullanacağınız uygulamanın Ayarlar, Bağlantılar veya Yapay zekâ sağlayıcıları bölümünü açın. Anahtarı herkese açık bir mesaj kutusuna değil, uygulamanın bu iş için ayırdığı gizli bağlantı alanına girin. Alanların anlamı şöyledir:
Anahtar oluşturamıyorum.
Önce proje oluşturulduğunu ve doğru projeyi açtığını kontrol et. Ekip hesabında API anahtarı yönetimi için gerekli yetkiyi yöneticine doğrulat.
Bakiye bittiğinde neden bağlantı durdu?
API kredileri tükendiğinde anahtarlar kullanıma kapanabilir. Faturalandırma alanında bakiye ve kredi durumunu kontrol et; yeni anahtar üretmek bakiye oluşturmaz.
Anahtarın tamamı artık görünmüyor.
Bu normaldir; tam değer oluşturma anında gösterilir. Güvenli kaydın yoksa yeni bir anahtar oluşturup uygulamayı güncellemen gerekir.
Eski eklenti yanıtı okuyamıyor.
Güncel Agent API yanıt biçimi eski Sonar biçimiyle aynı değildir. Eklentinin güncel API desteğini kontrol et; sadece model adını veya servis adresini değiştirmenin yeterli olduğunu varsayma.
Bilgi ve ekran kontrol tarihi: 3 Kasım 2026. Menü yerleşimi, hesap uygunluğu, model listesi ve ücretler değişebilir; işlem sırasında hesabınızda gösterilen güncel koşulları okuyun. Bu konudaki görsellerde kullanılabilir gizli API anahtarı bulunmaz.
Başlamak için açacağınız adresler
Önce ücret ve kullanım hakkını anlayın
API, güncel belgelerde kullanım başına ücretlendirilen bir hizmet olarak açıklanıyor; başlamak için bir sohbet aboneliği satın alma zorunluluğu belirtilmiyor. API projesinde önceden alınan krediler kullanılır. Model kullanımı ve arama işlemleri maliyeti etkileyebilir. Kart eklemekle kredi satın almak veya otomatik yükleme açmak aynı adım değildir. Billing ekranında bakiye, ücretler ve varsa otomatik yükleme tercihini okuyarak ilerle; bir rehberdeki eski ücretsiz kredi vaadini kendi hesabın için garanti sayma.
Adım adım API anahtarını alma
1. Güncel API portalını aç
Yukarıdaki console.perplexity.ai bağlantısına git. Sunulan Google, Apple, kurumsal giriş veya e-posta ile giriş seçeneklerinden sana uygun olanı kullan. E-posta yöntemi seçersen gelen bağlantı ya da tek kullanımlık kodla oturumu tamamla. Normal sohbet sayfasında kalmak yerine API portalına döndüğünü kontrol et.
2. Bir proje oluştur veya seç
İlk girişte kurulum yönlendirmesini izle. Mevcut bir ekibe katılacaksan proje yöneticisinin davetini kullan. Yeni kişisel deneme için anlaşılır bir proje adı seçebilirsin. Yalnız giriş yapmak projeyi otomatik olarak oluşturmuş sayılmaz; anahtar aşamasından önce proje bulunmalıdır.
3. Proje ayarlarını tamamla
Sol menüde Project altındaki Settings bölümünü aç. İstenen kuruluş, adres veya fatura bilgilerini kendi durumuna uygun ve doğru gir. İş hesabında bu bilgileri tahmin ederek doldurma; yöneticine sor. Proje ayarlarıyla anahtarın gizli değeri farklı alanlardır.
4. Kredi ve ödeme durumunu gör
Billing, yani faturalandırma alanını aç. Bakiyeni ve kullanım görünümünü incele. Bu alan görünmüyorsa yönetici yetkin olmayabilir. Ücretli denemeye devam edeceksen ekrandaki ödeme ve kredi adımlarını okuyarak tamamla; otomatik yükleme seçeneğinin hesabına hangi koşullarda para ekleyeceğini anlamadan açma.
5. Anahtar listesine git
Sol menüde API keys alanını seç veya doğrudan anahtar bağlantısını aç. Hangi proje altında olduğunu yeniden kontrol et. Birden fazla projeyle çalışırken yanlış projenin anahtarını kopyalamak, hem erişimi hem de kullanım takibini karıştırabilir.
6. Yeni anahtarı oluştur ve sakla
+ Generate API Key düğmesini kullan. Ad sorulursa hangi uygulamada kullanacağını anlatan bir etiket ver; örneğin YZF araştırma denemesi. Gösterilen tam gizli değeri hemen kopyalayıp parola yöneticine kaydet. Tam anahtar bir kez gösterilir; pencere kapandıktan sonra onu yeniden görmeyi bekleme.
Resmî belgedeki anahtar listesi örneği
Perplexity’nin resmî proje ve ücretlendirme belgesindeki boş anahtar listesi örneğidir. Kaynak: resmî ekran veya belge. Görseli büyütmek için üzerine dokunabilirsiniz.
- 1: Yeni gizli anahtar oluşturma işlemini başlatan Generate API Key düğmesi. Soldaki arama kutusu yeni anahtar üretmez; mevcut kayıtları arar.
Resmî gerçek Create API Key formu
Perplexity’nin resmî geliştirici belgesindeki gerçek anahtar oluşturma formu örneğidir. CRM Agent Prod Key yalnız örnek anahtar adıdır; gizli anahtar değeri değildir. Bu çalışma sırasında anahtar üretilmemiştir. Kaynak: resmî ekran veya belge. Görsele dokunarak büyütebilirsiniz.
Kırmızı numaraların gösterdiği alanlar:
- Key name alanına anahtarın amacını hatırlatan bir ad verin.
- Alanı kontrol ettikten sonra Create Key ile oluşturma işlemini başlatırsınız; çıkan gizli değeri paylaşmayın.
7. Uygulamanın güncel API desteğini kontrol et
Uygulamada Perplexity sağlayıcısı varsa hangi API biçimini desteklediğine bak. Yalnız eski Sonar Chat Completions örnekleri sunan bir araç güncel Agent API ile aynı biçimi kullanmayabilir. Uygulamanın güncel sürümünü ve resmî bağlantı talimatını esas al; sadece anahtar yapıştırmak her eski eklentiyi uyumlu hâle getirmez.
8. Anahtarı ekleyip kısa deneme yap
Desteklenen bağlantıya kendi anahtarını gir ve ayarı kaydet. İlk isteğini kısa tut: Bağlantı denemesi için tek cümle yaz. Güncel Agent API'de web araması ayrıca seçilir; yalın bir metin isteğinin kaynak bağlantıları getirmemesi, tek başına anahtarın bozuk olduğu anlamına gelmez.
9. Sonucu ve kullanımı birlikte kontrol et
Bağladığın uygulamada yanıt almayı ve proje kullanımında hareket görmeyi kontrol et. Portalın Playground alanı da deneme için yardımcıdır. Yardım isterken model adını, API biçimini ve gizli olmayan hata metnini paylaş; anahtarını veya kart bilgilerini mesaja ekleme.
Aldığım anahtarı uygulamaya nereye yazacağım?
Kullanacağınız uygulamanın Ayarlar, Bağlantılar veya Yapay zekâ sağlayıcıları bölümünü açın. Anahtarı herkese açık bir mesaj kutusuna değil, uygulamanın bu iş için ayırdığı gizli bağlantı alanına girin. Alanların anlamı şöyledir:
- Sağlayıcı: Perplexity; güncel Agent API desteği olan bağlantı. Eski Sonar örneğiyle aynı yanıt biçimini varsayma.
- API Key: Seçili projede oluşturduğun tam gizli değer. Proje adı veya Perplexity giriş kodu değildir.
- Base URL: https://api.perplexity.ai/v1. OpenAI Responses uyumlu istemciler içindir. Yerleşik Perplexity istemcisi adresi kendisi ayarlayabilir.
- Model / çalışma biçimi: Uygulamanın ve güncel panelin desteklediği seçenek. Agent API, arama aracını ayrıca etkinleştirebilir. Sabit eski Sonar adı yazma.
Sık karşılaşılan sorunlar ve çözümleri
Anahtar oluşturamıyorum.
Önce proje oluşturulduğunu ve doğru projeyi açtığını kontrol et. Ekip hesabında API anahtarı yönetimi için gerekli yetkiyi yöneticine doğrulat.
Bakiye bittiğinde neden bağlantı durdu?
API kredileri tükendiğinde anahtarlar kullanıma kapanabilir. Faturalandırma alanında bakiye ve kredi durumunu kontrol et; yeni anahtar üretmek bakiye oluşturmaz.
Anahtarın tamamı artık görünmüyor.
Bu normaldir; tam değer oluşturma anında gösterilir. Güvenli kaydın yoksa yeni bir anahtar oluşturup uygulamayı güncellemen gerekir.
Eski eklenti yanıtı okuyamıyor.
Güncel Agent API yanıt biçimi eski Sonar biçimiyle aynı değildir. Eklentinin güncel API desteğini kontrol et; sadece model adını veya servis adresini değiştirmenin yeterli olduğunu varsayma.
Resmî kaynaklar
- Perplexity: Güncel API platformu
- Perplexity: API portalına giriş
- Perplexity: Projeler ve faturalandırma
- Perplexity: API anahtarı yönetimi
- Perplexity: Agent API başlangıcı
- Perplexity: OpenAI Responses uyumluluğu
Bilgi ve ekran kontrol tarihi: 3 Kasım 2026. Menü yerleşimi, hesap uygunluğu, model listesi ve ücretler değişebilir; işlem sırasında hesabınızda gösterilen güncel koşulları okuyun. Bu konudaki görsellerde kullanılabilir gizli API anahtarı bulunmaz.
