Riferimento: Incorporamenti di immagini | Azure Machine Learning

Articolo
09/04/2024

Crea un vettore di incorporamento che rappresenta la coppia di immagine e testo di input.

POST /images/embeddings?api-version=2024-04-01-preview

Parametri dell'URI

Nome	Tra	Richiesto	Type	Descrizione
api-version	query	Vero	string	Versione dell'API nel formato "AAAA-MM-GG" o "AAAA-MM-GG-preview".

Intestazione richiesta

Nome	Obbligatorio	Type	Descrizione
parametri aggiuntivi		string	Il comportamento dell'API quando vengono indicati parametri extra nel payload. L'utilizzo di `pass-through` consente all'API di passare il parametro al modello sottostante. Usare questo valore quando si desidera passare i parametri che è noto che il modello sottostante possa supportare. L'utilizzo di `ignore` fa in modo che l'API elimini qualsiasi parametro non supportato. Usare questo valore quando è necessario usare lo stesso payload in modelli diversi, ma uno dei parametri extra può restituire un errore per un modello, se non supportato. L'utilizzo di `error` fa in modo che l'API rifiuti qualsiasi parametro extra nel payload. Possono essere indicati solo i parametri specificati in questa API. In caso contrario, verrà restituito un errore 400.
azureml-model-deployment		string	Nome della distribuzione a cui si desidera instradare la richiesta. Supportato per gli endpoint che supportano più distribuzioni.

Corpo della richiesta

Nome	Obbligatorio	Type	Descrizione
modello		string	Nome del modello. Questo parametro viene ignorato se l'endpoint viene usato per un solo modello.
input	Vero	EmbeddingInput[]	Immagine di input da incorporare. Per incorporare più input in una singola richiesta, passare una matrice. L'input non deve superare il numero massimo di token di input per il modello.
dimensioni		integer	Numero di dimensioni che devono essere presenti negli incorporamenti di output risultanti. Se si passa null, il modello usa il valore predefinito. Restituisce un errore 422 se il modello non supporta il valore o il parametro.
encoding_format		EmbeddingEncodingFormat	Formato in cui restituire gli incorporamenti. Può essere base64, float, int8, uint8, binary o ubinary. Restituisce un errore 422 se il modello non supporta il valore o il parametro.

Risposte

Nome	Tipo	Descrizione
200 OK	CreateEmbeddingResponse	Ok
401 - Non autorizzato	UnauthorizedError	Token di accesso mancante o non valido Intestazioni x-ms-error-code: string
404 Not Found	NotFoundError	Modalità non supportata dal modello. Controllare la documentazione del modello per verificare quali route sono disponibili. Intestazioni x-ms-error-code: string
422 - Entità non elaborabile	UnprocessableContentError	La richiesta presenta contenuti non elaborabili. L'errore viene restituito quando il payload indicato è valido in base a questa specifica. Tuttavia, alcune istruzioni indicate nel payload non sono supportate dal modello sottostante. Usare la sezione `details` per comprendere il parametro all'origine dell'errore. Intestazioni x-ms-error-code: string
429 Troppe richieste	TooManyRequestsError	È stato raggiunto il limite di frequenza assegnato e la richiesta deve essere gestita. Intestazioni x-ms-error-code: string
Altri codici di stato	ContentFilterError	Richiesta non valida Intestazioni x-ms-error-code: string

Sicurezza

Autorizzazione

Token con il prefisso Bearer:, ad esempio Bearer abcde12345

Tipo: apiKey
In: intestazione

AADToken

Autenticazione OAuth2 di Azure Active Directory

Tipo: oauth2
Flusso: applicazione
URL del tokenL: https://login.microsoftonline.com/common/oauth2/v2.0/token

Esempi

Crea un vettore di incorporamento che rappresenta il testo e l'immagine di input

Richiesta di esempio

POST /images/embeddings?api-version=2024-04-01-preview

{
  "input": [
    {
      "text": "A nice picture of a cat",
      "image": "data:image/jpeg;base64,iVBORw0KG..."
    }
  ],
  "encoding_format": "float",
  "dimensions": 1024
}

Risposta di esempio

Codice di stato: 200

{
  "data": [
    {
      "index": 0,
      "object": "embedding",
      "embedding": [
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0,
        0
      ]
    }
  ],
  "object": "list",
  "model": "DINO",
  "usage": {
    "prompt_tokens": 15,
    "total_tokens": 15
  }
}

Definizioni

Nome	Descrizione
ContentFilterError	La chiamata API ha esito negativo quando la richiesta attiva un filtro di contenuto come configurato. Modificare il prompt e riprovare.
CreateEmbeddingResponse
CreateImageEmbeddingRequest
Detail
Incorporamento	Rappresenta un'immagine generata.
EmbeddingEncodingFormat	Formato in cui restituire gli incorporamenti. Può essere base64, float, int8, uint8, binary o ubinary. Restituisce un errore 422 se il modello non supporta il valore o il parametro.
EmbeddingObject	Tipo di oggetto, che è sempre "embedding".
EmbeddingInput	Rappresenta un'immagine con testo facoltativo.
ListObject	Tipo di oggetto, che è sempre "list".
NotFoundError
TooManyRequestsError
UnauthorizedError
UnprocessableContentError	La richiesta presenta contenuti non elaborabili. L'errore viene restituito quando il payload indicato è valido in base a questa specifica. Tuttavia, alcune istruzioni indicate nel payload non sono supportate dal modello sottostante. Usare la sezione `details` per comprendere il parametro all'origine dell'errore.
Utilizzo	Informazioni sull'utilizzo relative alla richiesta.

