Fintech
Identitätsprüfungs-Pipelines
KYC- und Onboarding-Dienste rufen die API aus ihrem Verifizierungs-Workflow auf, um zu bestätigen, dass das Foto auf einem eingereichten Ausweis mit der Person an anderer Stelle im öffentlichen Web übereinstimmt.
FaceSearch REST API
Gesichtersuche aus jeder Sprache auslösen
Die FaceSearch REST API bietet Entwicklern eine schlanke, stabile Oberfläche für die umgekehrte Gesichtsbildsuche: Foto hochladen, Status abfragen, Ergebnisse lesen.
Tausende Suchen
Weltweit verfügbar
256-Bit-Verschlüsselung
Hohe Treffergenauigkeit
Die FaceSearch REST API bietet Entwicklern eine schlanke, stabile Oberfläche für die umgekehrte Gesichtsbildsuche: Foto hochladen, Status abfragen, Ergebnisse lesen.
- Womit Sie suchen
- Ein Foto, auf dem ein Gesicht zu sehen ist. Eine Textsuche gibt es nicht.
- Was Sie zurückbekommen
- Sortierte Seiten mit einem übereinstimmenden Gesicht, jeweils mit Konfidenzwert und Quelllink.
- Wie ein Treffer zustande kommt
- Gesichtserkennung. Das Gesicht wird in ein Embedding — eine Zahlenreihe — umgewandelt und über Abstände verglichen, nicht über Dateiname, Bildunterschrift oder Pixel. Wie funktioniert Gesichtserkennung?
- Kosten pro Suche
- 3 Credits. Neue Konten starten mit 3 Gratis-Credits, ganz ohne Kreditkarte.
- Speicherdauer der Fotos
- Uploads werden innerhalb von 24 Stunden nach Abschluss der Suche gelöscht.
So funktioniert die REST API
Drei Schritte vom leeren Terminal zum ersten Suchergebnis.
API-Schlüssel anlegen
Im Dashboard anmelden und einen Schlüssel erzeugen. Der Klartext wird genau einmal angezeigt. Speichern Sie ihn im Secrets-Manager und committen Sie ihn niemals ins Repository.
Bild per POST senden
curl -F [email protected] https://facesearch.net/api/v1/search mit dem Bearer-Header ausführen. Der Endpunkt liefert binnen einer Sekunde eine jobId zurück.
Bis zum Abschluss abfragen
Alle 3 bis 5 Sekunden GET /api/v1/search/{jobId} aufrufen. Sobald der Status completed lautet, enthält die Antwort die Quell-URLs, Thumbnails und Confidence-Scores.
Funktionen der REST API
Alles, was Sie brauchen, um Gesichtersuche in ein produktives Backend zu integrieren.
OpenAPI 3.1 Spezifikation
Ein handgepflegtes OpenAPI-Dokument unter /api/v1/openapi.json, das jedes typensichere SDK antreibt, vom Postman-Import bis zu generierten Clients in 20+ Sprachen.
Idempotente Retries
Senden Sie einen Idempotency-Key-Header gemäß RFC 9110 und der Server liefert für doppelte Einreichungen dieselbe jobId. Ohne Header leitet der Server automatisch einen Content-Hash ab, sodass naive Retries stets sicher sind.
Kontingente pro Schlüssel
Jeder API-Schlüssel kann ein optionales Tages- und Monatslimit tragen. Ein geleakter Schlüssel kann Ihr Guthaben nicht leeren, weil das Kontingent mit Redis-Geschwindigkeit durchgesetzt wird und ein Postgres-Fallback existiert.
Granulare Rate Limits
Jede Antwort enthält die Header X-RateLimit-Remaining und X-RateLimit-Reset. 429-Antworten liefern Retry-After, sodass Sie präzise wissen, wann Sie es erneut versuchen können.
Gemeinsamer Credit-Pool
Die API nutzt denselben Credit-Pool wie die Web-Oberfläche. Eine einmalige Aufladung im Dashboard versorgt beide Welten, ohne neue Abrechnungs-SKU.
Berechenbare Fehler
Jede Fehlerantwort ist ein stabiler Umschlag: code, message, status. Codes wie INSUFFICIENT_CREDITS oder RATE_LIMITED ändern sich nie, Ihre Fehlerbehandlung darf langweilig und zeitlos bleiben.
Kopieren. Einfügen. Ausliefern.
Jeder Aufruf der FaceSearch-API ist eine einzige HTTP-Anfrage. Hier ist derselbe Ablauf 'Gesichtssuche einreichen' in fünf Sprachen.
Einzeiler im Terminal
# 1. Submit a face image for search
curl -X POST https://facesearch.net/api/v1/search \
-H "Authorization: Bearer fs_live_YOUR_KEY" \
-H "Idempotency-Key: submit-$(date +%s)" \
-F "image=@/path/to/face.jpg" \
-F "consent=true"
# 2. Poll for completion
curl https://facesearch.net/api/v1/search/JOB_ID \
-H "Authorization: Bearer fs_live_YOUR_KEY"
# 3. Check your credit balance
curl https://facesearch.net/api/v1/credits \
-H "Authorization: Bearer fs_live_YOUR_KEY"Wer auf der REST API aufbaut
Die API treibt Teams an, die Gesichtersuche in großem Maßstab brauchen.
Safety
Automatisierte Moderation
Trust-&-Safety-Teams verdrahten die API mit ihrer Incident-Response-Pipeline, sodass eskalierte User-Reports in Sekunden statt in Stunden mit Kontext angereichert werden.
Research
Investigative Recherche
Investigativjournalisten und OSINT-Forscher skripten Bulk-Suchen aus Jupyter-Notebooks und nutzen den Idempotency-Key-Header, um Batch-Läufe über Nacht zu deduplizieren.
Vertrauenswürdige Gesichtssuch-Plattform
10 MB
Maximale Uploadgröße
Bilder als JPEG, PNG oder WebP
24 h
Speicherdauer der Bilder
Uploads werden automatisch gelöscht
24/7
Suchverfügbarkeit
Jederzeit suchen
3
Credits pro Suche
Einfache, transparente Preise
Was Entwickler über die API sagen
Echtes Feedback von Teams, die FaceSearch in produktive Workflows integrieren.
“Die hybride Idempotency-Key-Policy ist die beste, die ich bei einer API je gesehen habe. Naive Retries funktionieren einfach, und explizite Keys geben uns volle Kontrolle, wenn wir wirklich frische Suchen brauchen.”
“Wir haben FaceSearch an einem Nachmittag in unsere Moderationspipeline eingebunden. Dank der Kontingente pro Schlüssel können wir verschiedenen Teams eigene Keys geben, ohne dass jemand versehentlich den Pool leert.”
“Aus der OpenAPI-Spezifikation habe ich mit einem Befehl einen typisierten Python-Client generiert. Fehlercodes ändern sich nie, meine Pipeline ist seit Monaten langweilig, im besten Sinne.”
Einfache, transparente Preise
Wählen Sie den Plan, der zu Ihren Bedürfnissen passt. Keine versteckten Gebühren, jederzeit kündbar.
BELIEBTESTE
PRO
$29/Monat
Für Profis und Power-User
- 60 Credits pro Monat ($0.48 pro Credit)
- Gesichtssuche
- Suchverlauf
- Profil als PDF exportieren
Oder Credit-Pakete kaufen
Pay as you go
Starter
3Credits
$6
$2.00/Credit
SPAREN SIE 20%
Basic
30Credits
$24
$0.80/Credit
SPAREN SIE 31%
Standard
100Credits
$69
$0.69/Credit
SPAREN SIE 34%
Pro
300Credits
$199
$0.66/Credit
SPAREN SIE 40%
Enterprise
1000Credits
$599
$0.60/Credit
REST API FAQ
Alles, was Entwickler fragen, bevor sie den ersten Request schreiben.
Jetzt mit der REST API loslegen
Erstellen Sie einen kostenlosen API-Schlüssel, fügen Sie den curl-Einzeiler ein und führen Sie Ihre erste Suche in unter zehn Minuten aus.
API-Schlüssel erstellen
Keine Kreditkarte erforderlich
