Kako vključiti Claude API v svojo aplikacijo
Za vključitev Claude API ustvarite API ključ v Anthropicovi Claude Console, shranite ga kot skrivnost na strežniku (ponavadi ANTHROPIC_API_KEY) in kličite Messages API s strežniške poti v svoji aplikaciji z enim od uradnih Anthropicovih SDK-jev. Vsaka zahteva navede model, nastavi max_tokens (najdaljši odgovor, ki ga sprejmete) in pošlje pogovor kot messages, vaša navodila pa gredo v ločen system poziv. Nastavite omejitev porabe, dolge odgovore pretakajte in pri napakah omejitve hitrosti (429) ter preobremenitve (529) poskusite znova.
Ta vodnik zajema nastavitev, varen potek zahteve, pozive za AI graditelj in napake, na katere se je treba pripraviti. Podatki o Anthropicu so iz njihove dokumentacije po stanju septembra 2026. Za splošen pregled žetonov in cen najprej preberite kako uporabljati LLM API-je.
Kaj lahko z njim zgradite
- Klepetalne pomočnike in pomožne gumbe (kako zgraditi aplikacijo s klepetalnim robotom z AI)
- Povzetke, prepise in osnutke odgovorov
- Izluščenje polj iz dokumentov, e-pošte in obrazcev
- Odgovore na vprašanja iz vaše vsebine
- Agente, ki kličejo funkcije vaše aplikacije prek uporabe orodij (tool use)
Več idej najdete v kako dodati funkcije z AI v svojo aplikacijo.
Messages API na kratko
Po referenci Anthropicovega API-ja je zahteva POST na https://api.anthropic.com/v1/messages z naslednjimi deli:
| Del | Kaj je |
|---|---|
glava x-api-key | Vaš API ključ |
glava anthropic-version | Različica API-ja, na primer 2023-06-01 |
model (obvezno) | Kateri model Claude uporabiti |
max_tokens (obvezno) | Največ žetonov, ki jih sme odgovor vsebovati; model se lahko ustavi prej |
messages (obvezno) | Pogovor: izmenjujoči se zavoji user in assistant |
system (neobvezno) | Navodila, ki veljajo za ves pogovor |
stream (neobvezno) | Nastavite na true, da odgovor prejemate sproti, prek server-sent events |
API je brez stanja: za nadaljevanje pogovora pošljete prejšnje zavoje znova z vsako zahtevo. Zato so dolgi pogovori dražji za vsako sporočilo.
Anthropic objavlja uradne SDK-je za Python, TypeScript, C#, Go, Javo, PHP in Ruby. Nastavijo glave, razčlenijo odgovore in podpirajo pretakanje. Uporabite enega od njih namesto surovega HTTP-ja, razen če imate za to razlog.
Izbira modela
Anthropic ponuja več modelov Claude, ki kompromise med zmogljivostjo, hitrostjo in ceno, paleta pa se spreminja. Izberite najmanjši model, ki dobro opravi nalogo, ga preizkusite na pravih primerih in ID modela hranite v konfiguraciji, da ga lahko zamenjate brez spremembe kode. Trenutne možnosti in cene preverite na Anthropicovih straneh za modele in cene.
Nastavitev računa
- Prijavite se v Claude Console na platform.claude.com in dodajte obračun.
- Ustvarite API ključ. Za vsako okolje (testiranje in produkcija) imejte svoj ključ, da lahko enega prekličete, ne da bi pokvarili drugega.
- Nastavite omejitev porabe. Anthropicova stran z napakami navaja, da API ob doseženi omejitvi porabe, ki ste jo nastavili, vrne napako 400, zato mora vaša aplikacija prikazati jasno sporočilo.
- Preglejte omejitve hitrosti za svoj račun v Console; merijo se na organizacijo.
Potek zahteve
- Uporabnik nekaj naredi v aplikaciji: pošlje sporočilo, klikne „Povzemi“.
- Brskalnik pokliče vašo strežniško pot, nikoli neposredno Anthropica.
- Vaš strežnik preveri, ali je uporabnik prijavljen in sme uporabljati funkcijo, ter uveljavi omejitev na uporabnika.
- Zgradi zahtevo: sistemski poziv s pravili, uporabnikov vnos in podatke iz vaše baze, ki jih naloga potrebuje.
- Pokliče Messages API s ključem iz okolja in smiselnim
max_tokens. - Odgovor pretoči v brskalnik in zabeleži porabo žetonov iz odgovora.
Možnosti in kompromisi
| Odločitev | Preprosta izbira | Kdaj iti dlje |
|---|---|---|
| Pretakanje | Počakati na celoten odgovor | Pretakajte za klepet in vse dolgo; Anthropic priporoča pretakanje ali serije za dolgotrajne zahteve |
| Oblika izhoda | Navaden besedilni odgovor | Strukturiran izhod JSON, kadar vaša koda mora brati polja |
| Vaši podatki | Vključite ustrezen zapis | Iskanje po vaši vsebini, kadar je je preveč (kaj je RAG) |
| Dejanja | Model samo piše besedilo | Uporaba orodij, kjer model zahteva, naj vaša koda zažene funkcijo, ki ste jo določili |
| Obsežno delo, ki ni nujno | Zanka čez elemente | Message Batches API, ki mu pošljete zahtevke in kasneje preverjate rezultate |
Poziv za vaš AI graditelj
Prva funkcija:
Dodaj ploščo „Vprašaj o tem dokumentu“. Kliče strežniško pot POST /api/ask, ki preveri, ali je uporabnik prijavljen in lastnik dokumenta, nato pokliče Claude Messages API z uradnim Anthropic SDK in skrivnostjo ANTHROPIC_API_KEY. ID modela preberi iz skrivnosti CLAUDE_MODEL. Sistemski poziv: „Odgovarjaj samo na podlagi priloženega dokumenta. Če odgovora ni v njem, to povej.“ Pošlji besedilo dokumenta in vprašanje, nastavi max_tokens na 800, odgovor pretakaj na stran in ključa nikoli ne pošiljaj v brskalnik.
Zaščitne ograje in napake:
Omeji vsakega uporabnika na 20 vprašanj na uro, sledeno v bazi. Za vsak odgovor zabeleži vhodne in izhodne žetone z ID-jem uporabnika in ID-jem zahteve. Ob napakah 429 ali 529 poskusi znova z eksponentnim čakanjem do 3-krat in upoštevaj glavo retry-after, nato pokaži „Pomočnik je zaseden, poskusite kmalu znova.“ Če API javi napako omejitve porabe, pokaži „Funkcije z AI so začasno ustavljene“ in obvesti administratorja.
Napake, na katere se pripravite
Iz Anthropicove dokumentacije o napakah so tiste, s katerimi se bo vaša aplikacija dejansko srečala:
| Koda | Vrsta | Kaj storiti |
|---|---|---|
| 400 | invalid_request_error | Popravite zahtevo; vrne se tudi ob doseženi omejitvi porabe, ki ste jo nastavili |
| 401 | authentication_error | Preverite, da ključ obstaja, je pravilen in ni preklican |
| 413 | request_too_large | Pošljite manj; Messages API sprejme do 32 MB na zahtevo |
| 429 | rate_limit_error | Počakajte in poskusite znova, upoštevajte retry-after |
| 500 | api_error | Poskusite znova s čakanjem; če se ponavlja, stopite v stik s podporo z ID-jem zahteve |
| 529 | overloaded_error | Začasno velik promet vseh uporabnikov; počakajte in poskusite znova |
Anthropicova dokumentacija pravi, da uradni SDK-ji samodejno ponovijo začasne napake (napake povezave, omejitve hitrosti in napake 5xx) privzeto dvakrat z eksponentnim čakanjem, to pa lahko nastavite. Vsak odgovor vsebuje glavo request-id; zabeležite jo, da lahko podpora sledi težavi.
Pogoste napake
- Klic API-ja iz brskalnika. Vaš ključ postane javen. Vedno pojdite prek svojega strežnika. Glejte kako varno hraniti API ključe.
- Pozabiti, da je
max_tokensomejitev, ne cilj. Nastavite ga na to, kar funkcija potrebuje; prenizko odreže odgovore, previsoko tvega dolge, drage odgovore. - Pravila v uporabniškem sporočilu. Stalna navodila sodijo v poziv
system; dovoljenja v vašo kodo. - Pošiljanje celotnega klepeta v nedogled. Ko se pogovori daljšajo, skrajšajte ali povzemite stare zavoje.
- Brez omejitve porabe ali omejitve na uporabnika.
- Trdo kodiranje ID-ja modela. Modeli se posodabljajo in ukinjajo.
- Ignoriranje razloga za zaustavitev. Če se je odgovor ustavil, ker je dosegel
max_tokens, to povejte uporabniku ali zvišajte omejitev.
Kontrolni seznam
- API ključ ustvarjen v Claude Console in shranjen kot skrivnost na strežniku
- Ločeni ključi za testiranje in produkcijo
- Omejitev porabe nastavljena; jasno sporočilo, ko je dosežena
- Vse zahteve gredo prek vašega strežnika s preverjanjem dovoljenj
- Sistemski poziv vsebuje pravila; ID modela je nastavljiv
-
max_tokensnastavljen za vsako funkcijo; dolgi odgovori pretakani - Omejitev na uporabnika v aplikaciji
- Napake 429 in 529 obravnavane s čakanjem; ID-ji zahtev zabeleženi
- Prijazno stanje napake, ki ne pokvari strani
- Preizkušeno s praznimi, zelo dolgimi in sovražnimi vnosi
Uporaba Claude API v Mythex
V aplikacijah, ki jih gradite na Mythex, funkcije Claude uporabljajo vaš lasten ključ Anthropic in se obračunavajo na vaš račun Anthropic, ne na kredite za gradnjo Mythex. To je ločeno od agenta Mythex, ki piše vašo kodo. Dodajte ANTHROPIC_API_KEY kot skrivnost projekta prek /secrets, nastavitev projekta ali kartice s skrivnostmi v klepetu, nato opišite funkcijo s pozivi, kot so zgornji. Po spremembi skrivnosti na objavljeni aplikaciji jo objavite znova. Za začetni poziv glejte Dodajanje funkcij z AI z lastnimi API ključi. Če izbirate med ponudniki, kako vključiti OpenAI API pokriva isto za OpenAI.
Vprašanja
Kako dobim API ključ za Claude?
Prijavite se v Claude Console na platform.claude.com, nastavite obračun in ustvarite API ključ. Shranite ga kot skrivnost na strežniku, ponavadi z imenom ANTHROPIC_API_KEY, nikoli pa ga ne dajte v kodo brskalnika.
Kaj potrebuje zahteva za Claude API?
Od septembra 2026 referenca Anthropicovega Messages API navaja tri obvezna polja v telesu zahteve: model, max_tokens in messages. Neposredni klici HTTP potrebujejo tudi glavi x-api-key in anthropic-version; uradni SDK-ji ju nastavijo samodejno.
Kaj pomeni napaka 529 pri Claude API?
Anthropicova stran z napakami opisuje 529 kot overloaded_error: API je začasno preobremenjen zaradi velikega prometa vseh uporabnikov. Poskusite znova z eksponentnim čakanjem. Uradni SDK-ji nekatere začasne napake samodejno ponovijo.
Ali lahko Claude uporabljam s kodo, napisano za OpenAI SDK?
Anthropic dokumentira združljivostno plast za OpenAI SDK, ki omogoča uporabo Claude prek vmesnika OpenAI SDK. Za novo kodo so njihovi lastni SDK-ji ponavadi boljše izhodišče, saj dajejo dostop do funkcij, značilnih za Claude.