Image Moderation - Find Faces Url Input

Ссылка

Служба:: Cognitive Services

Версия API:: 1.0

Возвращает список найденных лиц.

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

С использованием необязательных параметров:

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
Endpoint	path	True	string	Поддерживаемые конечные точки Azure Cognitive Services (протокол и имя узла, например https://westus.api.cognitive.microsoft.com).
CacheImage	query		boolean	Следует ли сохранить отправленный образ для использования в будущем. Если он опущен, значение по умолчанию — false.

Заголовок запроса

Имя	Обязательно	Тип	Описание
Ocp-Apim-Subscription-Key	True	string
Content-Type	True	string	Тип контента.

Текст запроса

Имя	Тип	Описание
DataRepresentation	string
Value	string

Ответы

Имя	Тип	Описание
200 OK	FoundFaces	Список найденных лиц.
Other Status Codes	APIError	Ответ об ошибке.

Безопасность

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

Примеры

Find Faces request

Образец запроса

HTTP

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



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

Пример ответа

Код состояния:: 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"
}

Определения

Имя	Описание
APIError	Сведения об ошибке, возвращаемые API.
Error	Текст ошибки.
Face	Координаты найденного лица.
FoundFaces	Объект запроса, содержащий найденные лица.
KeyValuePair	Свойства объекта пары "ключ-значение".
Status	Свойства состояния.

APIError

Сведения об ошибке, возвращаемые API.

Имя	Тип	Описание
Error	Error	Текст ошибки.

Error

Текст ошибки.

Имя	Тип	Описание
Code	string
Message	string

Face

Координаты найденного лица.

Имя	Тип	Описание
Bottom	integer	Нижняя координата.
Left	integer	Левая координата.
Right	integer	Правая координата.
Top	integer	Верхняя координата.

FoundFaces

Объект запроса, содержащий найденные лица.

Имя	Тип	Описание
AdvancedInfo	KeyValuePair[]	Дополнительные сведения.
CacheId	string	Идентификатор кэша.
Count	integer	Количество найденных лиц.
Faces	Face[]	Список лиц.
Result	boolean	Значение true, если результат найден.
Status	Status	Состояние оценки.
TrackingId	string	Идентификатор отслеживания.

KeyValuePair

Свойства объекта пары "ключ-значение".

Имя	Тип	Описание
Key	string	Параметр key.
Value	string	Параметр Value.

Status

Свойства состояния.

Имя	Тип	Описание
Code	integer	Код состояния.
Description	string	Описание состояния.
Exception	string	Состояние исключения.

Поделиться через