ContentFilterError

La chiamata API ha esito negativo quando la richiesta attiva un filtro di contenuto come configurato. Modificare il prompt e riprovare.

Nome	Tipo	Descrizione
codice	string	Codice errore.
Errore	string	Descrizione dell'errore.
messaggio	string	Messaggio di errore.
param	string	Il parametro che ha attivato il filtro contenuto.
stato	integer	Codice di stato HTTP.

CreateEmbeddingResponse

Nome	Tipo	Descrizione
data	Embedding[]	Elenco degli incorporamenti generati dal modello.
modello	string	Nome del modello usato per generare l'incorporamento.
oggetto	ListObject	Tipo di oggetto, che è sempre "list".
attivamente	Utilizzo	Informazioni sull'utilizzo relative alla richiesta.

CreateImageEmbeddingRequest

Nome	Type	Valore predefinito	Descrizione
dimensioni	integer		Numero di dimensioni che devono essere presenti negli incorporamenti di output risultanti. Se si passa null, il modello usa il valore predefinito. Restituisce un errore 422 se il modello non supporta il valore o il parametro.
encoding_format	EmbeddingEncodingFormat	float	Formato in cui restituire gli incorporamenti. Può essere base64, float, int8, uint8, binary o ubinary. Restituisce un errore 422 se il modello non supporta il valore o il parametro.
input	EmbeddingInput[]		Immagine di input da incorporare. Per incorporare più input in una singola richiesta, passare una matrice. L'input non deve superare il numero massimo di token di input per il modello.

Dettagli

Nome	Tipo	Descrizione
loc	string[]	Parametro che causa il problema
value	string	Valore passato al parametro che causa problemi.

Incorporamento

Rappresenta un'immagine generata.

Nome	Tipo	Descrizione
embedding	number[]	Vettore di incorporamento, che è un elenco di valori float. La lunghezza del vettore dipende dal modello usato.
index	integer	Indice dell'incorporamento nell'elenco di incorporamenti.
oggetto	EmbeddingObject	Tipo di oggetto, che è sempre "embedding".

EmbeddingEncodingFormat

Formato in cui restituire gli incorporamenti. Può essere base64, float, int8, uint8, binary o ubinary. Restituisce un errore 422 se il modello non supporta il valore o il parametro.

Nome	Tipo	Descrizione
base64	string
binary	string
float	string
int8	string
ubinary	string
uint8	string

EmbeddingObject

Tipo di oggetto, che è sempre "embedding".

Nome	Tipo	Descrizione
embedding	string

EmbeddingInput

Rappresenta un'immagine con testo facoltativo.

Nome	Tipo	Descrizione
image	string	Immagine di input codificata in `base64` stringa come URL dati. Esempio: `data:image/{format};base64,{data}`.
Testo	string	Facoltativo. Input di testo da inserire nel modello (ad esempio DINO, CLIP). Restituisce un errore 422 se il modello non supporta il valore o il parametro.

ListObject

Il tipo di oggetto, che è sempre "elenco".

Nome	Tipo	Descrizione
list	string

NotFoundError

Nome	Tipo	Descrizione
Errore	string	Descrizione dell'errore.
messaggio	string	Messaggio di errore.
stato	integer	Codice di stato HTTP.

TooManyRequestsError

Nome	Tipo	Descrizione
Errore	string	Descrizione dell'errore.
messaggio	string	Messaggio di errore.
stato	integer	Codice di stato HTTP.

UnauthorizedError

Nome	Tipo	Descrizione
Errore	string	Descrizione dell'errore.
messaggio	string	Messaggio di errore.
stato	integer	Codice di stato HTTP.

UnprocessableContentError

La richiesta presenta contenuti non elaborabili. L'errore viene restituito quando il payload indicato è valido in base a questa specifica. Tuttavia, alcune istruzioni indicate nel payload non sono supportate dal modello sottostante. Usare la sezione details per comprendere il parametro all'origine dell'errore.

Nome	Tipo	Descrizione
codice	string	Codice errore.
detail	Detail
Errore	string	Descrizione dell'errore.
messaggio	string	Messaggio di errore.
stato	integer	Codice di stato HTTP.

Utilizzo

Informazioni sull'utilizzo relative alla richiesta.

Nome	Tipo	Descrizione
prompt_patches	integer	Numero di patch immagine usate dalla richiesta dell'immagine.
prompt_tokens	integer	Numero di token usati dal prompt.
total_patches	integer	Numero totale di patch usate dalla richiesta.
total_tokens	integer	Numero totale di token usati dalla richiesta.

Condividi tramite