Sign in

v1

latestSwagger 2.02026-07-1745767.1 KB

Return the embedding vectors for given images. The method makes a REST API call to the /images/embeddings route on the given endpoint.

Deprecated: This API is deprecated. Use the OpenAI API instead. See migration guide.

post/images/embeddings

Query parameters

api-versionstring required

The API version to use for this operation.

Headers

extra-parameters'error' | 'drop' | 'pass-through'

Controls what happens if extra parameters, undefined by the REST API, are passed in the JSON request payload. This sets the HTTP request header extra-parameters.

Request body

dimensionsinteger

Optional. The number of dimensions the resulting output embeddings should have. Passing null causes the model to use its default value. Returns a 422 error if the model doesn't support the value or parameter.

encoding_format'base64' | 'binary' | 'float' | 'int8' | 'ubinary' | 'uint8'

Specifies the types of embeddings to generate. Compressed embeddings types like uint8, int8, ubinary and binary, may reduce storage costs without sacrificing the integrity of the data. Returns a 422 error if the model doesn't support the value or parameter. Read the model's documentation to know the values supported by your model.

input_type'text' | 'query' | 'document'

Represents the input types used for embedding search.

modelstring

ID of the specific AI model to use, if more than one model is available on the endpoint.

Response

The request has succeeded.

idstring required

Unique identifier for the embeddings result.

object'list' required

The object type of the embeddings result. Will always be list.

modelstring required

The model ID used to generate this result.