Face List - Add Face From Stream

Usługa:

Azure AI Services

Wersja interfejsu API:

1.0

Dodaj twarz do określonej listy twarzy, maksymalnie 1000 twarzy.
Aby poradzić sobie z obrazem zawierającym wiele twarzy, można określić twarz wejściową jako obraz z prostokątem targetFace. Zwraca on utrwalonego identyfikatoraFaceId reprezentującego dodaną twarz. Nie będzie przechowywany żaden obraz. Tylko wyodrębniona funkcja twarzy będzie przechowywana na serwerze do momentu wywołania FaceList — usuwanie twarzy lub FaceList — usuwanie.
Uwaga utrwaloneFaceId różni się od faceId wygenerowanego przez Face — wykrywanie.

• Wyższa jakość obrazu twarzy oznacza lepszą precyzję wykrywania i rozpoznawania. Należy wziąć pod uwagę wysokiej jakości twarze: przednie, jasne i rozmiar twarzy to 200x200 pikseli (100 pikseli między oczami) lub większy.
• Obsługiwane są formaty JPEG, PNG, GIF (pierwsza ramka) i BMP. Dozwolony rozmiar pliku obrazu wynosi od 1 KB do 6 MB.
• Prostokąt "targetFace" powinien zawierać jedną twarz. Zero lub wiele twarzy zostanie uznanych za błąd. Jeśli podany prostokąt "targetFace" nie zostanie zwrócony z Face — wykryj, nie ma gwarancji, że można wykryć i dodać twarz pomyślnie.
• Poza wykrywalnym rozmiarem twarzy (36x36 - 4096x4096 pikseli), dużą pozę głowy lub dużymi okluzjami spowoduje błędy.
• Dodawanie/usuwanie twarzy do/z tej samej listy twarzy jest przetwarzane sekwencyjnie i do/z różnych list twarzy są równolegle.
• Minimalny rozmiar twarzy wykrywalnej to 36x36 pikseli na obrazie nie większym niż 1920 x 1080 pikseli. Obrazy o wymiarach wyższych niż 1920 x 1080 pikseli będą potrzebować proporcjonalnie większego minimalnego rozmiaru twarzy.
• Można podać różne wartości "detectionModel". Aby użyć i porównać różne modele wykrywania, zapoznaj się z Jak określić model wykrywania.

POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces

Z parametrami opcjonalnymi:

POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces?overload=stream&userData={userData}&targetFace={targetFace}&detectionModel={detectionModel}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
Endpoint	path	True	string	Obsługiwane punkty końcowe usług Cognitive Services (protokół i nazwa hosta, na przykład: https://westus.api.cognitive.microsoft.com).
faceListId	path	True	string maxLength: 64 pattern: ^[a-z0-9-_]+$	Identyfikator odwołujące się do określonej listy twarzy.
detectionModel	query		DetectionModel	Nazwa modelu wykrywania. Model wykrywania służy do wykrywania twarzy na przesłanym obrazie. Nazwę modelu wykrywania można podać podczas wykonywania funkcji Face — Detect lub (Large)FaceList — Add Face or (Large)PersonGroup — Add Face (Duża)PersonGroup — Dodaj twarz. Wartość domyślna to "detection_01", jeśli wymagany jest inny model, jawnie określ go.
targetFace	query		integer[]	Prostokąt twarzy określający docelową twarz do dodania do osoby w formacie "targetFace=left,top,width,height". Np. "targetFace=10,10,100,100,100". Jeśli na obrazie znajduje się więcej niż jedna twarz, element targetFace jest wymagany do określenia twarzy do dodania. Brak elementu targetFace oznacza, że na całym obrazie wykryto tylko jedną twarz.
userData	query		string maxLength: 1024	Dane określone przez użytkownika dotyczące twarzy w dowolnym celu. Maksymalna długość to 1 KB.

Nagłówek żądania

Media Types: "application/octet-stream"

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string

Treść żądania

Media Types: "application/octet-stream"

Nazwa	Typ	Opis
Image	object (file)	Strumień obrazu.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	PersistedFace	Pomyślne wywołanie zwraca nowy utrwaloneFaceId.
Other Status Codes	APIError	Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Add face to face list from stream example

Przykładowe żądanie

HTTP

POST {Endpoint}/face/v1.0/facelists/sample_face_list/persistedfaces?overload=stream&userData={Customized user data}&targetFace=10,10,100,100&detectionModel=detection_01


"{Image stream in base 64 encoded format}"

Przykładowa odpowiedź

Kod stanu:

200

{
  "persistedFaceId": "B8D802CF-DD8F-4E61-B15C-9E6C5844CCBA"
}

Definicje

Nazwa	Opis
APIError	Informacje o błędzie zwrócone przez interfejs API
DetectionModel	Nazwa modelu wykrywania. Model wykrywania służy do wykrywania twarzy na przesłanym obrazie. Nazwę modelu wykrywania można podać podczas wykonywania funkcji Face — Detect lub (Large)FaceList — Add Face or (Large)PersonGroup — Add Face (Duża)PersonGroup — Dodaj twarz. Wartość domyślna to "detection_01", jeśli wymagany jest inny model, jawnie określ go.
Error	Treść błędu.
PersistedFace	Obiekt PersonFace.

APIError

Objekt

Informacje o błędzie zwrócone przez interfejs API

Nazwa	Typ	Opis
error	Error	Treść błędu.

DetectionModel

Wyliczanie

Nazwa modelu wykrywania. Model wykrywania służy do wykrywania twarzy na przesłanym obrazie. Nazwę modelu wykrywania można podać podczas wykonywania funkcji Face — Detect lub (Large)FaceList — Add Face or (Large)PersonGroup — Add Face (Duża)PersonGroup — Dodaj twarz. Wartość domyślna to "detection_01", jeśli wymagany jest inny model, jawnie określ go.

Wartość	Opis
detection_01
detection_02
detection_03

Error

Objekt

Treść błędu.

Nazwa	Typ	Opis
code	string
message	string

PersistedFace

Objekt

Obiekt PersonFace.

Nazwa	Typ	Opis
persistedFaceId	string (uuid)	UtrwaloneFaceId twarzy docelowej, która jest utrwalone i nie wygaśnie. Różni się od faceId utworzonego przez funkcję Face — wykryj i wygaśnie w czasie określonym przez faceIdTimeToLive po wywołaniu wykrywania.
userData	string maxLength: 1024	Dane dostarczone przez użytkownika dołączone do twarzy. Limit rozmiaru to 1 KB.