Sıkça Sorulan Sorular
Pexafy hakkında bilmeniz gereken her şey. Yanıtınızı bulamadınız mı? Bizimle iletişime geçin.
Başlarken
Pexafy Nedir?
Pexafy, Unsplash, Pexels, Pixabay, Wikimedia Commons ve daha fazlası gibi birden fazla kaynaktan milyonlarca ücretsiz ve premium görseli tek bir API'de toplayan yapay zeka destekli bir görsel arama motorudur. Düzinelerce görsel servisini ayrı ayrı entegre etmek yerine Pexafy'a tek bir istek yaparak tüm kaynaklardaki en iyi sonuçları, yapay zeka semantik alaka puanlamasıyla sıralı şekilde alırsınız.
API Anahtarını Nasıl Edinebilirim?
pexafy.com/auth/register/ adresinden ücretsiz bir hesap oluşturun, ardından Pano → API Anahtarları → Anahtar Oluştur yolunu izleyin. İlk anahtarınız kredi kartı gerekmeksizin anında oluşturulur. Ücretsiz plan, ayda 1K API isteği içerir.
Pexafy Ücretsiz mi?
Evet! Ücretsiz planımız size ayda 1K API isteği sunar — kredi kartı gerekmez. Metin tabanlı sorgular yapabilir ve tüm ücretsiz görsel kaynaklarına erişebilirsiniz. Daha fazla istek, premium görseller veya görsel-görsele arama mı gerekiyor? Pro ve Business planları için Fiyatlandırma sayfamıza göz atın.
Pexafy Hangi Görsel Kaynaklarını Arar?
Pexafy şu anda Unsplash, Pexels, Pixabay, Wikimedia Commons ve Openverse'ten görseller toplamaktadır. Sürekli olarak yeni kaynaklar ekliyoruz. API'deki source parametresini kullanarak sonuçları kaynağa göre filtreleyebilirsiniz.
Pexafy, Google Görseller'den Farkı Nedir?
Pexafy, tüketici odaklı bir arama motoru değil, geliştirici öncelikli bir API'dir. Yalnızca özgürce kullanılabilen ve Creative Commons lisanslı kaynakları topladığımızdan her sonuç ürününüzde güvenle kullanılabilir. Yapay zeka modelimiz semantik anlamı kavrar — 'huzurlu sonbahar atmosferi' araması yapın ve yalnızca anahtar kelime eşleşmesi değil, gerçekten ilgili görseller alın. Üstelik tek bir REST API aracılığıyla yapılandırılmış JSON yanıtları, sayfalama, filtreler ve kullanım analitiği elde edersiniz.
SDK veya İstemci Kütüphanesi Sunuyor musunuz?
Şu anda kapsamlı dokümantasyona sahip bir REST API sunmaktayız. Python, JavaScript/TypeScript ve PHP için resmi SDK'lar yol haritamızda yer almaktadır. Bu süreçte API'yi entegre etmek oldukça kolaydır — yalnızca API anahtarı başlığı içeren tek bir HTTPS isteği yeterlidir. Çeşitli dillerdeki kod örnekleri için belgelerimize göz atın.
API ve Teknik
API İstek Limiti Nedir?
İstek limitleri planınıza göre değişir: Ücretsiz — 20 istek/dakika, Pro — 60 istek/dakika, Business — 300 istek/dakika. Limiti aşarsanız, ne zaman yeniden deneyebileceğinizi belirten bir Retry-After başlığıyla birlikte 429 Too Many Requests yanıtı alırsınız.
API Hangi Formatlarda Yanıt Döndürür?
Tüm yanıtlar standart bir zarf yapısına sahip JSON formatındadır: {success, data, meta, pagination, error}. Her fotoğraf nesnesi şunları içerir: id, title, description, urls (thumbnail, small, regular, full, raw), photographer (name, url), source, license, dimensions, colors ve alaka puanı.
Sayfalamayı Nasıl Yönetirim?
Pexafy, imleç tabanlı sayfalama kullanır. Her yanıt bir pagination.next_cursor değeri içerir. Sonraki sayfayı almak için bu değeri bir sonraki isteğinizde cursor parametresi olarak gönderin. next_cursor null olduğunda son sayfaya ulaşmışsınızdır.
Arama Sonuçlarını Filtreleyebilir miyim?
Evet! Şu kriterlere göre filtreleme yapabilirsiniz: color_name (red, blue, green…), color_hex (örn. #FF5733, isteğe bağlı color_tolerance ile), orientation (landscape, portrait, square), source (unsplash, pexels, pixabay…) ve score_threshold (minimum alaka düzeyi 0.0–1.0). Daha hassas sonuçlar için filtreleri birleştirin.
API İsteklerini Nasıl Doğrularım?
API anahtarınızı istek başlığı olarak ekleyin: X-Api-Key: pxfy_your_key_here. Alternatif olarak Bearer token kimlik doğrulamasını kullanabilirsiniz: Authorization: Bearer <jwt_token>. API anahtarınızı istemci tarafı kodda asla paylaşmayın.
İstek Başına Maksimum Sonuç Sayısı Nedir?
per_page parametresini kullanarak sayfa başına en fazla 80 sonuç isteyebilirsiniz (varsayılan değer 20'dir). Büyük sonuç kümeleri için, sonraki sayfaları getirmek amacıyla imleç tabanlı sayfalama kullanın. Sayfalayabileceğiniz toplam sayfa sayısında herhangi bir sınır yoktur.
Pexafy çok dilli arama sorgularını destekliyor mu?
Evet! Modelimiz çok dilli verilerle eğitildiğinden İngilizce, Fransızca, İspanyolca, Almanca, Portekizce ve pek çok başka dilde arama yapabilirsiniz. Anlamsal anlama en iyi İngilizce'de çalışır; ancak diğer dillerdeki yaygın sorgular da doğru sonuçlar üretir. Maksimum hassasiyet için İngilizce kullanmanızı öneririz.
Faturalandırma ve Planlar
Planımı değiştirebilir miyim?
Evet, Dashboard → Billing bölümünden istediğiniz zaman yükseltme veya düşürme yapabilirsiniz. Yükseltmeler, orantılı faturalandırmayla hemen geçerli olur. Düşürmeler ise mevcut faturalandırma döneminin sonunda yürürlüğe girer. Her şey Stripe aracılığıyla otomatik olarak yönetilir.
Kotamı aşarsam ne olur?
Aylık limitinize ulaştığınızda API istekleri engellenir — bilgilendirici bir hata mesajıyla birlikte 429 yanıtı alırsınız. API'yi kullanmaya devam etmek için Dashboard → Billing bölümünden daha üst bir plana geçin.
Geri ödeme yapıyor musunuz?
Tüm ücretli planlarda 14 günlük para iade garantisi sunuyoruz. Aboneliğinizin ilk 14 günü içinde memnun kalmazsanız [email protected] adresinden bizimle iletişime geçin; hiçbir soru sormadan tam iade yapacağız.
Hangi ödeme yöntemlerini kabul ediyorsunuz?
Başlıca kredi ve banka kartlarının tamamını (Visa, Mastercard, American Express) kabul ediyoruz; ayrıca Apple Pay ve Google Pay ile de ödeme yapabilirsiniz — tüm işlemler Stripe aracılığıyla güvenli şekilde gerçekleştirilir. Sunucularımızda herhangi bir ödeme bilgisi saklamıyoruz.
Uzun vadeli bir sözleşme var mı?
Sözleşme yok, taahhüt yok. Tüm planlar aylık bazlıdır (isterseniz indirimli yıllık seçeneği de mevcuttur). Dashboard → Billing bölümünden tek tıkla istediğiniz zaman iptal edebilirsiniz. Erişiminiz mevcut faturalandırma döneminin sonuna kadar devam eder.
Yıllık indirim var mı?
Evet! Yıllık ödeme yaklaşık %17 tasarruf sağlar: Pro planı aylık $29 yerine yılda $290 (aylık $24), Business planı ise aylık $299 yerine yılda $2990 (aylık $249) olarak sunulmaktadır. Dashboard → Billing bölümünden yıllık plana geçebilirsiniz.
Özel kurumsal planlar sunuyor musunuz?
Evet! İhtiyaçlarınız Business planının ötesine geçiyorsa — daha yüksek hız limitleri, özel altyapı, özelleştirilmiş SLA veya şirket içi kurulum gibi — gereksinimlerinizle birlikte [email protected] adresinden bizimle iletişime geçin. Kuruluşunuza özel bir plan hazırlayalım.
Ödemede hangi para birimlerini destekliyorsunuz?
Tüm fiyatlar USD cinsinden listelenmektedir. Ödeme işlemcimiz Stripe, ödeme sırasında yerel para biriminize otomatik olarak dönüştürme yapar. Bankanız, kart türünüze ve ülkenize bağlı olarak küçük bir döviz işlem ücreti uygulayabilir.
Görseller ve Lisanslama
Görsellerin sahibi Pexafy mi?
Hayır. Pexafy bir arama motorudur — üçüncü taraf platformlarda (Unsplash, Pexels, Pixabay vb.) barındırılan görselleri dizinler ve arar. Gerçek görsel dosyalarını depolamaz, barındırmaz veya yeniden dağıtmayız. Tüm görseller ilgili fotoğrafçıların ve platformların mülkiyetinde kalmaya devam eder.
Görselleri ticari amaçlarla kullanabilir miyim?
Bu, kaynak lisansına bağlıdır. Unsplash, Pexels ve Pixabay, görsellerinin büyük çoğunluğu için ücretsiz ticari kullanım lisansı sunar. Wikimedia Commons ve Openverse ise çeşitli Creative Commons lisansları kullanır — bir kısmı ticari kullanıma izin verirken bir kısmı vermez. Bir görseli ticari amaçla kullanmadan önce API yanıtındaki lisans alanını her zaman kontrol edin ve kaynak URL'de doğrulama yapın.
Premium görseller neden farklıdır?
Premium görseller arama sonuçlarında görünür; ancak tam çözünürlükte indirmek için kaynakta abonelik veya satın alma gerekebilir. API, tüm görseller için önizleme/küçük resim döndürür. Ücretsiz ve Pro planlarda, yanıttaki kaynak URL'si tam görsele nereden erişebileceğinizi gösterir.
API aracılığıyla görsel indirebilir miyim?
Pexafy, görsellerin orijinal platformlarda barındırılan URL'lerini döndürür — görsel dosyalarını doğrudan API üzerinden sunmuyoruz. Ücretsiz görseller (Unsplash, Pexels, Pixabay) için yanıtta sağlanan kaynak URL'sinden tam çözünürlüklü görseli indirebilirsiniz. Kaynak platformun kullanım koşullarına her zaman saygı gösterin.
Görsel dizini ne sıklıkla güncellenir?
Dizinleme hattımız tüm başlıca kaynaklar için günlük olarak çalışır. Unsplash, Pexels, Pixabay ve diğer platformlara yüklenen yeni görseller genellikle 24–48 saat içinde Pexafy üzerinden aranabilir hale gelir. Dizinimiz şu anda 5 milyonun üzerinde görsel içermekte olup her gün büyümeye devam etmektedir.
Hesap ve Güvenlik
Hesabımı nasıl silebilirim?
Dashboard → Settings → Danger Zone → Delete Account yolunu izleyin. Hesap silme işlemi kalıcıdır ve tüm API anahtarlarınızı, kullanım geçmişinizi ve kişisel verilerinizi kaldırır. GDPR/silme hakkı kapsamında silme talebinde bulunmak için [email protected] adresine e-posta da gönderebilirsiniz.
Verilerim güvende mi?
Evet. Her yerde HTTPS, parola karma için bcrypt kullanıyor; oturumları kısa ömürlü JWT token'larıyla Redis'te saklıyoruz. Verilerinizi üçüncü taraflarla satmıyor veya paylaşmıyoruz. API anahtarları depolanmadan önce karma haline getirilir. Veri uygulamaları hakkında tam ayrıntılar için Gizlilik Politikamızı okuyun.
Birden fazla API anahtarına sahip olabilir miyim?
Evet, planınıza bağlı olarak: Ücretsiz (1 anahtar), Pro (5 anahtar), Business (∞ anahtar). Birden fazla anahtar; kullanımı uygulama, ortam (dev/staging/prod) veya ekip üyesine göre ayırmanıza ve diğerlerini etkilemeden tek tek anahtarları iptal etmenize olanak tanır.
API anahtarım ele geçirilirse ne olur?
Ele geçirilen anahtarı hemen Dashboard → API Keys bölümünden iptal edin ve yeni bir tane oluşturun. İptal anında geçerli olur — eski anahtarı kullanan tüm istekler 401 hatasıyla reddedilir. API anahtarlarını sürüm kontrolüne asla eklemeyiniz; bunun yerine ortam değişkenlerini kullanın.
Çalışma süresi garantiniz nedir?
API kullanılabilirliği için yüzde 99,9 çalışma süresi hedefliyoruz. Business plan müşterileri, çalışma süresi taahhütlerini içeren bir SLA alır. Gerçek zamanlı ve geçmiş hizmet durumunu, bu sitenin alt bilgisinden erişilebilen Durum sayfamızdan takip edebilirsiniz.
Pexafy GDPR uyumlu mu?
Evet. Yalnızca hizmeti işletmek için gereken minimum veriyi (e-posta, karma parola, kullanım günlükleri) topluyoruz. Verileri üçüncü taraflara satmıyoruz. Dashboard → Settings bölümünden veya [email protected] adresine e-posta göndererek istediğiniz zaman tam veri dışa aktarma veya silme talebinde bulunabilirsiniz. Tam ayrıntılar için Gizlilik Politikamıza bakın.
Aramanızla eşleşen soru yok. Farklı bir terim deneyin.
Doğrudan bize sorunHâlâ sorularınız mı var?
Aradığınızı bulamadınız mı? Ekibimiz yardımcı olmaktan memnuniyet duyar.
Destekle İletişime Geçin API Belgelerini Okuyun