> Ters yüz arama için AI yüz tarama API'si. Bir fotoğraf gönderin, o yüzün göründüğü herkese açık profilleri her biri güven puanıyla alın. Arama başına bir kredi, abonelik yok, aylık taahhüt yok. **AI YÜZ TARAMA API** # AI YÜZ TARAMA, KENDİ KODUNUZDAN. Herkese açık web üzerinde **ters yüz arama API'si**. Bir yüz fotoğrafı gönderin; o yüzün göründüğü sayfaları ve profilleri, her biri bir güven puanı ve bağlantısıyla geri alın. Arama başına bir kredi, fiyat dolar, abonelik ve aylık taahhüt yok. Satış görüşmesi yok · Aylık taahhüt yok · Krediler sona ermez - Sonuç yaklaşık bir dakikada - Arama başına bir kredi - REST + JSON, kurulacak bir şey yok - Kendi motorumuz, bayilik değil **API NE YAPIYOR** ## BİR FOTOĞRAF GİRER, HERKESE AÇIK HER EŞLEŞME ÇIKAR. Panelin çalıştığı motorun aynısı, sonuçların aynısı. API kırpılmış bir paket değil. **TERS YÜZ ARAMA** ### Dosyayı değil yüzü eşliyor. Sıradan bir ters görsel arama aynı dosyanın kopyalarını buluyor. Bu, yüzü eşliyor: aynı kişinin başka bir fotoğrafı — başka kıyafet, başka yıl — yine sonuç olarak dönüyor. **GÜVEN PUANI** ### Her eşleşme bir sayı taşıyor. Her sonucun 50 ile 100 arasında bir benzerlik puanı ve bir bandı var: 70'ten olası, 80'den güçlü, 90'dan neredeyse kesin. Hiçbir sonuç bir hüküm olarak dönmüyor. **SOSYAL HESAPLAR** ### Sadece sayfa değil, hesap. Adres bir hesaba aitse kullanıcı adı ve platform ayrı alanlar olarak dönüyor — sizin tarafta URL ayrıştırmak gerekmiyor. **KENDİ MOTORUMUZ** ### Bayilik değil. Trace kendi yüz arama servisini çalıştırıyor. Bir aramanın dolar değil sent tutmasının, ve hız sınırının sizin için yükseltebileceğimiz bir sayı olmasının sebebi bu. **HIZLI BAŞLANGIÇ** ## BAŞTAN SONA ÜÇ ÇAĞRI. Kimlik doğrulama tek bir başlık. Kurulacak bir SDK ve el sıkışma yok. ### Aramayı başlat Çok parçalı gövde, alan adı `image`. JPEG, PNG ya da WebP, en fazla 8 MB, kısa kenarı en az 200px. `Idempotency-Key` isteğe bağlı ve tekrar denemeyi güvenli yapıyor. ```bash curl -X POST https://traceaifacescan.app/api/v1/scans \ -H "Authorization: Bearer trk_live_..." \ -H "Idempotency-Key: $(uuidgen)" \ -F image=@face.jpg ``` **202 ACCEPTED** ```json { "id": "01m0jr1j5cbhwqsnt5qjx3zyd8", "status": "queued", "progress": 0, "locked": false, "match_count": 0, "credits_remaining": 9 } ``` ### Bitene kadar yokla Bir arama yaklaşık 25-45 saniye sürüyor. `status` alanı `done` ya da `failed` olana kadar bir-iki saniyede bir yoklayın. ```bash curl https://traceaifacescan.app/api/v1/scans/01m0jr1j5cbhwqsnt5qjx3zyd8 \ -H "Authorization: Bearer trk_live_..." ``` **200 OK** ```json { "status": "done", "progress": 100, "locked": false, "match_count": 2, "matches": [ { "score": 88, "tier": "strong", "platform": "x", "handle": "@alexrivers88", "url": "https://x.com/alexrivers88", "preview_url": ".../scans/01m0.../previews/0" } ] } ``` ### Krediyi harca Kredisi olmayan bir hesapta açılan arama `locked: true` ve eşleşmesiz dönüyor — hiçbir şey aranmadı. Kilidi açmanın ayrı bir çağrı olması bilinçli: aramaların listesini dolaşan bir betik bakiyenizi kazara boşaltamamalı. ```bash curl -X POST \ https://traceaifacescan.app/api/v1/scans/01m0.../reveal \ -H "Authorization: Bearer trk_live_..." ``` **UÇLAR** ## BÜTÜN YÜZEY. Yedi uç. Makine okunur tanım [openapi.json](https://traceaifacescan.app/openapi.json) adresinde, yanıt gövdeleriyle tam referans ise [dokümanda](https://traceaifacescan.app/docs). - **POST** — `/v1/scans` — Bir fotoğraftan arama başlatır. - **GET** — `/v1/scans/{id}` — Durum, ilerleme ve eşleşmeler. - **GET** — `/v1/scans` — Aramalarınız, sayfalı. - **POST** — `/v1/scans/{id}/reveal` — Bir kredi harcar ve gerçek aramayı çalıştırır. - **GET** — `/v1/scans/{id}/previews/{n}` — Bir eşleşmenin yüz küçük resmi. - **DELETE** — `/v1/scans/{id}` — Aramayı, görselini ve önizlemelerini siler. - **GET** — `/v1/account` — Kredi bakiyeniz. **HATALAR VE LİMİTLER** ## ÖNGÖRÜLEBİLİR HATALAR. Hatalar `application/problem+json` olarak ve sabit bir `code` dizgesiyle dönüyor. Mesaja değil koda bakın. - **402** — `insufficient_credits` — Kredi kalmadı. Hiçbir şey aranmadı, hiçbir şey tahsil edilmedi. - **404** — `no_face_detected` — Görselde yüz yok. Tekrar denemek değil, başka bir fotoğraf gerekiyor. - **429** — `rate_limited` — Yalnızca arka arkaya başarısız kimlik doğrulamadan sonra. `Retry-After` ne zaman diyor. - **401** — `unauthorized` — Anahtar eksik, yanlış ya da iptal edilmiş. - **503** — `provider_unavailable` — Bizim tarafımız. Başarısız bir arama için rezerve edilen kredi her zaman iade ediliyor. ### Limitler - **İstek hızı sınırı yok.** Okuma istekleri sayılmıyor, dakikalık bir tavan yok. - Gerçek sınırınız **kredi bakiyeniz**: arama bir krediye mal oluyor, okuma hiçbir şeye. - Görseller en fazla **8 MB**, kısa kenarı en az **200px**. - Aramalar ve görselleri **30 gün** sonra siliniyor. `DELETE` anında yapıyor. **FİYAT** ## BİR KREDİ, BİR ARAMA. Panelin kullandığı kredilerin aynısı, aynı bakiyeden. Abonelik yok, aylık taahhüt yok, krediler sona ermiyor. 100 kredilik paket API'nin üzerine kurulduğu paket. Telegram Stars ya da kripto ile alınıyor — [kredi paketlerine](https://traceaifacescan.app/#pricing) bakın. En büyük paketin ötesinde hacim mi gerekiyor? [Bize yazın](https://docs.google.com/forms/d/e/1FAIpQLSdVeyYm3BLWkEnmHToK5_JQynOHCctKTxMkBJp3PJf-pmaLYQ/viewform). **DÜRÜST SINIRLAR** ## BU API'NİN YAPMAYACAĞI ŞEYLER. **Bir kimlik servisi değil.** Bir eşleşme, iki görsel arasındaki benzerlik puanıdır; birinin kim olduğuna dair bir beyan değil. Yanıtta ad, adres, telefon ya da herhangi bir kayıt yok — yalnızca herkese açık adresler ve bir sayı. **Boş sonuç, yokluk kanıtı değil.** Ulaşabildiğimiz herkese açık web kısmında bir şey bulunmadığı anlamına geliyor. Kişinin herkese açık bir fotoğrafı yoksa bulunacak bir şey de yok, ve bunu hiçbir API değiştiremez. **Girişin arkasındaki hiçbir şeye dokunulmuyor.** Her sonuç, zaten herkese açık olan bir sayfa. **Özgeçmiş kontrolü, işe alım, kredi, sigorta, gözetim ya da kolluk amacıyla kullanılamaz**, ve reşit olmayanlara karşı kullanılamaz. Yalnızca arama hakkına sahip olduğunuz fotoğrafları gönderin. Bu [Kullanım Şartları](https://traceaifacescan.app/tr/kosullar/)'nda yazıyor ve uygulanıyor — böyle kullanılan bir anahtar iptal ediliyor. **SSS** ## GELİŞTİRİCİLERİN İLK SORDUĞU ŞEYLER. ### AI yüz tarama API'si nedir? Bir yüz fotoğrafı alıp o yüzün herkese açık internette göründüğü diğer yerleri döndüren bir HTTP API'sidir. Görsel dosyalarını karşılaştıran ters görsel aramanın aksine, AI yüz taraması yüz geometrisini karşılaştırır — yani aynı kişiyi bambaşka bir fotoğrafta da eşler. Trace'in sürümü JSON yanıt veren bir REST API'si: aramayı başlatmak için bir POST, eşleşmeleri okumak için bir GET. ### API üzerinden bir yüz araması ne kadar? Arama başına bir kredi. Krediler dolar fiyatlı paketler hâlinde alınıyor — 3 kredi 5 dolardan, 100 kredi 120 dolara kadar. Abonelik, aylık taahhüt ve son kullanma tarihi yok. API panelle aynı bakiyeyi harcıyor. ### Ücretsiz katman ya da deneme var mı? API'de ücretsiz arama yok. Kredisi olmayan bir hesabın API isteği aramayı oluşturuyor ama aramıyor: kilitli ve eşleşmesiz dönüyor. Panel, giriş yapmış ve kredisi olmayan ziyaretçiye bitmiş bir dosyanın neye benzediğini göstermek için sabit bir örnek sonuç gösteriyor; API bunu bilinçli olarak hiç döndürmüyor — bir yer tutucu, bir betiğin üzerine kod yazacağı şeydir. ### Bir arama ne kadar sürüyor? Uçtan uca yaklaşık 25-45 saniye, bazen 90'a kadar. API'nin asenkron olmasının sebebi bu: POST hemen 202 ve bir id dönüyor, siz yokluyorsunuz. Bir HTTP isteğini bir dakika açık tutmak, kopan bir bağlantıyı iptal edilmiş bir arama hâline getirirdi. ### Dosya yüklemek yerine görsel adresi verebilir miyim? v1'de hayır. URL kabul etmek API'yi bir SSRF vekiline çevirirdi — çağıranın adına, kendi ağımızın içinden rastgele adreslere istek atmak olurdu. Gelirse, izin listesi ve özel IP aralıklarının reddiyle gelecek. ### API'de hız sınırı var mı? Yok. Kodunuz ne kadar hızlıysa o kadar hızlı çağırabilirsiniz; okuma istekleri sayılmıyor ve dakikalık bir tavan yok. Sizi sınırlayan tek şey kredi bakiyeniz: arama bir krediye mal oluyor, okuma hiçbir şeye. Geriye tek bir güvenlik freni kalıyor ve geçerli anahtarı olan onu hiç görmüyor — aynı adresten arka arkaya BAŞARISIZ kimlik doğrulama denemesi yavaşlatılıyor, yani anahtar tahmin etmek pahalı kalıyor. ### Yüz arama API'si kullanmak yasal mı? Tamamen ne için ve nerede kullandığınıza bağlı. Kendi platformunuzdaki bir fotoğrafın onu kullanan kişiye ait olduğunu doğrulamak, bir yüz veri tabanı kurmakla aynı şey değil. Yüz verisi GDPR ve KVKK kapsamında özel nitelikli veri ve bize gönderdiğiniz her şeyin veri sorumlusu sizsiniz. Kullanım Şartları'nı okuyun: özgeçmiş kontrolü, işe alım, kredi, sigorta, gözetim ve kolluk kullanımı kapsam dışı. **AI YÜZ TARAMA API** ## TEK ÇAĞRIYLA BAŞLAYIN. Panelde bir anahtar oluşturun, ilk curl hemen çalışır.