TRACE / AI YÜZ TARAMA API

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.

API anahtarı al Tam referansı oku

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

curl -X POST https://traceaifacescan.app/api/v1/scans \
  -H "Authorization: Bearer trk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -F [email protected]

{
  "id": "01m0jr1j5cbhwqsnt5qjx3zyd8",
  "status": "queued",
  "progress": 0,
  "locked": false,
  "match_count": 0,
  "credits_remaining": 9
}

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.

curl -X POST https://traceaifacescan.app/api/v1/scans \
  -H "Authorization: Bearer trk_live_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -F [email protected]

202 ACCEPTED

{
  "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.

curl https://traceaifacescan.app/api/v1/scans/01m0jr1j5cbhwqsnt5qjx3zyd8 \
  -H "Authorization: Bearer trk_live_..."

200 OK

{
  "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"
    }
  ]
}

03
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ı.
```
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 adresinde, yanıt gövdeleriyle tam referans ise dokümanda.

POST/v1/scansBir fotoğraftan arama başlatır.
GET/v1/scans/{id}Durum, ilerleme ve eşleşmeler.
GET/v1/scansAramalarınız, sayfalı.
POST/v1/scans/{id}/revealBir 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/accountKredi 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.

402insufficient_creditsKredi kalmadı. Hiçbir şey aranmadı, hiçbir şey tahsil edilmedi.
404no_face_detectedGörselde yüz yok. Tekrar denemek değil, başka bir fotoğraf gerekiyor.
429rate_limitedYalnızca arka arkaya başarısız kimlik doğrulamadan sonra. Retry-After ne zaman diyor.
401unauthorizedAnahtar eksik, yanlış ya da iptal edilmiş.
503provider_unavailableBizim 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 bakın. En büyük paketin ötesinde hacim mi gerekiyor? Bize yazın.

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ı'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ışı.