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, 9 kaynaktan — Unsplash, Pexels, Pixabay, Kaboompics, Burst ve daha fazlasından — milyonlarca ücretsiz kullanılabilir görseli tek bir API'de bir araya getiren yapay zeka destekli bir görsel arama motorudur. Tek bir Pexafy isteği = tüm 9 kaynak genelinde tek bir semantik arama. Sağlayıcıların kendi API'leriyle aynı arama 3 ila 5 çağrı gerektirir; buna ek olarak birleştirme mantığı ve JSON normalleştirmesi de dahildir: yazmanız, bakımını yapmanız ve bedelini ödemeniz gereken kodlar.
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 5K API isteği içerir.
Başvurumun onaylanması gerekiyor mu?
Hayır. Anahtarınız ilk çağrıda hemen çalışır: uygulama incelemesi, bekleme süresi ve her indirmede yapılması gereken zorunlu indirme takip çağrısı yoktur. Unsplash, onaylanmamış uygulamaları inceleme tamamlanana kadar saatte 50 istekle sınırlandırır; Pexels ise saatte 200 isteğe izin verir.
Pexafy Ücretsiz mi?
Evet! Free planımız ayda 5K API isteği sunar — kredi kartı gerekmez — ve diğer tüm planlar gibi Pexafy'nin dizinlediği tüm kaynaklarda arama yapar. Daha fazla isteğe mi ihtiyacınız var? Starter'dan Enterprise'a ücretli planlar limitleri yükseltir: Fiyatlandırma sayfamıza göz atın.
Pexafy Hangi Görsel Kaynaklarını Arar?
Pexafy şu anda 9 kaynağı bir araya getirmektedir; bunların en büyükleri Unsplash, Pexels, Pixabay, Kaboompics, Burst'tir. 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, planınızı istediğiniz zaman Dashboard → Billing bölümünden değiştirin. Değişiklik hemen geçerli olur ve satıcımız Creem bunu orantılı olarak hesaplar: daha yüksek bir plana geçişte mevcut döneminizin kalan kısmı için fiyat farkı tahsil edilir, daha düşük bir plana geçişte bu fark iade edilir.
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. İadeyi, satıcımız Creem orijinal ödeme yönteminize yapar. Ayrıntılar İade Politikamızda: pexafy.com/legal/refund/
Hangi ödeme yöntemlerini kabul ediyorsunuz?
Ödemeler, satıcımız ve Merchant of Record'umuz olan Creem tarafından işlenir. Kredi veya banka kartıyla ya da Creem'in ülkenizde ödeme sırasında sunduğu diğer ödeme yöntemleriyle ödeyebilirsiniz. Kart bilgilerinizi hiçbir zaman görmeyiz ve saklamayız.
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 en fazla %18 tasarruf sağlar: Pro planı aylık $19 yerine yılda $199 (aylık $17), Business planı ise aylık $249 yerine yılda $2599 (aylık $217) 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 Enterprise 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 cinsindendir ve satıcımız Creem bunları USD olarak tahsil eder. Ülkenize bağlı olarak ödeme sırasında KDV gibi vergiler eklenebilir. Kartınız başka bir para birimindeyse bankanız tutarı çevirir ve küçük bir döviz ücreti alabilir.
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 lisansları sunar; dizine eklediğimiz daha küçük kaynaklar da aynı modeli izler. Görseli ticari amaçla kullanmadan önce API yanıtındaki lisans alanını her zaman kontrol edin ve kaynak URL'sinde doğrulayın.
Görseller için ödeme yapıyor muyum?
Hayır. Pexafy görsel satmaz. Her sonuç, ücretsiz kullanılabilen bir kütüphaneden — Unsplash, Pexels, Pixabay, Kaboompics, Burst ve diğerleri — gelir ve o kütüphanenin kendi lisansı altında ona bağlantı verir. Planınız yalnızca arama hizmetinin bedelini öder: API istekleri, hız limitleri, API anahtarları ve destek. Kullanmadan önce her görselin lisansını kaynağında kontrol edin.
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. 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 9M+ 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