Face List Operations - Create Large Face List

  • Reference
Služba:
Azure AI Services
Verze rozhraní API:
v1.2-preview.1

Vytvořte prázdný velký seznam tváří se zadaným uživatelem largeFaceListId, názvem, volitelným objektem userData a recognitionModel.
Velký seznam tváří je seznam tváří, až 1 000 000 tváří a používá se výraz "Najít podobné z velkého seznamu tváří".

Po vytvoření by měl uživatel k importu tváří použít přidat velkou tvář seznamu tváří a natrénovat velký seznam tváří, aby byl připravený na "Najít podobné". Neuloží se žádná image. Na serveru budou uloženy pouze extrahované funkce tváře, dokud se nevolá odstranit velký seznam tváří.

"Najít podobné" se používá pro scénář, jako je hledání tváří podobných celebrit, podobné filtrování tváře nebo jako lehká identifikace tváře. Pokud je ale skutečné použití k identifikaci osoby, použijte skupinu osob / velkou skupinu osob a "Identifikovat".

Poznámka

    • Kvóta předplatného úrovně Free: 64 Rozsáhlých seznamů tváří
    • Kvóta předplatného úrovně S0: 1 000 000 rozsáhlých seznamů tváří.
PUT {endpoint}/face/{apiVersion}/largefacelists/{largeFaceListId}

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
apiVersion
 path True

string

Verze rozhraní API
endpoint
 path True

string

uri

Podporované koncové body služeb Cognitive Services (protokol a název hostitele, například: https://{název_prostředku}.cognitiveservices.azure.com).
largeFaceListId
 path True

string

Platný znak je písmeno v malých písmenech nebo číslici nebo číslici nebo "-" nebo '_', maximální délka je 64.

Vzor regulárního výrazu: ^[a-z0-9-_]+$

Text požadavku

Name Vyžadováno Typ Description
name True

string

Uživatelem definované jméno, maximální délka je 128.
recognitionModel

RecognitionModel

Model rozpoznávání přidružený k tomuto seznamu tváří. Mezi podporované hodnoty recognitionModel patří recognition_01, recognition_02, recognition_03 a recognition_04. Výchozí hodnota je recognition_01. "recognition_04" se doporučuje, protože jeho přesnost je vylepšená u tváří s maskami na sobě ve srovnání s "recognition_03" a její celková přesnost se v porovnání s "recognition_01" a "recognition_02".
userData

string

Volitelná uživatelsky definovaná data Délka by neměla překročit 16 tisíc.

Odpovědi

Name Typ Description
200 OK

Požadavek byl úspěšný.
Other Status Codes

FaceErrorResponse

Neočekávaná chybová odpověď

Hlavičky

x-ms-error-code: string

Zabezpečení

Ocp-Apim-Subscription-Key

Tajný klíč předplatného Azure AI Face.

Typ: apiKey
V: header

AADToken

Tok Azure Active Directory OAuth2

Typ: oauth2
Tok: accessCode
URL autorizace: https://api.example.com/oauth2/authorize
URL tokenu: https://api.example.com/oauth2/token

Rozsahy

Name Description
https://cognitiveservices.azure.com/.default

Příklady

Create LargeFaceList

Ukázkový požadavek

PUT {endpoint}/face/v1.2-preview.1/largefacelists/your_large_face_list_id

{
  "name": "your_large_face_list_name",
  "userData": "your_user_data",
  "recognitionModel": "recognition_01"
}

Ukázková odpověď

Stavový kód:
200

Definice

Name Description
FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.
FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

FaceError

Objekt chyby. Podrobné informace o kódech chyb a zprávách vrácených službou Rozpoznávání tváře najdete na následujícím odkazu: https://aka.ms/face-error-codes-and-messages.

Name Typ Description
code

string

Jedna ze serverově definovaných kódů chyb.
message

string

Čitelné znázornění chyby člověkem.

FaceErrorResponse

Odpověď obsahující podrobnosti o chybě.

Name Typ Description
error

FaceError

Objekt chyby.