Udostępnij za pośrednictwem


Face List - Add Face From Stream

Dodaj twarz do określonej listy twarzy, maksymalnie 1000 twarzy.
Aby obsłużyć obraz zawiera 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 funkcji FaceList — Usuń twarz lub FaceList — Usuwanie .
Uwaga persistedFaceId różni się od faceId wygenerowanego przez face - Detect.

  • 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 200 x 200 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 jest zwracany z funkcji Face — Wykryj, nie ma gwarancji, że można pomyślnie wykryć i dodać twarz.
  • Poza wykrywalnym rozmiarem twarzy (36x36 - 4096x4096 pikseli), dużą pozę głowy lub duże okluzji spowodują awarie.
  • Dodawanie/usuwanie twarzy do/z tej samej listy twarzy jest przetwarzane sekwencyjnie i do/z różnych list twarzy są równoległe.
  • Minimalny rozmiar twarzy wykrywalnej to 36 x 36 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żywać i porównywać różne modele wykrywania, zobacz Jak określić model wykrywania.
POST {Endpoint}/face/v1.0/facelists/{faceListId}/persistedfaces
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

Identyfikator odwołujący się do określonej listy twarzy.

Wzorzec wyrażenia regularnego: ^[a-z0-9-_]+$

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 lub (Large)PersonGroup — Add Face (Duża)PersonGroup — Dodaj twarz. Wartość domyślna to "detection_01", jeśli wymagany jest inny model, określ go jawnie.

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". 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

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

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

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ź

{
  "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 lub (Large)PersonGroup — Add Face (Duża)PersonGroup — Dodaj twarz. Wartość domyślna to "detection_01", jeśli wymagany jest inny model, określ go jawnie.

Error

Treść błędu.

PersistedFace

Obiekt PersonFace.

APIError

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

Nazwa Typ Opis
error

Error

Treść błędu.

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 lub (Large)PersonGroup — Add Face (Duża)PersonGroup — Dodaj twarz. Wartość domyślna to "detection_01", jeśli wymagany jest inny model, określ go jawnie.

Nazwa Typ Opis
detection_01

string

detection_02

string

detection_03

string

Error

Treść błędu.

Nazwa Typ Opis
code

string

message

string

PersistedFace

Obiekt PersonFace.

Nazwa Typ Opis
persistedFaceId

string

UtrwaloneFaceId twarzy docelowej, która jest utrwalone i nie wygaśnie. Różni się od identyfikatora faceId utworzonego przez funkcję Face — wykryj i wygaśnie w czasie określonym przez faceIdTimeToLive po wywołaniu wykrywania.

userData

string

Dane dostarczone przez użytkownika dołączone do twarzy. Limit rozmiaru to 1 KB.