Image Embeddings

Nomic Image Embeddings allow you to semantically encode images for computers to manipulate.

Explore all Nomic Image Embedding models and use them in Python.

Get your Nomic Atlas API key at atlas.nomic.ai.

Note, if you would like to perform text to image search, you can use the Nomic Embed Text models to encode text and the Nomic Embed Vision models to encode images. Be sure to use the search_query prefix for the text embedding model.

Create Image Embeddings from Files

POST

https://api-atlas.nomic.ai/v1/embedding/image

Creates embeddings from a batch of images locally.

Request Body

model

required

string

The Nomic Image Embedding model to use.

images

required

file

The image file to embed.

Returns

The image embedding vector.

Request Example

Copy

curl -X POST \
    -H "Authorization: Bearer $NOMIC_API_KEY" \
    -H "Content-Type: multipart/form-data" \
    -F "model=nomic-embed-vision-v1.5" \
    -F "images=@/path/to/image.png" \
    https://api-atlas.nomic.ai/v1/embedding/image

Response Example

Copy

{
  "embeddings": [[1.320, 1.232, ...]], "usage":{"prompt_tokens":196,"total_tokens":196}}
}

Create Image Embeddings from URLs

POST

https://api-atlas.nomic.ai/v1/embedding/image

Creates embeddings from a batch of URLS.

Request Body

model

required

string

The Nomic Image Embedding model to use.

urls

required

url

The image url to embed.

Returns

The image embedding vector.

Request Example

Copy

curl -X POST \
    -H "Authorization: Bearer $NOMIC_API_KEY" \
    -H "Content-Type: application/x-www-form-urlencoded" \
    -d "model=nomic-embed-vision-v1.5" \
    -d "urls=https://static.nomic.ai/secret-model.png" \
    -d "urls=https://static.nomic.ai/secret-model-2.png" \
    https://api-atlas.nomic.ai/v1/embedding/image

Response Example

Copy

{
  "embeddings": [[1.320, 1.232, ...]], "usage":{"prompt_tokens":392,"total_tokens":392}}
}