Kako integrisati Claude API u svoju aplikaciju

Da biste integrisali Claude API, napravite API ključ u Anthropic-ovoj Claude Console, čuvajte ga kao tajnu na serveru (obično ANTHROPIC_API_KEY) i pozivajte Messages API sa rute na svom serveru koristeći jedan od Anthropic-ovih zvaničnih SDK-ova. Svaki zahtev navodi model, postavlja max_tokens (najdužu odgovor koji prihvatate) i šalje razgovor kao messages, dok su vaša uputstva u posebnom system upitu. Postavite limit potrošnje, streamujte duge odgovore i obrađujte greške ograničenja broja zahteva (429) i preopterećenja (529) pokušajima ponovo.

Ovaj vodič pokriva podešavanje, bezbedan tok zahteva, upite za AI graditelja i greške na koje treba računati. Podaci o Anthropic-u su iz njihove dokumentacije od septembra 2026. Za to kako tokeni i cene funkcionišu uopšteno, pogledajte kako koristiti LLM API-je.

Šta sa njim možete da napravite

• Asistente za razgovor i widget-e za pomoć (kako napraviti aplikaciju sa AI chatbot-om)
• Sažetke, prepisivanja i sastavljanje odgovora
• Izvlačenje polja iz dokumenata, mejlova i formulara
• Odgovaranje na pitanja iz vašeg sopstvenog sadržaja
• Agente koji pozivaju funkcije vaše aplikacije kroz upotrebu alata (tool use)

Za više ideja pogledajte kako dodati AI funkcije u svoju aplikaciju.

Messages API ukratko

Prema referenci Anthropic API-ja, zahtev je POST na https://api.anthropic.com/v1/messages sa:

API je bez stanja: da biste nastavili razgovor, šaljete ranije poteze ponovo uz svaki zahtev. Zato duži razgovori koštaju više po poruci.

Anthropic objavljuje zvanične SDK-ove za Python, TypeScript, C#, Go, Java, PHP i Ruby. Oni postavljaju zaglavlja, obrađuju odgovore i podržavaju streaming. Koristite jedan od njih umesto sirovog HTTP-a, osim ako za to nemate razlog.

Izbor modela

Anthropic nudi nekoliko Claude modela koji balansiraju sposobnost, brzinu i cenu, a ponuda se menja. Izaberite najmanji model koji dobro radi vaš zadatak, testirajte ga na stvarnim primerima i držite ID modela u konfiguraciji kako biste mogli da ga promenite bez izmene koda. Za aktuelne opcije i cene proverite Anthropic-ove stranice o modelima i cenama.

Podešavanje naloga

1. Prijavite se u Claude Console na platform.claude.com i dodajte naplatu.
2. Napravite API ključ. Držite po jedan ključ za svako okruženje (testiranje i produkciju), kako biste mogli da opozovete jedan bez kvara drugog.
3. Postavite limit potrošnje. Anthropic-ova stranica sa greškama navodi da kada potrošnja dostigne limit koji ste postavili, API vraća grešku 400, pa vaša aplikacija treba da prikaže jasnu poruku kada se to dogodi.
4. Pregledajte limite brzine za svoj nalog u Console-u; mere se po organizaciji.

Tok zahteva

1. Korisnik nešto uradi u vašoj aplikaciji: pošalje poruku, klikne „Sažmi”.
2. Pregledač poziva vašu rutu na serveru, nikada direktno Anthropic.
3. Vaš server proverava da je korisnik prijavljen i da sme da koristi funkciju, i primenjuje limit po korisniku.
4. Gradi zahtev: sistemski upit sa vašim pravilima, unos korisnika i sve podatke koje zadatak treba iz vaše baze.
5. Poziva Messages API sa ključem iz okruženja i razumnim max_tokens.
6. Streamuje odgovor u pregledač i beleži potrošnju tokena iz odgovora.

Opcije i kompromisi

Upiti za vašeg AI graditelja

Prva funkcija:

