Kako ugraditi Claude API u svoju aplikaciju

Za ugradnju Claude API-ja stvorite API ključ u Anthropicovoj Claude Consoleu, spremite ga kao tajnu vrijednost na poslužitelju (obično ANTHROPIC_API_KEY) i pozovite Messages API s rute na vlastitom poslužitelju koristeći jedan od službenih Anthropicovih SDK-ova. Svaki zahtjev navodi model, postavlja max_tokens (najdulji odgovor koji prihvaćate) i šalje razgovor kao messages, dok su vaše upute u zasebnom system upitu. Postavite ograničenje potrošnje, streamajte duge odgovore i obradite greške ograničenja brzine (429) i preopterećenja (529) ponovnim pokušajima.

Ovaj vodič pokriva postavljanje, siguran tijek zahtjeva, upite za AI graditelj i greške na koje treba računati. Podaci o Anthropicu su iz njihove dokumentacije od rujna 2026. Za opće informacije o tokenima i cijenama pogledajte kako koristiti LLM API-je.

Što s njim možete izgraditi

• Chat asistente i widgete za pomoć (kako izraditi aplikaciju AI chatbota)
• Sažetke, prepisivanja i predložene odgovore
• Izvlačenje polja iz dokumenata, e-poruka i obrazaca
• Odgovaranje na pitanja iz vlastitog sadržaja
• Agente koji pozivaju funkcije vaše aplikacije putem korištenja alata (tool use)

Za više ideja pogledajte kako dodati AI značajke u svoju aplikaciju.

Messages API ukratko

Prema Anthropicovoj referenci API-ja, zahtjev je POST na https://api.anthropic.com/v1/messages s:

API je bez stanja: za nastavak razgovora šaljete ranije poruke ponovno uz svaki zahtjev. Zato dugi razgovori koštaju više po poruci.

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

Odabir modela

Anthropic nudi nekoliko Claude modela koji mijenjaju sposobnost za brzinu i cijenu, a ponuda se mijenja. Odaberite najmanji model koji dobro radi vaš zadatak, testirajte ga na stvarnim primjerima i držite ID modela u konfiguraciji kako biste mogli mijenjati bez izmjene koda. Za aktualne opcije i cijene provjerite Anthropicove stranice o modelima i cijenama.

Postavljanje računa

1. Prijavite se u Claude Console na platform.claude.com i dodajte naplatu.
2. Kreirajte API ključ. Držite jedan ključ po okruženju (testiranje i produkcija) kako biste mogli opozvati jedan bez pucanja drugoga.
3. Postavite ograničenje potrošnje. Stranica o greškama kod Anthropica navodi da kada potrošnja dosegne ograničenje koje ste postavili, API vraća grešku 400, pa vaša aplikacija treba prikazati jasnu poruku kada se to dogodi.
4. Pregledajte ograničenja brzine za svoj račun u Consoleu; mjere se po organizaciji.

Tijek zahtjeva

1. Korisnik djeluje u vašoj aplikaciji: šalje poruku, klikne „Sažmi“.
2. Preglednik poziva vašu rutu na poslužitelju, nikada izravno Anthropic.
3. Vaš poslužitelj provjerava je li korisnik prijavljen i smije li koristiti značajku te primjenjuje ograničenje po korisniku.
4. Gradi zahtjev: sistemski upit s vašim pravilima, unos korisnika i podatke koje zadatak treba iz vaše baze.
5. Poziva Messages API s ključem iz okruženja i razumnim max_tokens.
6. Streama odgovor pregledniku i bilježi potrošnju tokena iz odgovora.

Opcije i kompromisi

Upiti za vaš AI graditelj

Prva značajka:

