cURL-Anfrage
POST /api/v1/image/profilecurl -X POST "https://avatarlookup.com/api/v1/image/profile" \
-H "X-API-Key: sk_your_api_key" \
-F "file=@avatar.jpg"
product image_profile
Bild-Profilanalyse
Laden Sie ein beliebiges Bild hoch und erhalten Sie seine Porträtattribute: geschätztes Alter, Geschlecht, Bildtyp, Haarfarbe und Hautton.
Nutzungskosten: 0,002 $ / PrüfungAntwortmodus: Synchron
POST /api/v1/image/profileAPI-Vertrag
Eine Anfrage, sofortiges Ergebnis
Laden Sie ein Bild als Multipart-Dateifeld namens file hoch. Die Authentifizierung erfolgt über Ihren API-Schlüssel.
Kopieren Sie den folgenden curl-Befehl und ersetzen Sie nur den Beispiel-API-Schlüssel durch Ihren eigenen.
Antwort
200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "image_profile",
"identifier": "img:7013df96c540904a4b7ba295e9162ab2",
"category": "individual portrait",
"age": 39,
"gender": "male",
"skin_color": "white",
"hair_color": "brown"
}
}So nutzen Sie es
Drei wichtige Punkte zur Bildanalyse
Das Bild selbst senden
Ein Bild pro Anfrage, als Multipart-Dateifeld namens file. JPEG, PNG, WebP oder GIF, bis zu 2 MB. Es ist keine Nummer oder E-Mail beteiligt – die Antwort beschreibt das Bild, nicht ein Konto.
Zuerst category lesen
category gibt an, was das Bild zeigt. Bilder von Haustieren, Cartoons, Landschaften oder Gegenständen werden analysiert und berechnet, enthalten aber keine Felder für Alter und Geschlecht.
Wir behalten das Bild nicht
Das Bild wird direkt an die Analyse übergeben und nie gespeichert. identifier ist ein aus dem Bildinhalt abgeleiteter Fingerabdruck, sodass dasselbe Bild immer denselben Wert ergibt – nutzen Sie ihn auf Ihrer Seite zur Deduplizierung.
Was geprüft wird
Was liefert Bild-Profilanalyse?
Gelieferte Felder
identifier· string — Aus dem Inhalt abgeleiteter Fingerabdruck des übermittelten Bildes. Dasselbe Bild ergibt immer denselben Wert.category· string — Was das Bild zeigt: individual portrait, group photo, game avatar, cartoon avatar, landscape, pet avatar oder object. unknown, wenn kein Porträt erstellt werden konnte.age· integer — Geschätztes Alter als ganze Zahl, auf etwa 3 Jahre genau und auf 0–80 begrenzt. Entfällt, wenn es nicht geschätzt werden konnte (zum Beispiel, wenn kein Geschlecht bestimmt wurde).gender· string — male, female oder unknown.skin_color· string — Beschreibender Hautton, zum Beispiel white, east_asian oder hispanic. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.hair_color· string — Beschreibende Haarfarbe, zum Beispiel black, brown, blond oder gray white. Behandeln Sie die Werte als offene Menge; unknown, wenn nicht bestimmt.
Ideal für
Nutzen Sie dieses Produkt, wenn Sie Folgendes brauchen
Bestehende Profilbild-Archive
Ergänzen Sie historische Profilbilder und Bilder um konsistente Fingerabdrücke, Bildtypen und Porträtattribute und reduzieren Sie so manuelles Durchsehen und Klassifizieren.
Zielgruppenprofilierung
Ordnen Sie Assets nach Bildtyp, geschätztem Alter, Geschlecht, Haar- und Hautfarbe, um die Zusammensetzung einer Sammlung zu untersuchen und Datensätze später wiederzufinden.
Vorsortierung für die Inhaltsmoderation
Erkennen Sie zuerst Porträts, Gruppenfotos, Cartoons, Haustiere, Landschaften und Gegenstände und leiten Sie dann jedes Bild in den passenden manuellen Prüfablauf.
Datenanreicherung
Schreiben Sie Analyseergebnisse in Kunden-, Inhalts- oder Asset-Daten, damit Datensätze, die nur ein Bild hatten, strukturierte Felder zum Filtern erhalten.
Kurze Antwort
Was ist Bildanalyse?
Bild-Profilanalyse liefert die Attribute des Bildes selbst: Bildtyp, Geschlecht, geschätztes Alter, Hautton und Haarfarbe. Senden Sie ein Bild per POST an den Bild-Endpunkt als Multipart-Dateifeld namens file und lesen Sie die Porträtattribute auf der obersten Ebene derselben API-Antwort. Es ist keine Kennung erforderlich.
Klare Grenzen
Was nicht geliefert wird
- Es beschreibt das Bild, nicht eine Person oder ein Konto: Das Ergebnis enthält keine Aussage zu Registrierung, Erreichbarkeit oder Identität.
- Alter, Geschlecht, Hautton und Haarfarbe sind algorithmische Schätzungen aus einem einzelnen Bild. Behandeln Sie sie nur als unterstützende Signale – nie als Grundlage für Identitätsprüfung, diskriminierende Filterung oder folgenschwere Entscheidungen.
- Bilder ohne menschliches Motiv liefern trotzdem ein Ergebnis und werden trotzdem berechnet. Kostenlos sind nur ein Dienstfehler, ein Bild, das wir nicht abrufen oder lesen können, oder eine Modellantwort ganz ohne Felder.
Produkt-FAQ
Fragen zu Bildanalyse
Was liefert Bild-Profilanalyse?
Es liefert die Attribute des Bildes selbst: Bildtyp, Geschlecht, geschätztes Alter, Hautton und Haarfarbe in derselben synchronen Antwort.
Wie funktioniert die Abrechnung für Bildanalyse?
Guthaben wird für jedes Bild berechnet, das mit einem Ergebnis zurückkommt, einschließlich Haustieren, Cartoons und Landschaften. Kostenlos sind nur ein Dienstfehler, ein Bild, das wir nicht abrufen oder lesen können, oder eine Modellantwort ganz ohne Felder.
Welche Bildformate und -größen werden akzeptiert?
JPEG, PNG, WebP oder GIF, bis zu 2 MB pro Bild. Der Typ wird anhand des Dateiinhalts bestimmt, nicht anhand der Endung.
Speichern Sie das Bild?
Nein. Das Bild wird direkt an die Analyse übergeben und nie auf Festplatte oder in einen Objektspeicher geschrieben. Nur der aus seinem Inhalt abgeleitete Fingerabdruck wird im Prüfdatensatz gespeichert.
Verwandte Produkte
Weitere Produkte zur Profilbildanalyse
WhatsApp-ProfilbildanalysePrüfen Sie, ob eine Nummer ein WhatsApp-Profilbild hat, erhalten Sie die Bild-URL und lesen Sie die Porträtattribute dieses Profilbilds.
E-Mail-ProfilbildanalysePrüfen Sie, ob ein E-Mail-Konto ein Profilbild hat, und lesen Sie dessen Porträtattribute. Deckt Gmail, Yandex und Mail.ru ab.Jetzt mit der Prüfung beginnen
Erstellen Sie ein Konto, um alle Produkte über das SaaS-Dashboard oder die API zu nutzen: Echtzeitprüfungen und asynchrone Massenprüfungen greifen auf dasselbe Guthaben zu.