Dodaj panel „Pitaj o ovom dokumentu”. Poziva rutu na serveru POST /api/ask koja proverava da je korisnik prijavljen i vlasnik dokumenta, zatim poziva Claude Messages API preko zvaničnog Anthropic SDK-a i tajne ANTHROPIC_API_KEY. Čitaj ID modela iz tajne CLAUDE_MODEL. Sistemski upit: „Odgovaraj samo na osnovu priloženog dokumenta. Ako odgovora nema u njemu, reci to.” Pošalji tekst dokumenta i pitanje, postavi max_tokens na 800, streamuj odgovor na stranicu i nikada ne otkrivaj ključ pregledaču.

Zaštite i greške:

Ograniči svakog korisnika na 20 pitanja na sat, praćeno u bazi podataka. Beleži ulazne i izlazne tokene iz svakog odgovora uz ID korisnika i ID zahteva. Na greške 429 ili 529 pokušaj ponovo uz eksponencijalno čekanje do 3 puta, poštujući zaglavlje retry-after, pa zatim prikaži „Asistent je zauzet, pokušajte ponovo uskoro.” Ako API prijavi grešku limita potrošnje, prikaži „AI funkcije su pauzirane” i obavesti administratora.

Greške na koje treba računati

Iz Anthropic-ove dokumentacije o greškama, one sa kojima će se vaša aplikacija zaista susresti:

Anthropic-ova dokumentacija kaže da zvanični SDK-ovi automatski ponavljaju privremene greške (greške veze, limite brzine i 5xx greške) dva puta podrazumevano uz eksponencijalno čekanje, a to možete podesiti. Svaki odgovor nosi zaglavlje request-id; zabeležite ga kako bi podrška mogla da prati probleme.

Česte greške

• Pozivanje API-ja iz pregledača. Vaš ključ postaje javan. Uvek idite preko svog servera. Pogledajte kako čuvati API ključeve bezbednim.
• Zaboravljanje da je max_tokens ograničenje, a ne cilj. Postavite ga na onoliko koliko funkcija treba; premalo skraćuje odgovore, previše rizikuje duge i skupe odgovore.
• Stavljanje pravila u korisničku poruku. Stabilna uputstva pripadaju system upitu; dozvole pripadaju vašem kodu.
• Slanje celog razgovora zauvek. Skraćujte ili sažimajte stare poteze kako razgovori rastu.
• Bez limita potrošnje ili limita po korisniku.
• Čvrsto unošenje ID-ja modela. Modeli se ažuriraju i povlače.
• Ignorisanje razloga zaustavljanja. Ako se odgovor zaustavio jer je dostigao max_tokens, recite to korisniku ili povećajte limit.

Kontrolna lista

• API ključ napravljen u Claude Console i sačuvan kao tajna na serveru
• Zasebni ključevi za testiranje i produkciju
• Limit potrošnje postavljen; jasna poruka kada se dostigne
• Svi zahtevi idu preko vašeg servera sa proverom dozvola
• Sistemski upit čuva pravila; ID modela se može podesiti
• max_tokens podešen po funkciji; dugi odgovori se streamuju
• Ograničenje po korisniku u vašoj aplikaciji
• 429 i 529 obrađeni čekanjem; ID-jevi zahteva se beleže
• Prijateljsko stanje greške koje ne ruši stranicu
• Testirano sa praznim, veoma dugim i neprijateljskim unosima

Korišćenje Claude API-ja u Mythex-u

U aplikacijama koje gradite na Mythex-u, Claude funkcije koriste vaš sopstveni Anthropic ključ i naplaćuju se na vaš Anthropic nalog, a ne preko Mythex kredita za izgradnju. To je odvojeno od Mythex agenta koji piše vaš kod. Dodajte ANTHROPIC_API_KEY kao tajnu projekta preko /secrets, podešavanja projekta ili kartice za tajne u razgovoru, pa opišite funkciju upitima kao što su gore. Ponovo objavite aplikaciju posle promene tajni na aktivnoj aplikaciji. Za početni upit pogledajte Dodavanje AI funkcija sa sopstvenim API ključevima. Ako birate između provajdera, kako integrisati OpenAI API pokriva istu materiju za OpenAI.

Pitanja