Dodaj panel „Pitaj o ovom dokumentu“. Poziva rutu na poslužitelju POST /api/ask koja provjerava je li korisnik prijavljen i vlasnik dokumenta, zatim poziva Claude Messages API sa službenim Anthropic SDK-om i tajnom ANTHROPIC_API_KEY. Učitaj ID modela iz tajne CLAUDE_MODEL. Sistemski upit: „Odgovaraj samo iz priloženog dokumenta. Ako odgovora nema u njemu, reci to.“ Pošalji tekst dokumenta i pitanje, postavi max_tokens na 800, streamaj odgovor na stranicu i nikada ne izlaži ključ pregledniku.

Zaštita i greške:

Ograniči svakog korisnika na 20 pitanja na sat, praćeno u bazi podataka. Bilježi ulazne i izlazne tokene iz svakog odgovora uz ID korisnika i ID zahtjeva. Za greške 429 ili 529 ponovi zahtjev s eksponencijalnim čekanjem do 3 puta, poštujući zaglavlje retry-after, zatim prikaži „Asistent je zauzet, pokušajte ponovno uskoro.“ Ako API javi grešku ograničenja potrošnje, prikaži „AI značajke su pauzirane“ i obavijesti administratora.

Greške na koje treba računati

Iz Anthropicove dokumentacije o greškama, one s kojima se vaša aplikacija zaista susreće:

Anthropicova dokumentacija kaže da službeni SDK-ovi automatski ponavljaju prolazne greške (greške veze, ograničenja brzine i greške 5xx) dva puta prema zadanim postavkama, uz eksponencijalno čekanje, i to možete podesiti. Svaki odgovor sadrži zaglavlje request-id; zabilježite ga kako bi podrška mogla pratiti probleme.

Česte greške

• Pozivanje API-ja iz preglednika. Vaš ključ postaje javan. Uvijek idite preko svog poslužitelja. Pogledajte kako čuvati API ključeve sigurnima.
• Zaboravljanje da je max_tokens ograničenje, a ne cilj. Postavite ga na ono što značajka treba; prenizak odgovor skraćuje, previsok riskira duge, skupe odgovore.
• Stavljanje pravila u korisničku poruku. Stabilne upute pripadaju system upitu; dozvole pripadaju vašem kodu.
• Slanje cijelog chata zauvijek. Skratite ili sažmite stare poruke kako razgovori rastu.
• Nema ograničenja potrošnje ni ograničenja po korisniku.
• Tvrdo kodiran ID modela. Modeli se ažuriraju i povlače.
• Ignoriranje razloga zaustavljanja. Ako se odgovor zaustavio jer je dosegnuo max_tokens, recite to korisniku ili povisite ograničenje.

Popis za provjeru

• API ključ kreiran u Claude Consoleu i spremljen kao tajna vrijednost na poslužitelju
• Zasebni ključevi za testiranje i produkciju
• Ograničenje potrošnje postavljeno; jasna poruka kada se dosegne
• Svi zahtjevi idu preko vašeg poslužitelja uz provjeru dozvola
• Sistemski upit sadrži pravila; ID modela je podesiv
• max_tokens postavljen po značajci; dugi odgovori se streamaju
• Ograničenje po korisniku u vašoj aplikaciji
• 429 i 529 obrađeni čekanjem; ID-jevi zahtjeva se bilježe
• Prijateljsko stanje greške koje ne ruši stranicu
• Testirano praznim, vrlo dugim i neprijateljskim unosima

Korištenje Claude API-ja u Mythexu

U aplikacijama koje gradite na Mythexu, Claude značajke koriste vaš vlastiti Anthropic ključ i naplaćuju se na vaš Anthropic račun, a ne na Mythex kredite za izradu. To je odvojeno od Mythex agenta koji piše vaš kod. Dodajte ANTHROPIC_API_KEY kao tajnu projekta putem /secrets, postavki projekta ili kartice s tajnama u chatu, zatim opišite značajku upitima sličnima gore navedenima. Nakon promjene tajni na živoj aplikaciji ponovno objavite. Za početni upit pogledajte Dodavanje AI značajki s vlastitim API ključevima. Ako birate između pružatelja, kako ugraditi OpenAI API obrađuje isto za OpenAI.

Pitanja