Sida Loo Ku Daro Claude API App-kaaga
Si aad Claude API-ga ugu dhex dhajiso, samee API key Anthropic Claude Console, kaydi si sir server-ka dhinac ah (badanaa ANTHROPIC_API_KEY), oo wic u dir Messages API route ka server-kaaga adoo isticmaalaya mid ka mid ah SDK-yada rasmiga ah ee Anthropic. Codsi kasta wuxuu magacaabaa model, wuxuu dejiyaa max_tokens (jawaabta ugu dheer ee aad aqbali karto) wuxuuna wada-hadalka u diraa sida messages, tilmaamahaaguna waxay ku jiraan system prompt gooni ah. Dej xad kharash, jawaabaha dheer streaming u samee, oo qaladaadka xadka codsiga (429) iyo buuqa (529) ku maamul dib-u-isku-dayid.
Hagahan wuxuu daboolayaa dejinta, habka codsiga ee amaanka leh, prompts-ka AI builder-ka, iyo qaladaadka loo baahan yahay in la qorsheeyo. Faahfaahinta Anthropic waxay ka soo jeedaan dukumentiyadiisa laga bilaabo Sebtember 2026. Si aad u hesho sida tokens-ka iyo qiimaha u shaqeeyaan guud ahaan, eeg sida loo isticmaalo LLM APIs.
Maxaad ku dhisi kartaa
- Caawiyayaasha chat-ka iyo widgets-ka caawinta (sida loo dhiso app chatbot AI)
- Soo koobid, dib-u-qorid iyo jawaabo la qoray
- Soo saarista goobaha xogta dokumentiyada, emails-ka iyo foomamka
- Jawaabinta su'aalaha ka timaada nuxurkaaga
- Wakiilada wicitaanka function-yada app-kaaga iyada oo loo marayo tool use
Fikrado dheeraad ah, eeg sida loo daro astaamaha AI app-kaaga.
Messages API marka laga hadlayo
Sida ku xusan tixraaca API-ga ee Anthropic, codsi waa POST loo diro https://api.anthropic.com/v1/messages oo leh:
| Qaybta | Waa maxay |
|---|---|
x-api-key madasha | API key-kaaga |
anthropic-version madasha | Nooca API-ga, tusaale 2023-06-01 |
model (waajib) | Model-ka Claude ee la isticmaalayo |
max_tokens (waajib) | Tirada ugu badan ee tokens ee jawaabtu ku jiri karto; model-ku wuu joojin karaa ka hor |
messages (waajib) | Wada-hadalka: wareegyo isdaba-marka ah oo user iyo assistant ah |
system (ikhtiyaari) | Tilmaamaha wada-hadalka oo dhan khuseeya |
stream (ikhtiyaari) | Dej true si aad jawaabta u hesho markay qorneyso, iyadoo la marayo server-sent events |
API-gu ma xasuusto: si aad wada-hadal u sii socoto, mar walba codsi kasta dib u dir wareegyadii hore. Taasi waa sababta chat-yada dheer qiimahoodu ugu sarreeyo fariin kasta.
Anthropic wuxuu daabacaa SDK-yo rasmi ah oo Python, TypeScript, C#, Go, Java, PHP iyo Ruby. Waxay dejiyaan madasha, falanqeeyaan jawaabaha, waxayna taageeraan streaming. Isticmaal mid halkii aad ka isticmaali lahayd HTTP-ga toosta ah, haddii aadan sabab u lahayn mid kale.
Dooritaanka model-ka
Anthropic wuxuu bixiyaa dhowr model oo Claude ah oo isku beddela awoodda, xawaaraha iyo qiimaha, liiskuna wuu isbeddelaa. Dooro model ugu yar oo shaqada si wanaagsan u qabta, tijaabi tusaalooyin dhab ah, oo ku hay model ID-ga habaynta si aad u beddeli karto adigoon koodh beddelin. Hubi bogagga models iyo pricing ee Anthropic doorashooyinka iyo qiimayaasha hadda jira.
Dejinta akoonkaaga
- Ku gal Claude Console oo ku sii platform.claude.com oo ku dar billing.
- Samee API key. Hay hal key deegaan kasta (tijaabo iyo wax soo saar) si aad mid u tirtiri karto adigoon kan kale burin.
- Dej xad kharash. Bogga qaladaadka ee Anthropic wuxuu xusayaa in marka isticmaalku gaadho xadka kharashka aad dejisay, API-gu wuxuu soo celinayaa qalad 400, sidaas darteed app-kaagu waa inuu tus fariin cad markaas.
- Eeg xaddidaadda codsiyada akoonkaaga Console-ka; waxaa lagu cabbiraa ururka.
Habka codsiga
- Isticmaaluhu wuxuu ku dhaqmaa app-ka: wuu diraa fariin, wuu riixaa "Soo koobo".
- Browser-ku wuxuu wacaa server-kaaga route, marna ma wacayo Anthropic si toos ah.
- Server-kaagu wuu hubiyaa in isticmaaluhu galay oo ogol u yahay inuu isticmaalo astaanta, wuxuuna dejiyaa xad isticmaalaha kasta.
- Wuxuu dhisaa codsiga: system prompt leh xeerarkaaga, gelinta isticmaalaha, iyo xogta ay shaqadu u baahan tahay database-kaaga.
- Wuxuu wacaa Messages API adoo isticmaalaya key-ga deegaanka iyo
max_tokensmacquul ah. - Wuxuu jawaabta u streaming-gareeyaa browser-ka wuxuuna diiwaan geliyaa isticmaalka tokens-ka jawaabta.
Doorashooyin iyo is-dhaafsiin
| Go'aanka | Dooro fudud | Marka aad sii socoto |
|---|---|---|
| Streaming | Sug jawaabta oo dhan | Streaming u samee chat-ka iyo waxa kasta oo dheer; Anthropic wuxuu ku talinayaa streaming ama batches codsiyada qaadanaya wakhti dheer |
| Qaabka soo saarka | Qoraal caadi ah | Soo saar JSON qaab qaabaysan marka koodhkaagu u baahan yahay inuu akhriyo goobaha |
| Xogtaada | Ku dar diiwaanka khuseeya | Raadinta nuxurkaaga marka uu aad u badan yahay (waa maxay RAG) |
| Falka | Model-ka kaliya qoraal ayuu qoraa | Tool use, halkaas oo model-ku kaaga codsanayo inay koodhkaagu wax shaqeeyo oo aad qeexday |
| Shaqada badan, ee aan degdegga ahayn | Wareeg shay kasta | Message Batches API, kaas oo aad u gudbiso oo natiijooyinka aad ka codsato |
Prompts-ka aad u dhiibi karto AI builder-kaaga
Astaanta ugu horeysa:
Ku dar gudan "Su'aal ka weydii dukumentigan". Wuxuu wacaa server route POST /api/ask kaas oo hubiya in isticmaaluhu galay oo uu leeyahay dukumentiga, kadibna wuxuu wacaa Claude Messages API adoo isticmaalaya Anthropic SDK rasmiga ah iyo sirta ANTHROPIC_API_KEY. Model ID-ga ka akhri sirta CLAUDE_MODEL. System prompt: "Ka jawaab oo kaliya dukumentiga la siiyay. Haddii jawaabta ku jirin, sheeg taas." U dir qoraalka dukumentiga iyo su'aasha, dej max_tokens 800, jawaabta bogga ugu stream-garee, oo marna ha u muujin key-ga browser-ka.
Ilaalinta iyo qaladaadka:
Xaddid isticmaale kasta 20 su'aal saacadiiba, oo lagu raaco database-ka. Diiwaan geli input iyo output tokens-ka jawaab kasta isticmaale ID iyo request ID. Qaladaadka 429 ama 529, mar kale isku day adigoo sugaya dhimasho exponential ilaa 3 jeer, ixtiraamana header-ka retry-after, kadibna tus "Caawiyaha wuu mashquulsan yahay, isku day waqti kooban gudahood." Haddii API-gu sheego qalad xadka kharashka, tus "Astaamaha AI waa la joojiyay" oo digniiso admin-ka.
Qaladaadka loo baahan yahay in la qorsheeyo
Laga bilaabo dukumentiyada qaladaadka ee Anthropic, kuwa app-kaagu dhab ahaan la kulmi doono:
| Koodhka | Nooca | Waxa la sameeyo |
|---|---|---|
| 400 | invalid_request_error | Hagaaji codsiga; waxaa sidoo kale soo celinaysa markaad gaadho xadka kharashka aad dejisay |
| 401 | authentication_error | Hubi in key-gu jiro, sax yahay oo aan la wada-joojin |
| 413 | request_too_large | U dir wax yar; Messages API wuxuu aqbalaa ilaa 32 MB codsi kasta |
| 429 | rate_limit_error | Dib u joog oo isku day mar kale, ixtiraamana retry-after |
| 500 | api_error | Isku day mar kale adigoo sugaya dib u joog; la xiriir support adigoo leh request ID haddii ay sii socoto |
| 529 | overloaded_error | Taraafik badan oo waqti gaaban ah dhammaan isticmaalayaasha; dib u joog oo isku day mar kale |
Dukumentiyada Anthropic waxay sheegayaan in SDK-yada rasmiga ah si toos ah isku dayaan dib mar labo ah khalkhalka ku meel gaadhka ah (xidhiidhka, xadka codsiyada iyo qaladaadka 5xx) iyagoo adeegsanaya dhimasho exponential, waana la habayn karaa. Jawaab kasta waxay leedahay request-id header; diiwaan geli si support-ku u raadin karo dhibaatooyinka.
Khaladaadka caadiga ah
- In API-ga laga wacdo browser-ka. Key-gaagu wuxuu noqonayaa mid dadweyne. Had iyo jeer server-kaaga marayso. Eeg sida loo ilaaliyo API keys.
- In la illaawo in
max_tokensuu yahay xadka, ma aha bartilmaameedka. Dejiso sida astaanta u baahan tahay; mid hooseeya ayaa jawaabaha jaraa, mid sare ahna wuxuu keenaa jawaabo dheer oo qaali ah. - In xeerarka lagu dhejiyo fariinta isticmaalaha. Tilmaamaha joogtada ah waa inay ku jiraan system prompt; ogolaanshaha waa inay ku jiraan koodhkaaga.
- In wada-hadalka oo dhan had iyo jeer la diro. Jar ama soo koobi wareegyada hore marka wada-hadalku weynaado.
- In aan xad kharash ama xad isticmaale la dejin.
- In model ID la qoro si adag. Models waa la cusboonaysiiyaa oo la joojiyaa.
- In stop reason la dhegaysan. Haddii jawaabtu joogsatay sababtoo ah gaadhay
max_tokens, u sheeg isticmaalaha ama kor u qaad xadka.
Liiska hubinta
- API key waa la sameeyay Claude Console-ka oo waxaa loo kaydiyay sir server-ka dhinac ah
- Keys gooni ah oo loo leeyahay tijaabada iyo wax soo saarka
- Xadka kharashka waa la dejiyay; fariin cad marka la gaadho
- Dhammaan codsiyada waxay server-kaaga ku maraan hubinta ogolaanshaha
- System prompt wuxuu hayaa xeerarka; model ID waa la habayn karaa
-
max_tokenswaa la dejiyay astaan kasta; jawaabaha dheer waa la streaming-gareeyay - Xadka codsiga isticmaale kasta app-kaaga
- 429 iyo 529 waa la maamulay dib u joog; request IDs waa la diiwaan geliyay
- Xaalad qalad oo xishood leh oo aan bogga jebinin
- Waa la tijaabiyay gelinta maran, dheer iyo mid cadaawe leh
Isticmaalka Claude API ee Mythex
App-yada aad ku dhisato Mythex, astaamaha Claude waxay isticmaalaan key Anthropic-kaaga oo lacagta waxaa laga jaraa akoonkaaga Anthropic, ma aha credits-ka dhisidda Mythex. Taasi way ka madax-banaan tahay wakiilka Mythex ee qoraya koodhkaaga. Ku dar ANTHROPIC_API_KEY sida mashruuca sirta ah adoo marayo /secrets, dejinta mashruuca ama kaarta sirta ee chat-ka, kadibna qeex astaanta adoo isticmaalaya prompts-ka sare ku xusan. Mar kale soo daabac markaad beddesho sirta app-ka firfircoon. Eeg Ku dar astaamaha AI adoo isticmaalaya API keys-kaaga prompt bilow ah. Haddii aad dooranayso bixiyeyaal kala duwan, sida loo ku daro OpenAI API wuxuu ku daboolayaa isla arrintan OpenAI.
Su'aalaha
Sidee u helaa Claude API key?
Ku gal Claude Console ee platform.claude.com, deji billing, oo abuur API key. Kaydi sir server-ka dhinac ah, oo magacii caadiga ah ahaa ANTHROPIC_API_KEY, marna ha dhigin code-ka browser-ka.
Maxaa codsi Claude API ah u baahan?
Laga bilaabo Sebtember 2026, tixraaca Messages API ee Anthropic waxay liisanaysaa saddex goob oo qasab ah oo jidhka codsiga ku jira: model, max_tokens iyo messages. Wicitaanada HTTP ee tooska ah waxay sidoo kale u baahan yihiin madasha x-api-key iyo anthropic-version; SDK-yada rasmiga ahi way dejiyaan iyaga.
Waa maxay qaladka 529 ee Claude API?
Bogga qaladaadka ee Anthropic wuxuu 529 ku tilmaamaa overloaded_error: API-gu wuu buuqsanaa waqti yar sababta oo ah taraafik badan dhammaan isticmaalayaasha. Isku day mar kale adigoo sugaya dhimasho exponential ah. SDK-yada rasmiga ah way isku dayaan qaar ka mid ah qaladaadka ku meel gaadhka ah si toos ah.
Ma isticmaali karaa Claude koodh loo qoray OpenAI SDK?
Anthropic wuxuu dukumentiyey lakabka isku-habboonaanta OpenAI SDK si aad Claude ugu isticmaasho dusha OpenAI SDK. Koodhka cusub, SDK-yadeeda gaarka ahi waxay siiyaan astaamaha gaarka u ah Claude, sidaas darteed badanaa waa bilow ka wanaagsan.