Ce face API compatibil Anthropic (/v1/messages)
Ollama implementează /v1/messages, formatul API-ului Anthropic. Clientul Anthropic primește ca adresă de bază http://localhost:11434 (local) sau https://ollama.com (cloud) și adaugă singur /v1/messages. Serverul local nu validează cheia API, dar clientul cere una.
Sunt suportate mesajele, streaming-ul, prompturile de sistem, conversațiile cu mai multe ture, imaginile base64, uneltele și rezultatele lor, plus gândirea extinsă (budget_tokens este acceptat, dar nu este aplicat). Numărul de tokeni raportat este o aproximare.
Nu sunt suportate /v1/messages/count_tokens, tool_choice, metadata, prompt caching (cache_control), Batches API, citările, documentele PDF și erorile trimise în flux. Pentru Claude Code, varianta cea mai simplă este ollama launch claude.
Sintaxă și opțiuni
| Opțiune / Parametru | Descriere |
|---|---|
ANTHROPIC_BASE_URL=http://localhost:11434 |
Adresa serverului Ollama pentru unelte care folosesc API-ul Anthropic. |
ANTHROPIC_AUTH_TOKEN=ollama |
Necesară, dar ignorată de serverul local. |
anthropic-version: 2023-06-01 |
Endpoint-ul găzduit respinge versiuni mai vechi de 2023-06-01. |
Exemple practice
Exemplul 1: Variabile de mediu pentru unelte compatibile Anthropic
export ANTHROPIC_AUTH_TOKEN=ollama
export ANTHROPIC_BASE_URL=http://localhost:11434Exemplul 2: Cerere cu curl
curl -X POST http://localhost:11434/v1/messages \
-H "Content-Type: application/json" \
-H "x-api-key: ollama" \
-H "anthropic-version: 2023-06-01" \
-d '{
"model": "qwen3-coder",
"max_tokens": 1024,
"messages": [{ "role": "user", "content": "Hello, how are you?" }]
}'Greșeli frecvente și bune practici
- Pui adresa completă
http://localhost:11434/v1/messagesca adresă de bază. Clientul Anthropic adaugă singur/v1/messages. - La cloud trimiți cheia doar în
x-api-key. Endpoint-ul găzduit cereAuthorization: Bearer. - Te bazezi pe
tool_choiceca să forțezi o unealtă. Câmpul nu este suportat.