Image Moderation - Find Faces Url Input

Odwołanie

Usługa:: Cognitive Services

Wersja interfejsu API:: 1.0

Zwraca listę znalezionych twarzy.

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces

Z parametrami opcjonalnymi:

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces?overload=url&CacheImage={CacheImage}

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
Endpoint	path	True	string	Obsługiwane punkty końcowe usług Azure Cognitive Services (nazwa protokołu i hosta, takie jak https://westus.api.cognitive.microsoft.com).
CacheImage	query		boolean	Czy zachować przesłany obraz do użytku w przyszłości. Jeśli zostanie pominięta, wartość domyślna to false.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
Ocp-Apim-Subscription-Key	True	string
Content-Type	True	string	Typ zawartości.

Treść żądania

Nazwa	Typ	Opis
DataRepresentation	string
Value	string

Odpowiedzi

Nazwa	Typ	Opis
200 OK	FoundFaces	Lista znalezionych twarzy.
Other Status Codes	APIError	Odpowiedź na błąd.

Zabezpieczenia

Ocp-Apim-Subscription-Key

Typ: apiKey
W: header

Przykłady

Find Faces request

Przykładowe żądanie

HTTP

POST {Endpoint}/contentmoderator/moderate/v1.0/ProcessImage/FindFaces?overload=url



{
  "DataRepresentation": "URL",
  "Value": "https://moderatorsampleimages.blob.core.windows.net/samples/img_300.jpg"
}

Przykładowa odpowiedź

Kod stanu:: 200

{
  "Faces": [
    {
      "Left": 80,
      "Right": 118,
      "Top": 44,
      "Bottom": 82
    }
  ],
  "Count": 1,
  "AdvancedInfo": [],
  "Result": true,
  "Status": {
    "Code": 3000,
    "Description": "OK",
    "Exception": ""
  },
  "TrackingId": "SEA_ad975eeae1f24f81bebb40be0c3ba4fd_ContentModerator.Preview_01158625-4fea-4dd5-8f21-5e2657ea2eee"
}

Definicje

Nazwa	Opis
APIError	Informacje o błędzie zwracane przez interfejs API.
Error	Treść błędu.
Face	Współrzędne znalezionej twarzy.
FoundFaces	Obiekt żądania zawierający znalezione twarze.
KeyValuePair	Właściwości obiektu pary klucz/wartość.
Status	Właściwości stanu.

APIError

Informacje o błędzie zwracane przez interfejs API.

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

Error

Treść błędu.

Nazwa	Typ	Opis
Code	string
Message	string

Face

Współrzędne znalezionej twarzy.

Nazwa	Typ	Opis
Bottom	integer	Współrzędna dolna.
Left	integer	Współrzędna lewa.
Right	integer	Prawa współrzędna.
Top	integer	Współrzędna górna.

FoundFaces

Obiekt żądania zawierający znalezione twarze.

Nazwa	Typ	Opis
AdvancedInfo	KeyValuePair[]	Zaawansowane informacje.
CacheId	string	Identyfikator pamięci podręcznej.
Count	integer	Liczba znalezionych twarzy.
Faces	Face[]	Lista twarzy.
Result	boolean	Prawda, jeśli znaleziono wynik.
Status	Status	Stan oceny.
TrackingId	string	Identyfikator śledzenia.

KeyValuePair

Właściwości obiektu pary klucz/wartość.

Nazwa	Typ	Opis
Key	string	Parametr klucza.
Value	string	Parametr wartości.

Status

Właściwości stanu.

Nazwa	Typ	Opis
Code	integer	Kod stanu.
Description	string	Opis stanu.
Exception	string	Stan wyjątku.

Udostępnij za pośrednictwem