Wie es funktioniert
Ihre Assets an einer öffentlich zugänglichen URL hosten
Laden Sie Ihre Video-, Foto- und Audiodateien hoch, damit unsere Server diese abrufen können.
Senden Sie eine API-Anfrage mit den entsprechenden Parametern
Referenzieren Sie Ihre gehosteten Assets und geben Sie den gewünschten Modus an (Standard oder Präzision).
Warten oder Status abfragen
Verwenden Sie unseren Webhook-Callback oder poll die API mit Ihrer Job-ID, bis die Verarbeitung abgeschlossen ist.
Nutzungseinschränkungen:
- Sie können bis zu 10 gleichzeitige Jobs haben (einschließlich wartender Anfragen).
- Es werden nur Einzelgesicht-Videos oder -Fotos unterstützt.
- Geschätzte Wartezeit: 1–120 Minuten, abhängig von der Systemauslastung.
- Verarbeitungszeit im Standardmodus: ~10 Minuten.
- Verarbeitungszeit im Präzisionsmodus: ~20 Minuten.
Wenn ein Video oder Foto mehrere Gesichter enthält, wird nur das größte erkannte Gesicht synchronisiert.
API-Fehlercodes
| Code | Beschreibung |
|---|---|
| 5 | Ungültige Anfrageparameter. |
| 7 | Keine Berechtigung zur Anfrage. |
| 104 | Unzureichendes Guthaben. |
| 814 | Ihr Konto ist kein Mitglied und darf die API nicht aufrufen. |
| 1000 | Interner Serverfehler. |
| 1301 | Callback-Herausforderung fehlgeschlagen. |
| 1302 | API-Schlüssel wurde widerrufen. |
| 1304 | API-Schlüssel hat die maximale Anzahl gleichzeitiger Anfragen erreicht. |
| 1502 | Ihr Audiotreiber ist entweder ungültig oder kann nicht heruntergeladen werden. |
| 1503 | Ihr Konto ist nicht berechtigt, die API aufzurufen. |
| 1305 | Nur der Studio-Plan ist erlaubt. |
Job-Fehlercodes
| Code | Beschreibung |
|---|---|
| 999 | Datei konnte nicht heruntergeladen werden. |
| 20403 | Nicht genügend Gesichter. |
| 20407 | Die Anzahl der Gesichtspunkte ist zu hoch. |
| 20408 | Die Bild-zu-Video-Gesichtserkennung wurde nicht bestanden. |
| 20601 | Es sind keine Gesichter im Bild. |
| 20602 | Unbekanntes Bildformat. |
| 20611 | Video löst Fluiditätslimit aus. |
| 20613 | Videoeingabe generiert empfindlich auf Bilder. |