Image Moderation - Find Faces Url Input

Referens

Tjänst:: Cognitive Services

API-version:: 1.0

Returnerar listan med ansikten som hittats.

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

Med valfria parametrar:

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
Endpoint	path	True	string	Azure Cognitive Services-slutpunkter som stöds (protokoll och värdnamn, till exempel https://westus.api.cognitive.microsoft.com).
CacheImage	query		boolean	Om den skickade avbildningen ska behållas för framtida användning. Om det utelämnas är standardvärdet falskt.

Begärandehuvud

Name	Obligatorisk	Typ	Description
Ocp-Apim-Subscription-Key	True	string
Content-Type	True	string	Innehållstyp.

Begärandetext

Name	Typ	Description
DataRepresentation	string
Value	string

Svar

Name	Typ	Description
200 OK	FoundFaces	Lista över ansikten som hittats.
Other Status Codes	APIError	Felsvar.

Säkerhet

Ocp-Apim-Subscription-Key

Typ: apiKey
I: header

Exempel

Find Faces request

Exempelbegäran

HTTP

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



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

Exempelsvar

Statuskod:: 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"
}

Definitioner

Name	Description
APIError	Felinformation som API:et returnerar.
Error	Feltext.
Face	Koordinater till det hittade ansiktet.
FoundFaces	Begär objekt som innehåller hittade ansikten.
KeyValuePair	Egenskaper för nyckel/värde-parobjekt.
Status	Statusegenskaper.

APIError

Felinformation som API:et returnerar.

Name	Typ	Description
Error	Error	Feltext.

Error

Feltext.

Name	Typ	Description
Code	string
Message	string

Face

Koordinater till det hittade ansiktet.

Name	Typ	Description
Bottom	integer	Nedre koordinat.
Left	integer	Vänster koordinat.
Right	integer	Höger koordinat.
Top	integer	Översta koordinaten.

FoundFaces

Begär objekt som innehåller hittade ansikten.

Name	Typ	Description
AdvancedInfo	KeyValuePair[]	Avancerad information.
CacheId	string	Cache-ID.
Count	integer	Antal ansikten som hittats.
Faces	Face[]	Lista över ansikten.
Result	boolean	Sant om ett resultat hittades.
Status	Status	Utvärderingsstatus.
TrackingId	string	Spårnings-ID.

KeyValuePair

Egenskaper för nyckel/värde-parobjekt.

Name	Typ	Description
Key	string	Nyckelparameter.
Value	string	Värdeparameter.

Status

Statusegenskaper.

Name	Typ	Description
Code	integer	Statuskod.
Description	string	Statusbeskrivning.
Exception	string	Undantagsstatus.

Dela via