Image Retrieval - Vectorize Image

Servizio:

Cognitive Services - Computer Vision

Versione API:

2023-04-01-preview

Vettore restituito da un'immagine.

POST /retrieval:vectorizeImage?api-version=2023-04-01-preview

Con parametri facoltativi:

POST /retrieval:vectorizeImage?model-version={model-version}&api-version=2023-04-01-preview

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
api-version	query	True	string	Versione dell'API richiesta.
model-version	query		string	Versione del modello.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
url	True	string	URL raggiungibile pubblicamente di un'immagine.

Risposte

Nome	Tipo	Descrizione
200 OK	SingleVectorResultApiModel	Operazione completata
Other Status Codes	ErrorResponse	Errore Intestazioni x-ms-error-code: string

Esempio

ImageRetrieval_VectorizeImage

Esempio di richiesta

HTTP

POST /retrieval:vectorizeImage?model-version=2023-04-01-preview&api-version=2023-04-01-preview

{
  "url": "https://example.com/image.jpg"
}

Risposta di esempio

Codice di stato:

200

{
  "vector": [
    0,
    1.1,
    2.2
  ],
  "modelVersion": "2023-04-01-preview"
}

Definizioni

Nome	Descrizione
ErrorResponse	Risposta restituita quando si verifica un errore.
ErrorResponseDetails	Informazioni sugli errori.
ErrorResponseInnerError	Errore dettagliato.
ImageUrl	Documento JSON con un URL che punta all'immagine da analizzare.
SingleVectorResultApiModel	Risultati della vettorizzazione dell'immagine.

ErrorResponse

Risposta restituita quando si verifica un errore.

Nome	Tipo	Descrizione
error	ErrorResponseDetails	Informazioni sugli errori.

ErrorResponseDetails

Informazioni sugli errori.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ErrorResponseDetails[]	Elenco degli errori dettagliati.
innererror	ErrorResponseInnerError	Errore dettagliato.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponseInnerError

Errore dettagliato.

Nome	Tipo	Descrizione
code	string	Codice di errore.
innererror	ErrorResponseInnerError	Errore dettagliato.
message	string	Messaggio di errore.

ImageUrl

Documento JSON con un URL che punta all'immagine da analizzare.

Nome	Tipo	Descrizione
url	string	URL raggiungibile pubblicamente di un'immagine.

SingleVectorResultApiModel

Risultati della vettorizzazione dell'immagine.

Nome	Tipo	Descrizione
modelVersion	string	Versione del modello.
vector	number[]	Vettore dell'immagine.