API: POST /api/embed (embeddings) în Ollama CLI & Ghid Local

POST http://localhost:11434/api/embed

Ce face API: POST /api/embed (embeddings)

/api/embed transformă textul în vectori numerici, pe care îi poți salva într-o bază de date vectorială sau compara prin similaritate cosinus. Lungimea vectorului depinde de model. input poate fi un text sau o listă de texte; la modelele cu embeddings multimodale, o intrare poate fi și un obiect cu text, image sau audio (base64).

Endpoint-ul mai vechi POST /api/embeddings (cu câmpul prompt) a fost înlocuit de /api/embed. Pentru clienții OpenAI există /v1/embeddings.

Din terminal, ollama run cu un model de embeddings afișează un tablou JSON. Opțiunile --truncate și --dimensions ale lui ollama run corespund câmpurilor din API.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
model	Modelul de embeddings.
input	Un text, o listă de texte sau obiecte cu text / image / audio. video nu este acceptat.
truncate	Taie finalul fiecărei intrări ca să încapă în context. Implicit true; cu false primești eroare la depășire.
dimensions	Numărul de dimensiuni ale embedding-ului.
options	Parametri de model din Modelfile.
keep_alive	Cât rămâne modelul încărcat după cerere (implicit 5m).

Exemple practice

Exemplul 1: Cerere API

curl http://localhost:11434/api/embed -d '{
  "model": "all-minilm",
  "input": "Why is the sky blue?"
}'

Exemplul 2: Din terminal, prin pipe

echo "Hello world" | ollama run nomic-embed-text

Greșeli frecvente și bune practici

• Folosești în cod nou /api/embeddings. Documentația îl marchează ca înlocuit de /api/embed.
• Compari vectori produși de modele diferite. Lungimea și spațiul vectorial depind de model.

Comenzi înrudite

• ollama-api-chat
• ollama-api-openai
• ollama-run
• ollama-api-referinta