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


Analyze Image By Domain - Analyze Image By Domain

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

POST {Endpoint}/vision/v3.2/models/{model}/analyze
POST {Endpoint}/vision/v3.2/models/{model}/analyze?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)?$

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

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

string

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

Имя Обязательно Тип Описание
url True

string

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

Ответы

Имя Тип Описание
200 OK

DomainModelResults

Результат анализа на основе модели предметной области.

Other Status Codes

ComputerVisionErrorResponse

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

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

Ocp-Apim-Subscription-Key

Тип: apiKey
В: header

Примеры

Successful AnalyzeImageByDomain request

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

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


{
  "url": "{url}"
}

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

{
  "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

Метаданные изображения.

ImageUrl

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

Код ошибки.

Имя Тип Описание
BadArgument

string

CancelledRequest

string

DetectFaceError

string

FailedToProcess

string

InternalServerError

string

InvalidDetails

string

InvalidImageFormat

string

InvalidImageSize

string

InvalidImageUrl

string

InvalidModel

string

InvalidThumbnailSize

string

NotSupportedFeature

string

NotSupportedImage

string

NotSupportedLanguage

string

NotSupportedVisualFeature

string

StorageException

string

Timeout

string

Unspecified

string

UnsupportedMediaType

string

DomainModelResults

Результат анализа изображений с использованием определенной модели предметной области, включая дополнительные метаданные.

Имя Тип Описание
metadata

ImageMetadata

Метаданные изображения.

modelVersion

string

Версия модели ИИ.

requestId

string

Идентификатор запроса REST API.

ImageMetadata

Метаданные изображения.

Имя Тип Описание
format

string

Формат изображения.

height

integer

Высота изображения в пикселях.

width

integer

Ширина изображения в пикселях.

ImageUrl

Имя Тип Описание
url

string

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