Image Analysis - Segment

Служба:

Azure AI Services

Версия API:

2023-02-01-preview

Проанализируйте входное изображение. Запрос содержит поток изображения с любым типом контента ['image/*', 'application/octet-stream'] или полезные данные JSON, которые включают свойство URL для извлечения потока изображений. Возвращается поток изображений типа "image/png", где значения пикселей зависят от режима анализа. Возвращаемое изображение имеет те же размеры, что и входное изображение для режимов: foregroundMatting. Возвращаемое изображение имеет то же соотношение сторон и те же размеры, что и входное изображение до ограничения в 16 мегапикселей для режимов: backgroundRemoval.

POST /imageanalysis:segment?api-version=2023-02-01-preview

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

POST /imageanalysis:segment?mode={mode}&api-version=2023-02-01-preview

Параметры URI

Имя	В	Обязательно	Тип	Описание
api-version	query	True	string	Запрошенная версия API.
mode	query		SegmentationModeApiModel	Запрошенный режим анализа. Один из них: backgroundRemoval, foregroundMatting.

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

Имя	Обязательно	Тип	Описание
url	True	string	Общедоступный URL-адрес изображения.

Ответы

Имя	Тип	Описание
200 OK	file	Успех Media Types: "image/png", "application/json"
Other Status Codes	ErrorResponse	Ошибка Media Types: "image/png", "application/json" Заголовки x-ms-error-code: string

Примеры

Segment_BackgroundRemoval_FromImageUrl

Segment_ForegroundMatting_FromImageUrl

Segment_BackgroundRemoval_FromImageUrl

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

HTTP

POST /imageanalysis:segment?mode=backgroundRemoval&api-version=2023-02-01-preview

{
  "url": "{image url}"
}

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

Код состояния:

200

"Ynl0ZXM="

Segment_ForegroundMatting_FromImageUrl

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

HTTP

POST /imageanalysis:segment?mode=foregroundMatting&api-version=2023-02-01-preview

{
  "url": "{image url}"
}

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

Код состояния:

200

"Ynl0ZXM="

Определения

Имя	Описание
ErrorResponse	Ответ возвращается при возникновении ошибки.
ErrorResponseDetails	Сведения об ошибке.
ErrorResponseInnerError	Подробная ошибка.
ImageUrl	Документ JSON с URL-адресом, указывающим на анализируемое изображение.
SegmentationModeApiModel	Запрошенный режим анализа. Один из них: backgroundRemoval, foregroundMatting.

ErrorResponse

Ответ возвращается при возникновении ошибки.

Имя	Тип	Описание
error	ErrorResponseDetails	Сведения об ошибке.

ErrorResponseDetails

Сведения об ошибке.

Имя	Тип	Описание
code	string	Код ошибки.
details	ErrorResponseDetails[]	Список подробных ошибок.
innererror	ErrorResponseInnerError	Подробная ошибка.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponseInnerError

Подробная ошибка.

Имя	Тип	Описание
code	string	Код ошибки.
innererror	ErrorResponseInnerError	Подробная ошибка.
message	string	Сообщение об ошибке.

ImageUrl

Документ JSON с URL-адресом, указывающим на анализируемое изображение.

Имя	Тип	Описание
url	string	Общедоступный URL-адрес изображения.

SegmentationModeApiModel

Запрошенный режим анализа. Один из них: backgroundRemoval, foregroundMatting.

Имя	Тип	Описание
backgroundRemoval	string
foregroundMatting	string