Echtes oder KI-Gesicht API

API-Einführung

Prüfe, ob ein Gesicht echt oder KI-generiert wirkt, einschließlich Anzeichen synthetischer Gesichter, KI-Gesichtstausch und starker KI-gestützter Retusche. Das Modell analysiert das gesamte Bild und liefert einen KI-Generierungs-Risikowert.

Anfrageparameter: Unterstützte Porträtdateien bis 10 MB.
Antwortparameter: Ein höherer Wert bedeutet stärkere KI-Generierungssignale im gesamten Bild. Nutzen Sie ihn als Prüfsignal, nicht als Nachweis, dass das Bild echt ist.

API-Einführung

Prüfen, ob ein Profilfoto echt oder KI-generiert wirkt
Selfies und Porträts auf Signale synthetischer Gesichter prüfen
Möglichen KI-Gesichtstausch oder starke KI-gestützte Retusche erkennen

Authentifizierung

Ersetzen Sie {your-api-domain} durch den im Kontodashboard angezeigten API-Endpoint.

Authentifizieren Sie Anfragen mit dem API-Endpoint Ihres Kontos und einem Bearer-Token. Nach dem Kauf von API-Credits können Sie Endpoint und Token im Kontodashboard einsehen. Halten Sie Ihr Token geheim und committen Sie es niemals in öffentliche Repositories.

POSThttps://api.imgauth.com/v1/real-or-ai-face

Authorization: Bearer {YOUR_API_TOKEN}
Content-Type: application/json; charset=UTF-8

Anfrageparameter

Parameter	Typ	✓	Beschreibung
image	string	✓	Unterstützte Porträtdateien bis 10 MB.

Beispiel-HTTP-Anfrage

{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}

Antwortparameter

Parameter	Typ	Beschreibung
code	integer	Referenz für API-Antwortcodes
request_id	string	Verwenden Sie diese Beispiele, um Ihre Integration zu erstellen und zu debuggen
data.ai_generated	boolean \| null	Wahrscheinlich KI-generiertes oder stark KI-bearbeitetes Gesichtsbild / Kein starkes KI-Signal erkannt
data.ai_generation_score	number \| null	Ein höherer Wert bedeutet stärkere KI-Generierungssignale im gesamten Bild. Nutzen Sie ihn als Prüfsignal, nicht als Nachweis, dass das Bild echt ist.
data.review_status	"likely_ai" \| "likely_not_ai" \| "review"	Manuelle Prüfung empfohlen
data.analysis_scope	"portrait"	Prüfe, ob ein Gesicht echt oder KI-generiert wirkt, einschließlich Anzeichen synthetischer Gesichter, KI-Gesichtstausch und starker KI-gestützter Retusche. Das Modell analysiert das gesamte Bild und liefert einen KI-Generierungs-Risikowert.

Beispielantworten

{
  "code": 0,
  "request_id": "req_01...",
  "data": {
    "ai_generated": true,
    "ai_generation_score": 0.89,
    "review_status": "likely_ai",
    "analysis_scope": "portrait"
  }
}

Fehlercodes

400INVALID_REQUESTAPI messages werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.

401INVALID_API_KEYAPI messages werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.

402CREDITS_EXHAUSTEDAPI messages werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.

403API_KEY_INACTIVE / API_KEY_EXPIREDAPI messages werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.

413PAYLOAD_TOO_LARGEAPI messages werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.

415UNSUPPORTED_IMAGEAPI messages werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.

502UPSTREAM_ERRORAPI messages werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.

504UPSTREAM_TIMEOUTAPI messages werden als rohe Upstream-Werte angezeigt, damit sie exakt den Antworten in Produktion entsprechen.

Code-Beispiele

curl -X POST "https://api.imgauth.com/v1/real-or-ai-face" \
  -H "Authorization: Bearer rh_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "image": "<BASE64_IMAGE_WITHOUT_PREFIX>"
}'