Condividi tramite


Analyze Image By Domain - Analyze Image By Domain

Questa operazione riconosce il contenuto all'interno di un'immagine applicando un modello specifico del dominio. È possibile recuperare l'elenco di modelli specifici del dominio supportati dall'API Visione artificiale usando la richiesta GET /models. Attualmente, l'API fornisce i modelli specifici del dominio seguenti: celebrità, punti di riferimento. Sono supportati due metodi di input: (1) Caricamento di un'immagine o (2) che specifica un URL di immagine. Verrà restituita una risposta con esito positivo in JSON. Se la richiesta non è riuscita, la risposta conterrà un codice di errore e un messaggio per comprendere cosa è andato storto.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
Endpoint
path True

string

Endpoint di Servizi cognitivi supportati.

model
path True

string

Contenuto specifico del dominio da riconoscere.

language
query

string

Lingua desiderata per la generazione di output. Se questo parametro non è specificato, il valore predefinito è "en". Per l'elenco delle lingue supportate, vedere https://aka.ms/cv-languages .

model-version
query

string

Parametro facoltativo per specificare la versione del modello di intelligenza artificiale. I valori accettati sono: "latest", "2021-04-01", "2021-05-01". Il valore predefinito è "latest".

Criterio di espressione regolare: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$

Intestazione della richiesta

Nome Necessario Tipo Descrizione
Ocp-Apim-Subscription-Key True

string

Corpo della richiesta

Nome Necessario Tipo Descrizione
url True

string

URL raggiungibile pubblicamente di un'immagine.

Risposte

Nome Tipo Descrizione
200 OK

DomainModelResults

Risultato dell'analisi basato sul modello di dominio.

Other Status Codes

ComputerVisionErrorResponse

Risposta di errore.

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

Esempio

Successful AnalyzeImageByDomain request

Esempio di richiesta

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


{
  "url": "{url}"
}

Risposta di esempio

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

Definizioni

Nome Descrizione
ComputerVisionError

Errore di richiesta API.

ComputerVisionErrorCodes

Codice di errore.

ComputerVisionErrorResponse

Risposta all'errore dell'API.

ComputerVisionInnerError

Dettagli sull'errore della richiesta API.

ComputerVisionInnerErrorCodeValue

Codice di errore.

DomainModelResults

Risultato dell'analisi delle immagini usando un modello di dominio specifico, inclusi metadati aggiuntivi.

ImageMetadata

Metadati dell'immagine.

ImageUrl

ComputerVisionError

Errore di richiesta API.

Nome Tipo Descrizione
code

ComputerVisionErrorCodes

Codice di errore.

innererror

ComputerVisionInnerError

L'errore interno contiene informazioni più specifiche.

message

string

Messaggio che spiega l'errore segnalato dal servizio.

ComputerVisionErrorCodes

Codice di errore.

Nome Tipo Descrizione
InternalServerError

string

InvalidArgument

string

InvalidRequest

string

ServiceUnavailable

string

ComputerVisionErrorResponse

Risposta all'errore dell'API.

Nome Tipo Descrizione
error

ComputerVisionError

Contenuto degli errori.

ComputerVisionInnerError

Dettagli sull'errore della richiesta API.

Nome Tipo Descrizione
code

ComputerVisionInnerErrorCodeValue

Codice di errore.

message

string

Messaggio di errore.

ComputerVisionInnerErrorCodeValue

Codice di errore.

Nome Tipo Descrizione
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

Risultato dell'analisi delle immagini usando un modello di dominio specifico, inclusi metadati aggiuntivi.

Nome Tipo Descrizione
metadata

ImageMetadata

Metadati dell'immagine.

modelVersion

string

Versione del modello di intelligenza artificiale.

requestId

string

ID della richiesta API REST.

ImageMetadata

Metadati dell'immagine.

Nome Tipo Descrizione
format

string

Formato immagine.

height

integer

Altezza dell'immagine, in pixel.

width

integer

Larghezza immagine, in pixel.

ImageUrl

Nome Tipo Descrizione
url

string

URL raggiungibile pubblicamente di un'immagine.