Analyze Image By Domain In Stream - Analyze Image By Domain In Stream

Ссылка

Служба:: Azure AI Services

Версия API:: 3.2

Эта операция распознает содержимое изображения путем применения модели для конкретной предметной области. Список моделей для конкретных предметных областей, которые поддерживаются API Компьютерного зрения, можно получить с помощью запроса /models GET. В настоящее время API предоставляет следующие модели для конкретных предметных областей: знаменитости, ориентиры. Поддерживаются два метода ввода: (1) отправка изображения или (2) указание URL-адреса изображения. Успешный ответ будет возвращен в формате JSON. Если запрос завершился сбоем, ответ будет содержать код ошибки и сообщение, которое поможет понять, что пошло не так.

POST {Endpoint}/vision/v3.2/models/{model}/analyze

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

POST {Endpoint}/vision/v3.2/models/{model}/analyze?overload=stream&language={language}&model-version={model-version}

Параметры URI

Имя	В	Обязательно	Тип	Описание
Endpoint	path	True	string	Поддерживаемые конечные точки Cognitive Services.
model	path	True	string	Распознаваемого содержимого для конкретного домена.
language	query		string	Требуемый язык для создания выходных данных. Если этот параметр не задан, используется значение по умолчанию "en". Список поддерживаемых языков см. в статье https://aka.ms/cv-languages .
model-version	query		string	Необязательный параметр для указания версии модели ИИ. Допустимые значения: "latest", "2021-04-01", "2021-05-01". По умолчанию используется значение "latest". Шаблон регулярного выражения: `^(latest\|\d{4}-\d{2}-\d{2})(-preview)?$`

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

Media Types: "application/octet-stream", "multipart/form-data"

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

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

Media Types: "application/octet-stream", "multipart/form-data"

Имя	Тип	Описание
Image	object	Поток изображения.

Ответы

Имя	Тип	Описание
200 OK	DomainModelResults	Результат анализа на основе модели предметной области.
Other Status Codes	ComputerVisionErrorResponse	Ответ об ошибке.

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

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

Примеры

Successful AnalyzeImageByDomain request

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

HTTP

POST https://westus.api.cognitive.microsoft.com/vision/v3.2/models/Celebrities/analyze?overload=stream


"{binary}"

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

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

{
  "requestId": "f0027b4b-dc0d-4082-9228-1545ed246b03",
  "metadata": {
    "width": 1500,
    "height": 1000,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01",
  "result": {
    "celebrities": [
      {
        "name": "Satya Nadella",
        "faceRectangle": {
          "left": 597,
          "top": 162,
          "width": 248,
          "height": 248
        },
        "confidence": 0.999028444
      }
    ]
  }
}

Определения

Имя	Описание
ComputerVisionError	Ошибка запроса API.
ComputerVisionErrorCodes	Код ошибки.
ComputerVisionErrorResponse	Ответ об ошибке API.
ComputerVisionInnerError	Сведения об ошибке запроса API.
ComputerVisionInnerErrorCodeValue	Код ошибки.
DomainModelResults	Результат анализа изображений с использованием определенной модели предметной области, включая дополнительные метаданные.
ImageMetadata	Метаданные изображения.

ComputerVisionError

Ошибка запроса API.

Имя	Тип	Описание
code	ComputerVisionErrorCodes	Код ошибки.
innererror	ComputerVisionInnerError	Внутренняя ошибка содержит более конкретные сведения.
message	string	Сообщение, объясняющее ошибку, о которую сообщила служба.

ComputerVisionErrorCodes

Код ошибки.

Имя	Тип	Описание
InternalServerError	string
InvalidArgument	string
InvalidRequest	string
ServiceUnavailable	string

ComputerVisionErrorResponse

Ответ об ошибке API.

Имя	Тип	Описание
error	ComputerVisionError	Содержимое ошибки.

ComputerVisionInnerError

Сведения об ошибке запроса API.

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

ComputerVisionInnerErrorCodeValue