Skip to main content
POST
/
embed
Generate dense embeddings
curl --request POST \
  --url https://api.example.com/embed \
  --header 'Content-Type: application/json' \
  --header 'x-chroma-embedding-model: <x-chroma-embedding-model>' \
  --header 'x-chroma-token: <x-chroma-token>' \
  --data '
{
  "texts": [
    "<string>"
  ],
  "instructions": "<string>",
  "task": "<string>",
  "target": "<string>",
  "fetch_labels": true
}
'
{
  "embeddings": [
    [
      123
    ]
  ],
  "num_tokens": 123
}

Headers

x-chroma-token
string
required

Chroma API key for authentication.

x-chroma-embedding-model
enum<string>
required

The embedding model to use.

Available options:
Qwen/Qwen3-Embedding-0.6B,
BAAI/bge-m3,
prithivida/Splade_PP_en_v1,
naver/efficient-splade-VI-BT-large-doc,
naver/efficient-splade-VI-BT-large-query

Body

application/json

Request body for embedding endpoints.

texts
string[]
required
instructions
string | null
required
task
string | null
target
string | null
fetch_labels
boolean | null

Response

Successful Response

embeddings
number[][]
required
num_tokens
integer
required