Kuidas integreerida Claude API oma rakendusse
Claude API integreerimiseks loo API-võti Anthropicu Claude Console'is, hoia see serveripoolse saladusena (tavaliselt ANTHROPIC_API_KEY) ja kutsu Messages API oma serveri marsruudist, kasutades ühte Anthropicu ametlikest SDK-dest. Iga päring nimetab mudeli, määrab max_tokens (pikima vastuse, mida nõustud vastu võtma) ja saadab vestluse messages'ina, kusjuures sinu juhised on eraldi system-promptis. Sea kulupiirang, voogedasta pikki vastuseid ning käsitle piirangu (429) ja ülekoormuse (529) vigu uuesti proovimisega.
See juhend käsitleb seadistamist, turvalist päringuvoogu, prompte AI-ehitajale ja vigu, millega tuleb arvestada. Anthropicu andmed on pärit nende dokumentatsioonist 2026. aasta septembri seisuga. Tokenite ja hinnastamise üldiste põhimõtete kohta vaata kuidas kasutada LLM API-sid.
Mida selle abil ehitada
- Vestlusabilised ja abividinad (kuidas ehitada AI-vestlusroboti rakendus)
- Kokkuvõtted, ümberkirjutused ja koostatud vastused
- Väljade eraldamine dokumentidest, e-kirjadest ja vormidest
- Vastamine küsimustele sinu enda sisu põhjal
- Agendid, mis kutsuvad sinu rakenduse funktsioone tööriistakasutuse kaudu
Rohkem ideid leiad: kuidas lisada AI-funktsioone oma rakendusse.
Messages API lühidalt
Anthropicu API viite järgi on päring POST-taotlus aadressile https://api.anthropic.com/v1/messages koos järgmiste osadega:
| Osa | Mis see on |
|---|---|
x-api-key päis | Sinu API-võti |
anthropic-version päis | API versioon, näiteks 2023-06-01 |
model (nõutav) | Millist Claude'i mudelit kasutada |
max_tokens (nõutav) | Maksimaalne tokenite arv vastuses; mudel võib varem peatuda |
messages (nõutav) | Vestlus: vahelduvad user ja assistant pöörded |
system (valikuline) | Juhised, mis kehtivad kogu vestluse kohta |
stream (valikuline) | Väärtus true annab vastuse kirjutamise ajal, serveri saadetud sündmuste kaudu |
API on olekuta: vestluse jätkamiseks saada iga päringuga uuesti eelmised pöörded. Seetõttu maksavad pikad vestlused sõnumi kohta rohkem.
Anthropic avaldab ametlikud SDK-d Pythonile, TypeScriptile, C#-le, Go-le, Javale, PHP-le ja Rubyle. Need seadistavad päised, töötlevad vastuseid ja toetavad voogedastust. Kasuta neid tavalise HTTP asemel, välja arvatud juhul, kui sul on selleks põhjus.
Mudeli valimine
Anthropic pakub mitut Claude'i mudelit, mis vahetavad võimekust kiiruse ja hinna vastu, ning valik muutub. Vali väikseim mudel, mis sinu ülesande hästi täidab, testi seda päris näidetega ja hoia mudeli ID konfiguratsioonis, et saaksid vahetada ilma koodimuudatuseta. Praeguste valikute ja määrade jaoks vaata Anthropicu mudelite ja hinnastamise lehti.
Konto seadistamine
- Logi sisse Claude Console'i aadressil platform.claude.com ja lisa arveldus.
- Loo API-võti. Hoia üks võti keskkonna kohta (test ja tootmine), et saaksid ühe tühistada, ilma et teine katkeks.
- Sea kulupiirang. Anthropicu veateadete leht märgib, et kui kasutus jõuab sinu seatud kulupiirini, tagastab API vea 400, seega peaks sinu rakendus selle juhtumi korral näitama selget teadet.
- Vaata üle piirangud oma konto jaoks Console'is; need on määratud organisatsiooni kaupa.
Päringu voog
- Kasutaja tegutseb sinu rakenduses: saadab sõnumi, klõpsab nupule „Kokkuvõte“.
- Brauser kutsub sinu serveri marsruuti, mitte otse Anthropicut.
- Sinu server kontrollib, et kasutaja on sisse logitud ja tohib funktsiooni kasutada, ning rakendab kasutajapõhist piirangut.
- See koostab päringu: süsteemiprompt sinu reeglitega, kasutaja sisend ja andmed sinu andmebaasist, mida ülesanne vajab.
- See kutsub Messages API-d, kasutades võtit keskkonnast ja mõistlikku
max_tokensväärtust. - See voogedastab vastuse brauserisse ja logib vastuse põhjal tokenite kasutuse.
Valikud ja kompromissid
| Otsus | Lihtne valik | Millal minna kaugemale |
|---|---|---|
| Voogedastus | Oota kogu vastust | Voogedasta vestluste ja kõigi pikkade vastuste puhul; Anthropic soovitab pikkade päringute puhul voogedastust või partiisid |
| Väljundi vorming | Tavatekst | Struktureeritud JSON-väljund, kui su kood peab välju lugema |
| Sinu andmed | Lisa asjakohane kirje | Otsing sinu sisu üle, kui seda on liiga palju (mis on RAG) |
| Tegevused | Mudel kirjutab ainult teksti | Tööriistakasutus, kus mudel palub su koodil käivitada funktsiooni, mille sa defineerid |
| Mahukas, mitte kiireloomuline töö | Käi üksused läbi tsükliga | Message Batches API, mille esitad ja mille tulemusi pärid |
Promptid AI-ehitajale
Esimene funktsioon:
Lisa paneel „Küsi sellest dokumendist“. See kutsub serveri marsruuti POST /api/ask, mis kontrollib, et kasutaja on sisse logitud ja dokumendi omanik, seejärel kutsub Claude Messages API-d ametliku Anthropicu SDK-ga ja saladusega ANTHROPIC_API_KEY. Loe mudeli ID saladusest CLAUDE_MODEL. Süsteemiprompt: „Vasta ainult etteantud dokumendi põhjal. Kui vastust seal pole, ütle seda.“ Saada dokumendi tekst ja küsimus, sea max_tokens väärtuseks 800, voogedasta vastus lehele ja ära kunagi väljasta võtit brauserile.
Piirangud ja vead:
Piira iga kasutaja 20 küsimusega tunnis, mis salvestatakse andmebaasi. Logi iga vastuse sisend- ja väljundtokenid koos kasutaja ID ja päringu ID-ga. Vigade 429 või 529 korral proovi uuesti eksponentsiaalse viitega ooteajaga kuni 3 korda, arvestades retry-after päist, seejärel näita „Assistent on hõivatud, proovi varsti uuesti.“ Kui API teatab kulupiirangu veast, näita „AI-funktsioonid on peatatud“ ja teavita administraatorit.
Vead, millega tuleb arvestada
Anthropicu veadokumentatsioonist on need vead, millega su rakendus tegelikult kokku puutub:
| Kood | Tüüp | Mida teha |
|---|---|---|
| 400 | invalid_request_error | Paranda päring; tagastatakse ka siis, kui jõuad sinu seatud kulupiirini |
| 401 | authentication_error | Kontrolli, et võti on olemas, õige ega tühistatud |
| 413 | request_too_large | Saada vähem; Messages API võtab vastu kuni 32 MB päringu kohta |
| 429 | rate_limit_error | Oota ja proovi uuesti, arvestades retry-after päist |
| 500 | api_error | Proovi uuesti ooteajaga; kui viga kordub, võta ühendust toega päringu ID-ga |
| 529 | overloaded_error | Ajutine suur liiklus kõigi kasutajate peal; oota ja proovi uuesti |
Anthropicu dokumentatsiooni järgi proovivad ametlikud SDK-d ajutisi tõrkeid (ühenduse vead, piirangud ja 5xx vead) vaikimisi kaks korda automaatselt uuesti eksponentsiaalse ooteajaga, ning seda saab seadistada. Igal vastusel on päis request-id; logi see, et tugi saaks probleeme jälgida.
Levinud vead
- API kutsumine brauserist. Sinu võti muutub avalikuks. Suuna alati läbi oma serveri. Vaata kuidas hoida API-võtmeid turvaliselt.
- Unustada, et
max_tokenson piir, mitte sihtmärk. Sea see sellele, mida funktsioon vajab; liiga madal lõikab vastused katki, liiga kõrge riskib pikkade ja kalliste vastustega. - Reeglite panemine kasutaja sõnumisse. Püsivad juhised kuuluvad
system-promptisse; õigused kuuluvad sinu koodi. - Kogu vestluse saatmine igavesti. Lõika või võta kokku vanad pöörded, kui vestlused kasvavad.
- Kulupiirangu või kasutaja piirangu puudumine.
- Mudeli ID kõvakodeerimine. Mudeleid uuendatakse ja pensionile saadetakse.
- Peatumise põhjuse ignoreerimine. Kui vastus peatus, sest jõudis
max_tokenspiirini, teavita kasutajat või tõsta piiri.
Kontrollnimekiri
- API-võti on loodud Claude Console'is ja salvestatud serveripoolse saladusena
- Testimiseks ja tootmiseks on eraldi võtmed
- Kulupiirang on seatud; kui see saavutatakse, kuvatakse selge teade
- Kõik päringud käivad läbi sinu serveri koos õiguste kontrolliga
- Süsteemiprompt hoiab reegleid; mudeli ID on seadistatav
-
max_tokenson seatud funktsiooni kaupa; pikad vastused voogedastatakse - Rakenduses on kasutajapõhine piirang
- Vead 429 ja 529 on käsitletud ooteajaga; päringu ID-d logitakse
- Viisakas veaolek, mis ei riku lehte
- Testitud tühjade, väga pikkade ja vaenulike sisenditega
Claude API kasutamine Mythexis
Mythexis ehitatud rakendustes kasutavad Claude'i funktsioonid sinu enda Anthropicu võtit ja need arveldatakse sinu Anthropicu kontolt, mitte Mythexi ehituskrediitidelt. See on eraldi agendist, mis kirjutab su koodi. Lisa ANTHROPIC_API_KEY projekti saladusena lehe /secrets kaudu, projekti seadetes või vestluses kuvatava saladuste kaardi kaudu ning kirjelda funktsiooni ülaltoodud promptidega sarnaste promptidega. Pärast saladuste muutmist avaldatud rakenduses avalda uuesti. Alustamiseks sobiva prompti leiad lehelt Lisa AI-funktsioonid oma API-võtmetega. Kui valid pakkujate vahel, katab kuidas integreerida OpenAI API sama teema OpenAI jaoks.
Küsimused
Kuidas saada Claude API võtit?
Logi sisse Claude Console'i aadressil platform.claude.com, seadista arveldus ja loo API-võti. Hoia seda serveripoolse saladusena, tavaliselt nimega ANTHROPIC_API_KEY, ja ära kunagi pane seda brauseri koodi.
Mida Claude API päring vajab?
Anthropicu Messages API viide loetleb 2026. aasta septembri seisuga kolm nõutavat välja: model, max_tokens ja messages. Otsesed HTTP-päringud vajavad ka päiseid x-api-key ja anthropic-version; ametlikud SDK-d seadistavad need sinu eest.
Mis on Claude API viga 529?
Anthropicu veateadete lehel kirjeldatakse viga 529 kui overloaded_error: API on kõigi kasutajate suure liikluse tõttu ajutiselt ülekoormatud. Proovi uuesti eksponentsiaalse viitega ooteajaga. Ametlikud SDK-d proovivad mõned ajutised vead automaatselt uuesti.
Kas ma saan kasutada Claude'i koodiga, mis on kirjutatud OpenAI SDK jaoks?
Anthropic dokumenteerib OpenAI SDK ühilduvuskihti, mille kaudu saab Claude'i kasutada OpenAI SDK liidese kaudu. Uue koodi jaoks annavad Anthropicu enda SDK-d ligipääsu Claude'ile omastele funktsioonidele, seega on need tavaliselt parem alguspunkt.