dexblog.ro
Acces rapid: Învață AI Învață Programare Specificații Dispozitive Comparații
OLLAMA Toate comenzile Ollama CLI & Ghid Local

API Ollama: lista completă a endpoint-urilor în Ollama CLI & Ghid Local

Funcții și Integrare API Ollama 0.40 (octombrie 2026)

Toate endpoint-urile API-ului Ollama, native și compatibile, cu metoda HTTP și rolul fiecăruia.

Sintaxă & invocare 
http://localhost:11434/api/...  |  https://ollama.com/api/...

Ce face API Ollama: lista completă a endpoint-urilor

Serverul local răspunde la http://localhost:11434 și nu cere autentificare. Accesul direct la cloud se face la https://ollama.com/api cu o cheie API în antetul Authorization: Bearer. Crearea și ștergerea modelelor cer un server local.

Convenții: numele de model au forma model:tag, cu spațiu de nume opțional (exemplu/model); fără tag se folosește latest. Duratele din răspunsuri sunt în nanosecunde. Endpoint-urile care transmit în flux acceptă "stream": false.

API-ul nu este versionat strict, dar este gândit să rămână stabil și compatibil înapoi. Renunțările sunt anunțate în notele de lansare.

Sintaxă și opțiuni

Opțiune / Parametru Descriere
POST /api/generate Generează un răspuns pentru un prompt.
POST /api/chat Generează următorul mesaj dintr-o conversație.
POST /api/embed Generează embeddings.
POST /api/embeddings Varianta veche pentru embeddings, înlocuită de /api/embed.
GET /api/tags Lista modelelor locale (echivalent ollama list).
GET /api/ps Modelele încărcate în memorie (echivalent ollama ps).
POST /api/show Detaliile unui model: Modelfile, șablon, parametri, licență, mesaj de sistem; verbose pentru date complete.
POST /api/create Creează un model din alt model, dintr-un director safetensors sau din fișiere GGUF (câmpuri from, files, template, system, parameters, messages, license, capabilities, quantize etc.).
HEAD /api/blobs/:digest Verifică dacă un blob există pe server: 200 dacă da, 404 dacă nu.
POST /api/blobs/:digest Încarcă un fișier ca blob; 201 la succes, 400 dacă digest-ul nu corespunde.
POST /api/copy Copiază un model sub alt nume (source, destination).
DELETE /api/delete Șterge un model și datele lui.
POST /api/pull Descarcă un model; descărcările anulate se reiau de unde au rămas.
POST /api/push Publică un model (namespace/model:tag).
GET /api/version Versiunea Ollama.
POST /v1/systemone Răspunde la întrebări de tip da/nu, alegere sau scor cu un model de decizie (Ollama 0.35.0+; 0.40.5+ pentru modele din cloud).
GET /api/usage Cloud: statistici de utilizare pentru inferență, căutare web și web fetch.
GET /api/balance Cloud: creditele rămase.
POST https://ollama.com/api/web_search Cloud: căutare web (cere cheie API).
POST https://ollama.com/api/web_fetch Cloud: descarcă și extrage conținutul unei pagini (cere cheie API).
/v1/chat/completions, /v1/completions, /v1/models, /v1/embeddings, /v1/audio/speech, /v1/responses Compatibilitate OpenAI.
POST /v1/messages Compatibilitate Anthropic.

Exemple practice

Exemplul 1: Versiunea serverului

curl http://localhost:11434/api/version

Exemplul 2: Copierea unui model

curl http://localhost:11434/api/copy -d '{
  "source": "llama3.2",
  "destination": "llama3-backup"
}'

Exemplul 3: Ștergerea unui model

curl -X DELETE http://localhost:11434/api/delete -d '{
  "model": "llama3:13b"
}'

Greșeli frecvente și bune practici

  • Trimiți cereri de creare sau ștergere către https://ollama.com/api. Aceste operații cer un server local.
  • Pentru /api/create din GGUF sau safetensors trimiți calea fișierului. Întâi încarci fiecare fișier cu POST /api/blobs/:digest, apoi îl referi prin nume și digest SHA256 în files.
  • Interpretezi duratele din răspuns ca milisecunde. Sunt nanosecunde.

Comenzi înrudite