Ca sa folosesti Claude API ai nevoie de patru lucruri: un cont in Claude Console (platform.claude.com), credit in cont, un Claude API key care incepe cu sk-ant- si un apel catre endpointul /v1/messages.
Abonamentul Pro sau Max nu include API-ul: platesti separat, la consum, pe milion de tokeni.
Mai jos iti arat pasii pe care ii urmez cand conectez Claude la site-ul sau la aplicatia unui client: cum obtii cheia, cat costa de fapt un apel, primul cod care merge si erorile care te pot bloca o dupa-amiaza intreaga.
Ce este Claude API
Claude API este modul prin care un program de-al tau foloseste modelele Anthropic, fara sa scrii manual in chat. Codul trimite un text (sau o imagine, un PDF) si primeste raspunsul in format JSON.
Cu Claude API poti construi, de exemplu:
- chatboti si asistenti pe site sau pe WhatsApp, cu regulile tale;
- extragere de date din emailuri, facturi, contracte si formulare;
- rezumate si raspunsuri propuse direct in CRM sau in ERP;
- agenti AI care apeleaza functiile aplicatiei tale.
Claude API si abonamentul Claude nu sunt acelasi lucru
Aici apar cele mai multe confuzii. Claude.ai, cu planurile Free, Pro, Max, Team si Enterprise, este produsul pentru oameni. Claude Console este produsul pentru dezvoltatori.
Anthropic spune clar in centrul de ajutor: chiar daca ai un plan platit, Claude API se plateste separat. Daca te intereseaza doar abonamentele, gasesti totul in ghidul meu despre cat costa Claude in 2026.
Cum obtii Claude API key in 5 pasi
Dureaza cateva minute. Iata pasii din documentatia oficiala, in ordinea in care ii fac eu.
- Creeaza contul in Claude Console. Intra pe platform.claude.com si inregistreaza-te sau autentifica-te.
- Adauga facturarea. In sectiunea de facturare pui metoda de plata si cumperi credite. Pe platforma directa se plateste prin achizitie de credite Anthropic.
- Deschide pagina cu chei. Mergi la Settings, apoi API keys.
- Creeaza cheia. Apasa Create key, da-i un nume, alege data de expirare si contul legat (tu sau un service account). O poti limita la un workspace.
- Copiaz-o imediat. Consola arata cheia completa o singura data, la creare. Pastreaz-o intr-un manager de secrete.
Unde gasesc Claude API key daca l-am pierdut?
Nu il mai poti vedea. Daca pierzi o cheie, consola nu ti-o mai arata: creezi una noua, actualizezi codul si o revoci pe cea veche.
De aceea dau mereu un nume clar fiecarei chei, de tipul "site-productie" sau "test-local".
Cat costa Claude API
Claude API se plateste pe tokeni: tokenii de intrare (ce trimiti) costa mai putin decat cei de iesire (ce scrie Claude). Preturile sunt in dolari, pe milion de tokeni, conform listei oficiale.
| Model | Input | Output | Citire cache |
|---|---|---|---|
| Claude Fable 5.1 | 10 $ | 50 $ | 0,25 $ |
| Claude Opus 5.5 | 4 $ | 20 $ | 0,20 $ |
| Claude Sonnet 5.5 | 2 $ | 10 $ | 0,20 $ |
| Claude Haiku 4.5 | 1 $ | 5 $ | 0,10 $ |
Un calcul real pentru un chatbot
Luam o cerere tipica: 1.000 de tokeni de intrebare si context, 500 de tokeni de raspuns, cu Sonnet 5.5.
- input: 1.000 de tokeni la 2 $ pe milion = 0,002 $;
- output: 500 de tokeni la 10 $ pe milion = 0,005 $;
- total: aproximativ 0,007 $ pe cerere, adica in jur de 7 $ la o mie de cereri.
Doua lucruri scad factura. Batch API injumatateste pretul pentru input si output la lucrarile care nu sunt urgente. Prompt caching face ca partile repetate din prompt sa coste foarte putin: am explicat totul in ghidul despre prompt caching si costurile API.
Facturare pentru firme din Romania
Preturile Claude API sunt in dolari, nu in lei. Daca platesti de pe firma, vorbeste din timp cu contabilul despre cum inregistrezi facturile de la un furnizor din afara tarii si despre cursul folosit.
Iti recomand si un card dedicat pentru serviciile AI, cu limita lunara: asa vezi clar cat consuma fiecare proiect.
Claude API key este gratuit?
Nu, dar la inceput primesti ceva. Anthropic spune ca utilizatorii noi primesc o suma mica de credite gratuite pentru testarea Claude API. Ajung pentru primele teste, nu pentru un proiect real.
Daca vrei sa programezi fara sa platesti, am adunat variantele care merg in Claude Code gratis: 5 metode.
Primul apel catre Claude API
Mai intai salveaza cheia ca variabila de mediu. Numele standard este ANTHROPIC_API_KEY: SDK-urile oficiale o citesc singure.
export ANTHROPIC_API_KEY="sk-ant-..."Cu curl
curl https://api.anthropic.com/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5-5",
"max_tokens": 500,
"messages": [
{"role": "user", "content": "Rezuma in trei randuri ce face un CRM."}
]
}'Cu Python
pip install anthropicimport anthropic
client = anthropic.Anthropic() # citeste ANTHROPIC_API_KEY
message = client.messages.create(
model="claude-sonnet-5-5",
max_tokens=500,
messages=[{"role": "user", "content": "Rezuma in trei randuri ce face un CRM."}],
)
for block in message.content:
if block.type == "text":
print(block.text)Cu Node.js sau TypeScript
npm install @anthropic-ai/sdkimport Anthropic from "@anthropic-ai/sdk";
const client = new Anthropic(); // citeste ANTHROPIC_API_KEY
const message = await client.messages.create({
model: "claude-sonnet-5-5",
max_tokens: 500,
messages: [{ role: "user", content: "Rezuma in trei randuri ce face un CRM." }],
});
console.log(message.content);Exista SDK-uri oficiale si pentru C#, Go, Java, PHP si Ruby. Campul max_tokens este o limita, nu o tinta: pune-l la cat are nevoie functia.
Ce model alegi
Regula mea: pornesc de la cel mai mic model care face bine treaba si urc doar daca testele o cer. Tin ID-ul modelului in configurare, ca sa il schimb fara sa ating codul.
- Claude Haiku 4.5 (
claude-haiku-4-5-20251001): clasificari, sortare de emailuri, raspunsuri scurte la volum mare. - Claude Sonnet 5.5 (
claude-sonnet-5-5): punctul de plecare pentru chatboti, extragere de date si rezumate. Detalii in Claude Sonnet 5.5: cand merita fata de Opus. - Claude Opus 5.5 (
claude-opus-5-5): agenti care lucreaza mult timp, cod complex, rationamente in mai multi pasi. Preturi si limite in ghidul despre Claude Opus 5.5.
Opus 5.5 si Sonnet 5.5 au o fereastra de context de 1 milion de tokeni, Haiku 4.5 de 200.000.
Limitele Claude API
Fiecare organizatie are o limita de cereri si de tokeni pe minut, plus un plafon lunar de cheltuieli legat de nivel (tier). Trecerea la nivelul urmator se face automat, in functie de istoricul de utilizare.
| Nivel | Plafon lunar |
|---|---|
| Start | 500 $ |
| Build | 1.000 $ |
| Scale | 200.000 $ |
| Custom | fara plafon |
Limitele contului le vezi in consola, pe pagina Rate limits, unde poti cere si o crestere.
Seteaza din prima zi o limita de cheltuieli proprie, mai mica decat plafonul: o bucla gresita intr-un agent poate arde creditele in cateva minute.
Cele mai comune erori Claude API
Cand "cheia nu merge", raspunsul este de obicei intr-unul dintre aceste coduri.
- 401 authentication_error: cheie gresita, expirata sau revocata. Verifica daca variabila de mediu este chiar incarcata.
- 400 invalid_request_error: cerere gresita, dar apare si cand atingi limita de cheltuieli setata de tine.
- 402 billing_error: problema cu plata sau cu creditele.
- 429 rate_limit_error: prea multe cereri sau plafon lunar atins. Respecta headerul
retry-after; daca e plafonul de cheltuieli, headerul lipseste si eroarea ramane pana luna viitoare sau pana la schimbarea nivelului. - 529 overloaded_error: API supraincarcat pentru toti. Reincearca la intervale tot mai mari.
Cum iti protejezi Claude API key
O cheie furata inseamna credite platite de tine. Regulile pe care le aplic in fiecare proiect:
- niciodata in frontend: browserul apeleaza serverul tau, serverul apeleaza Claude;
- niciodata in repository: cheia sta in variabile de mediu sau intr-un manager de secrete;
- o cheie pe mediu: test si productie separate, ca sa revoci una fara sa o opresti pe cealalta;
- expirare si workspace: seteaza expirarea la creare si limiteaza cheia la workspace-ul proiectului.
Claude API key in Claude Code si alte unelte
Aceeasi cheie merge si in afara codului tau. Claude Code accepta un API key in locul abonamentului: platesti la consum, nu lunar. Pasii sunt in ghidul de instalare Claude Code.
Daca firma ta lucreaza deja pe un cloud, Claude este disponibil si prin Amazon Bedrock, Claude Platform on AWS, Google Cloud si Microsoft Foundry. In acest caz facturarea trece prin furnizorul tau de cloud.
Claude API intr-o firma: ce verifici inainte
Sa conectezi Claude API la un site e simplu. Sa o faci bine intr-o firma cere cateva decizii in plus:
- date personale: daca trimiti catre Claude nume, emailuri sau documente ale clientilor, ai nevoie de un temei legal GDPR si de o nota de informare actualizata; autoritatea care verifica in Romania este ANSPDCP;
- controlul costurilor: limita pe utilizator, log cu tokenii fiecarui raspuns, alerte cand cheltuiala creste;
- calitate: un prompt de sistem cu regulile, teste pe cazuri reale si un raspuns de rezerva cand API-ul nu raspunde.
Romania si Italia sunt printre tarile in care Claude API este disponibil.
Daca vrei un chatbot AI sau agenti AI conectati la sistemele tale, vezi cum lucrez pe automatizari AI sau scrie-mi si vorbim.
