Detect Objects In Stream - Detect Objects In Stream

Servizio:

Azure AI Services

Versione API:

3.2

Esegue il rilevamento degli oggetti sull'immagine specificata. 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/detect

Con parametri facoltativi:

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
Endpoint	path	True	string	Endpoint di Servizi cognitivi supportati.
model-version	query		string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	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".

Intestazione della richiesta

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

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

Corpo della richiesta

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

Nome	Tipo	Descrizione
Image	object (file)	Flusso di immagini.

Risposte

Nome	Tipo	Descrizione
200 OK	DetectResult	La risposta include gli oggetti rilevati in formato JSON.
Other Status Codes	ComputerVisionErrorResponse	Risposta di errore.

Sicurezza

Ocp-Apim-Subscription-Key

Tipo: apiKey
In: header

Esempio

Successful DetectObjects request

Esempio di richiesta

HTTP

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


"{binary}"

Risposta di esempio

Codice di stato:

200

{
  "objects": [
    {
      "rectangle": {
        "x": 0,
        "y": 0,
        "w": 50,
        "h": 50
      },
      "object": "tree",
      "confidence": 0.9,
      "parent": {
        "object": "plant",
        "confidence": 0.95
      }
    }
  ],
  "requestId": "1ad0e45e-b7b4-4be3-8042-53be96103337",
  "metadata": {
    "width": 100,
    "height": 100,
    "format": "Jpeg"
  },
  "modelVersion": "2021-04-01"
}

Definizioni

Nome	Descrizione
BoundingRect	Rettangolo di selezione per un'area all'interno di un'immagine.
ComputerVisionError	Errore di richiesta API.
ComputerVisionErrorCodes	Codice di errore.
ComputerVisionErrorResponse	Risposta di errore dell'API.
ComputerVisionInnerError	Dettagli sull'errore della richiesta API.
ComputerVisionInnerErrorCodeValue	Codice di errore.
DetectedObject	Oggetto rilevato in un'immagine.
DetectResult	Risultato di una chiamata DetectImage.
ImageMetadata	Metadati dell'immagine.
ObjectHierarchy	Oggetto rilevato all'interno di un'immagine.

BoundingRect

Object

Rettangolo di selezione per un'area all'interno di un'immagine.

Nome	Tipo	Descrizione
h	integer (int32)	Altezza misurata dal punto superiore sinistro dell'area, in pixel.
w	integer (int32)	Larghezza misurata dal punto superiore sinistro dell'area, in pixel.
x	integer (int32)	Coordinata X del punto superiore sinistro dell'area, in pixel.
y	integer (int32)	Coordinata Y del punto superiore sinistro dell'area, in pixel.

ComputerVisionError

Object

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

Enumerazione

Codice di errore.

Valore	Descrizione
InvalidRequest
InvalidArgument
InternalServerError
ServiceUnavailable

ComputerVisionErrorResponse

Object

Risposta di errore dell'API.

Nome	Tipo	Descrizione
error	ComputerVisionError	Contenuto dell'errore.

ComputerVisionInnerError

Object

Dettagli sull'errore della richiesta API.

Nome	Tipo	Descrizione
code	ComputerVisionInnerErrorCodeValue	Codice di errore.
message	string	Messaggio di errore.

ComputerVisionInnerErrorCodeValue

Enumerazione

Codice di errore.

Valore	Descrizione
InvalidImageFormat
UnsupportedMediaType
InvalidImageUrl
NotSupportedFeature
NotSupportedImage
Timeout
InternalServerError
InvalidImageSize
BadArgument
DetectFaceError
NotSupportedLanguage
InvalidThumbnailSize
InvalidDetails
InvalidModel
CancelledRequest
NotSupportedVisualFeature
FailedToProcess
Unspecified
StorageException

DetectedObject

Object

Oggetto rilevato in un'immagine.

Nome	Tipo	Descrizione
confidence	number (double)	Punteggio di confidenza di aver osservato l'oggetto nell'immagine, come valore compreso tra 0 e 1.
object	string	Etichetta per l'oggetto .
parent	ObjectHierarchy	Oggetto padre, dal punto di vista della tassonomia. L'oggetto padre è una forma più generica di questo oggetto. Ad esempio, un 'bulldog' avrebbe un padre di 'cane'.
rectangle	BoundingRect	Posizione approssimativa dell'oggetto rilevato.

DetectResult

Object

Risultato di una chiamata DetectImage.

Nome	Tipo	Descrizione
metadata	ImageMetadata	Metadati dell'immagine.
modelVersion	string pattern: ^(latest|\d{4}-\d{2}-\d{2})(-preview)?$	Versione del modello di intelligenza artificiale.
objects	DetectedObject[]	Matrice di oggetti rilevati.
requestId	string	ID della richiesta dell'API REST.

ImageMetadata

Object

Metadati dell'immagine.

Nome	Tipo	Descrizione
format	string	Formato immagine.
height	integer (int32)	Altezza dell'immagine, in pixel.
width	integer (int32)	Larghezza dell'immagine, in pixel.

ObjectHierarchy

Object

Oggetto rilevato all'interno di un'immagine.

Nome	Tipo	Descrizione
confidence	number (double)	Punteggio di confidenza di aver osservato l'oggetto nell'immagine, come valore compreso tra 0 e 1.
object	string	Etichetta per l'oggetto .
parent	ObjectHierarchy	Oggetto padre, dal punto di vista della tassonomia. L'oggetto padre è una forma più generica di questo oggetto. Ad esempio, un 'bulldog' avrebbe un padre di 'cane'.