Kako integrisati Claude API u svoju aplikaciju

Da biste integrisali Claude API, napravite API ključ u Anthropicovoj Claude Console, čuvajte ga kao tajnu na serveru (obično ANTHROPIC_API_KEY) i pozivajte Messages API iz rute na vlastitom serveru koristeći jedan od zvaničnih Anthropicovih SDK-ova. Svaki zahtjev navodi model, postavlja max_tokens (najduži odgovor koji prihvatate) i šalje razgovor kao messages, dok su vaše upute u posebnom system upitu. Postavite ograničenje potrošnje, streamujte duge odgovore i obradite greške ograničenja broja zahtjeva (429) i preopterećenja (529) ponavljanjem.

Ovaj vodič pokriva postavljanje, siguran tok zahtjeva, upite za AI graditelja i greške koje treba predvidjeti. Podaci o Anthropicu su iz njegove dokumentacije od septembra 2026. Za opći pregled kako rade tokeni i cijene, pogledajte kako koristiti LLM API-je.

Šta s njim možete napraviti

• Chat asistente i widgete za pomoć (kako napraviti aplikaciju AI chatbota)
• Sažetke, prepisivanje i izrade odgovora
• Izdvajanje polja iz dokumenata, e-poruka i obrazaca
• Odgovaranje na pitanja iz vašeg sadržaja
• Agente koji pozivaju funkcije vaše aplikacije kroz korištenje alata

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

Messages API ukratko

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

API je bez stanja: da biste nastavili razgovor, šaljete prethodne poruke ponovo uz svaki zahtjev. Zato dugi 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 umjesto direktnog HTTP-a, osim ako za to nemate razlog.

Izbor modela

Anthropic nudi više Claude modela koji balansiraju sposobnost, brzinu i cijenu, a ponuda se mijenja. Odaberite najmanji model koji dobro obavlja vaš zadatak, testirajte ga na stvarnim primjerima i držite ID modela u konfiguraciji da biste mogli promijeniti bez izmjene koda. Pogledajte Anthropicove stranice o modelima i cijenama za aktuelne opcije i tarife.

Postavljanje računa

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) da biste mogli opozvati jedan bez narušavanja drugog.
3. Postavite ograničenje potrošnje. Anthropicova stranica o greškama navodi da kada potrošnja dostigne ograničenje koje ste postavili, API vraća grešku 400, pa vaša aplikacija treba jasno prikazati poruku kada se to desi.
4. Pregledajte ograničenja broja zahtjeva za svoj račun u Console-u; mjere se po organizaciji.

Tok zahtjeva

1. Korisnik radi u vašoj aplikaciji: šalje poruku, klikne „Sažmi”.
2. Pregledač poziva vašu rutu na serveru, nikada direktno Anthropic.
3. Vaš server provjerava da je korisnik prijavljen i da smije koristiti funkciju, te primjenjuje ograničenje po korisniku.
4. Gradi zahtjev: sistemski upit s vašim pravilima, unos korisnika i sve podatke koje zadatak treba iz vaše baze.
5. Poziva Messages API s ključem iz okruženja i razumnom vrijednošću max_tokens.
6. Streamuje odgovor pregledaču i bilježi potrošnju tokena iz odgovora.

Opcije i kompromisi

Upiti za vašeg AI graditelja

Prva funkcija:

Dodaj panel „Pitaj o ovom dokumentu”. On poziva rutu na serveru POST /api/ask koja provjerava da je korisnik prijavljen i vlasnik dokumenta, zatim poziva Claude Messages API sa zvaničnim Anthropic SDK-om i tajnom 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 izlaži ključ pregledaču.

Zaštitne mjere i greške:

Ograniči svakog korisnika na 20 pitanja po satu, 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 uz eksponencijalno čekanje do 3 puta, poštujući zaglavlje retry-after, zatim prikaži „Asistent je zauzet, pokušajte ponovo uskoro.” Ako API prijavi grešku o ograničenju potrošnje, prikaži „AI funkcije su pauzirane” i obavijesti administratora.

Greške koje treba predvidjeti

Iz Anthropicove dokumentacije o greškama, one koje će vaša aplikacija stvarno sresti:

Anthropicova dokumentacija kaže da zvanični SDK-ovi automatski ponavljaju privremene greške (greške veze, ograničenja broja zahtjeva i 5xx greške) dva puta po defaultu uz eksponencijalno čekanje, a to možete podesiti. Svaki odgovor sadrži zaglavlje request-id; bilježite ga da podrška može pratiti probleme.

Česte greške

• Pozivanje API-ja iz pregledača. Vaš ključ postaje javan. Uvijek idite preko svog servera. Pogledajte kako čuvati API ključeve sigurnim.
• Zaboraviti da je max_tokens ograničenje, a ne cilj. Postavite ga na ono što funkcija treba; premala vrijednost skraćuje odgovore, prevelika 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 ili ograničenja po korisniku.
• Ugrađivanje ID-ja modela u kod. Modeli se ažuriraju i povlače.
• Ignorisanje razloga zaustavljanja. Ako je odgovor stao jer je dostigao max_tokens, recite korisniku ili povećajte ograničenje.

Kontrolna lista

• API ključ napravljen u Claude Console i sačuvan kao tajna na serveru
• Odvojeni ključevi za testiranje i produkciju
• Postavljeno ograničenje potrošnje; jasna poruka kada se dostigne
• Svi zahtjevi prolaze kroz vaš server s provjerom dozvola
• Sistemski upit sadrži pravila; ID modela je podesiv
• max_tokens postavljen po funkciji; dugi odgovori se streamuju
• 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 s praznim, vrlo dugim i neprijateljskim unosima

Korištenje Claude API-ja u Mythexu

U aplikacijama koje gradite na Mythexu, Claude funkcije koriste vlastiti Anthropic ključ i naplaćuju se na vaš Anthropic račun, a ne iz Mythex kredita za izgradnju. To je odvojeno od Mythex agenta koji piše vaš kod. Dodajte ANTHROPIC_API_KEY kao tajnu projekta preko /secrets, postavki projekta ili kartice s tajnama u chatu, zatim opišite funkciju koristeći upite poput gore navedenih. Ponovo objavite nakon promjene tajni u aktivnoj aplikaciji. Pogledajte Dodajte AI funkcije uz svoje API ključeve za početni upit. Ako birate između provajdera, kako integrisati OpenAI API pokriva isto za OpenAI.

Pitanja