Large Person Group - Create

Skapa en ny stor persongrupp med användardefinerade largePersonGroupId, namn, en valfri userData och recognitionModel.
En stor persongrupp är containern för uppladdade persondata, inklusive ansiktsigenkänningsfunktionen och upp till 1 000 000 personer.
När du har skapat den använder du LargePersonGroup Person – Skapa för att lägga till person i gruppen och anropar LargePersonGroup – Träna för att förbereda gruppen för Ansiktsigenkänning – Identifiera.
Ingen avbildning kommer att lagras. Endast personens extraherade ansiktsfunktioner och userData lagras på servern tills LargePersonGroup Person – Delete eller LargePersonGroup – Delete anropas.
"recognitionModel" ska anges för att associeras med den här stora persongruppen. Standardvärdet för "recognitionModel" är "recognition_01", om den senaste modellen behövs anger du uttryckligen den modell som du behöver i den här parametern. Nya ansikten som läggs till i en befintlig stor persongrupp använder igenkänningsmodellen som redan är associerad med samlingen. Befintliga ansiktsfunktioner i en stor persongrupp kan inte uppdateras till funktioner som extraheras av en annan version av igenkänningsmodellen. Se Ange en ansiktsigenkänningsmodell.

Gruppkvot för stora personer:

  • Prenumerationskvot på kostnadsfri nivå: 1 000 stora persongrupper.
  • Prenumerationskvot på S0-nivå: 1 000 000 stora persongrupper.
PUT {Endpoint}/face/v1.0/largepersongroups/{largePersonGroupId}

URI-parametrar

Name In Required Type Description
Endpoint
path True
  • string

Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel: https://westus.api.cognitive.microsoft.com).

largePersonGroupId
path True
  • string

ID som refererar till en viss stor persongrupp.

Regex pattern: ^[a-z0-9-_]+$

Begärandehuvud

Name Required Type Description
Ocp-Apim-Subscription-Key True
  • string

Begärandetext

Name Required Type Description
name True
  • string

Användardefinierat namn, maximal längd är 128.

recognitionModel

Namn på igenkänningsmodell. Igenkänningsmodellen används när ansiktsfunktionerna extraheras och associeras med identifierade faceIds, (Large)FaceList eller (Large)PersonGroup. Ett igenkänningsmodellnamn kan anges när du utför Face – Detect eller (Large)FaceList – Skapa eller (stor)PersonGroup – Skapa. Standardvärdet är "recognition_01", om den senaste modellen behövs anger du uttryckligen den modell du behöver.

userData
  • string

Användarangivna data. Längden får inte överstiga 16 KB.

Svar

Name Type Description
200 OK

Ett lyckat anrop returnerar en tom svarstext.

Other Status Codes

Felsvar.

Säkerhet

Ocp-Apim-Subscription-Key

Type: apiKey
In: header

Exempel

Create new large person group example

Sample Request

PUT {Endpoint}/face/v1.0/largepersongroups/abc


{
  "name": "large-person-group-name",
  "userData": "User-provided data attached to the large person group.",
  "recognitionModel": "recognition_01"
}

Sample Response

Definitioner

APIError

Felinformation som returneras av API:et

Error

Feltext.

MetaDataContract

En kombination av användardefinierat namn och användardefinierade data- och igenkänningsmodellnamn för largePersonGroup/personGroup och largeFaceList/faceList.

RecognitionModel

Namn på igenkänningsmodell. Igenkänningsmodellen används när ansiktsfunktionerna extraheras och associeras med identifierade faceIds, (Large)FaceList eller (Large)PersonGroup. Ett igenkänningsmodellnamn kan anges när du utför Face – Detect eller (Large)FaceList – Skapa eller (stor)PersonGroup – Skapa. Standardvärdet är "recognition_01", om den senaste modellen behövs anger du uttryckligen den modell du behöver.

APIError

Felinformation som returneras av API:et

Name Type Description
error

Feltext.

Error

Feltext.

Name Type Description
code
  • string
message
  • string

MetaDataContract

En kombination av användardefinierat namn och användardefinierade data- och igenkänningsmodellnamn för largePersonGroup/personGroup och largeFaceList/faceList.

Name Type Default Value Description
name
  • string

Användardefinierat namn, maximal längd är 128.

recognitionModel recognition_01

Namn på igenkänningsmodell. Igenkänningsmodellen används när ansiktsfunktionerna extraheras och associeras med identifierade faceIds, (Large)FaceList eller (Large)PersonGroup. Ett igenkänningsmodellnamn kan anges när du utför Face – Detect eller (Large)FaceList – Skapa eller (stor)PersonGroup – Skapa. Standardvärdet är "recognition_01", om den senaste modellen behövs anger du uttryckligen den modell du behöver.

userData
  • string

Användarangivna data. Längden får inte överstiga 16 KB.

RecognitionModel

Namn på igenkänningsmodell. Igenkänningsmodellen används när ansiktsfunktionerna extraheras och associeras med identifierade faceIds, (Large)FaceList eller (Large)PersonGroup. Ett igenkänningsmodellnamn kan anges när du utför Face – Detect eller (Large)FaceList – Skapa eller (stor)PersonGroup – Skapa. Standardvärdet är "recognition_01", om den senaste modellen behövs anger du uttryckligen den modell du behöver.

Name Type Description
recognition_01
  • string
recognition_02
  • string
recognition_03
  • string
recognition_04
  • string