మీ యాప్‌లో Claude API ను ఎలా ఇంటిగ్రేట్ చేయాలి
Claude API ను ఇంటిగ్రేట్ చేయడానికి, Anthropic యొక్క Claude Console లో API కీ సృష్టించండి, దాన్ని సర్వర్ వైపు సీక్రెట్గా (సాధారణంగా ANTHROPIC_API_KEY) నిల్వ చేయండి, మరియు Anthropic అధికారిక SDKలలో ఒకదాన్ని ఉపయోగించి మీ స్వంత సర్వర్‌లోని రూట్ నుంచి Messages API ను కాల్ చేయండి. ప్రతి రిక్వెస్ట్ ఒక model పేర్కొంటుంది, max_tokens (మీరు అంగీకరించే అత్యంత పొడవైన రిప్లై) సెట్ చేస్తుంది, మరియు సంభాషణను messages గా పంపుతుంది, మీ సూచనలు వేరుగా ఉన్న system ప్రాంప్ట్‌లో ఉంటాయి. స్పెండ్ లిమిట్ సెట్ చేయండి, పొడవైన రిప్లైలను స్ట్రీమ్ చేయండి, మరియు రేట్-లిమిట్ (429) మరియు ఓవర్‌లోడ్ (529) ఎర్రర్లను రీట్రైలతో నిర్వహించండి.
ఈ గైడ్ సెటప్, సురక్షితమైన రిక్వెస్ట్ ఫ్లో, AI బిల్డర్‌కు ప్రాంప్ట్‌లు, మరియు మీరు ఆశించాల్సిన ఎర్రర్లను కవర్ చేస్తుంది. Anthropic వివరాలు సెప్టెంబర్ 2026 నాటి దాని డాక్యుమెంటేషన్ ఆధారంగా ఉన్నాయి. టోకెన్లు మరియు ధరలు సాధారణంగా ఎలా పని చేస్తాయో తెలుసుకోవడానికి, LLM APIs ను ఎలా ఉపయోగించాలి చూడండి.
దీనితో మీరు ఏమి నిర్మించవచ్చు
- చాట్ అసిస్టెంట్లు మరియు హెల్ప్ విడ్జెట్‌లు (AI చాట్‌బాట్ యాప్‌ను ఎలా నిర్మించాలి)
- సారాంశాలు, రీరైట్‌లు మరియు రూపొందించిన రిప్లైలు
- పత్రాలు, ఇమెయిల్‌లు మరియు ఫారమ్‌ల నుంచి ఫీల్డ్‌లను సేకరించడం
- మీ స్వంత కంటెంట్ గురించి ప్రశ్నలకు సమాధానాలు
- టూల్ యూజ్ ద్వారా మీ యాప్ ఫంక్షన్లను కాల్ చేసే ఏజెంట్లు
మరిన్ని ఆలోచనల కోసం, మీ యాప్‌కు AI ఫీచర్లు ఎలా జోడించాలి చూడండి.
Messages API ఒక్కమాటలో
Anthropic API రిఫరెన్స్ ప్రకారం, ఒక రిక్వెస్ట్ https://api.anthropic.com/v1/messages కు POST అవుతుంది, వీటితో:
| భాగం | ఇది ఏమిటి |
|---|---|
x-api-key హెడర్ | మీ API కీ |
anthropic-version హెడర్ | API వెర్షన్, ఉదాహరణకు 2023-06-01 |
model (తప్పనిసరి) | ఏ Claude మోడల్ వాడాలి |
max_tokens (తప్పనిసరి) | రిప్లై కలిగి ఉండే గరిష్ట టోకెన్లు; మోడల్ ముందే ఆగిపోవచ్చు |
messages (తప్పనిసరి) | సంభాషణ: user మరియు assistant టర్న్‌లు ప్రత్యామ్నాయంగా |
system (ఐచ్ఛికం) | మొత్తం సంభాషణకు వర్తించే సూచనలు |
stream (ఐచ్ఛికం) | రిప్లై రాస్తున్నప్పుడే పొందడానికి true సెట్ చేయండి, server-sent events ద్వారా |
API స్టేట్‌లెస్: సంభాషణను కొనసాగించడానికి, ప్రతి రిక్వెస్ట్‌తో మునుపటి టర్న్‌లను మళ్లీ పంపాలి. అందుకే పొడవైన చాట్‌లకు ప్రతి మెసేజ్‌కు ఎక్కువ ఖర్చవుతుంది.
Anthropic Python, TypeScript, C#, Go, Java, PHP మరియు Ruby కోసం అధికారిక SDKలను ప్రచురిస్తుంది. అవి హెడర్‌లను సెట్ చేస్తాయి, రిస్పాన్స్‌లను పార్స్ చేస్తాయి, మరియు స్ట్రీమింగ్‌కు మద్దతు ఇస్తాయి. ప్రత్యేక కారణం లేకపోతే, రా HTTP కు బదులు ఒకదాన్ని ఉపయోగించండి.
మోడల్‌ను ఎంచుకోవడం
Anthropic అనేక Claude మోడళ్లను అందిస్తుంది, ఇవి సామర్థ్యం, వేగం మరియు ధర మధ్య వ్యత్యాసం చూపుతాయి, మరియు ఈ జాబితా మారుతూ ఉంటుంది. మీ పని బాగా చేసే అతిచిన్న మోడల్‌ను ఎంచుకోండి, నిజమైన ఉదాహరణలపై పరీక్షించండి, మరియు మోడల్ ID ను కాన్ఫిగరేషన్‌లో ఉంచండి, తద్వారా కోడ్ మార్చకుండా మార్చవచ్చు. ప్రస్తుత ఎంపికలు మరియు రేట్ల కోసం Anthropic మోడల్స్ మరియు ప్రైసింగ్ పేజీలు చూడండి.
మీ ఖాతాను సెటప్ చేయడం
- platform.claude.com లోని Claude Console కి సైన్ ఇన్ చేసి బిల్లింగ్ జోడించండి.
- API కీ సృష్టించండి. ప్రతి ఎన్విరాన్‌మెంట్ (టెస్టింగ్ మరియు ప్రొడక్షన్) కు ఒక కీ ఉంచండి, తద్వారా ఒకదాన్ని రద్దు చేసినా మరొకటి పాడవదు.
- స్పెండ్ లిమిట్ సెట్ చేయండి. మీరు సెట్ చేసిన స్పెండ్ లిమిట్‌ను వినియోగం చేరుకున్నప్పుడు API 400 ఎర్రర్ ఇస్తుందని Anthropic ఎర్రర్స్ పేజీ పేర్కొంటుంది, కాబట్టి అది జరిగినప్పుడు మీ యాప్ స్పష్టమైన సందేశం చూపాలి.
- Console లో మీ ఖాతాకు రేట్ లిమిట్‌లను సమీక్షించండి; అవి ఆర్గనైజేషన్ వారీగా కొలవబడతాయి.
రిక్వెస్ట్ ఫ్లో
- యూజర్ మీ యాప్‌లో చర్య తీసుకుంటాడు: మెసేజ్ పంపుతాడు, లేదా “Summarise” క్లిక్ చేస్తాడు.
- బ్రౌజర్ మీ సర్వర్ రూట్‌ను కాల్ చేస్తుంది, Anthropic ను నేరుగా ఎప్పుడూ కాదు.
- మీ సర్వర్ యూజర్ లాగిన్ అయ్యాడో, ఫీచర్ వాడటానికి అనుమతి ఉందో తనిఖీ చేస్తుంది, మరియు ప్రతి-యూజర్ లిమిట్‌ను వర్తింపజేస్తుంది.
- ఇది రిక్వెస్ట్‌ను నిర్మిస్తుంది: మీ నియమాలతో కూడిన system ప్రాంప్ట్, యూజర్ ఇన్‌పుట్, మరియు టాస్క్‌కు కావలసిన ఏదైనా డేటా.
- ఎన్విరాన్‌మెంట్ నుంచి కీతో మరియు సరైన
max_tokensతో Messages API ను కాల్ చేస్తుంది. - రిప్లైను బ్రౌజర్‌కు స్ట్రీమ్ చేస్తుంది, మరియు రిస్పాన్స్ నుంచి టోకెన్ వినియోగాన్ని లాగ్ చేస్తుంది.
ఎంపికలు మరియు ట్రేడ్-ఆఫ్‌లు
| నిర్ణయం | సరళమైన ఎంపిక | ఎప్పుడు ఇంకా ముందుకు వెళ్లాలి |
|---|---|---|
| స్ట్రీమింగ్ | పూర్తి రిప్లై కోసం వేచి ఉండడం | చాట్ మరియు పొడవైన దేనికైనా స్ట్రీమ్ చేయండి; Anthropic ఎక్కువ సమయం పట్టే రిక్వెస్ట్‌లకు స్ట్రీమింగ్ లేదా బ్యాచ్‌లను సిఫార్సు చేస్తుంది |
| అవుట్‌పుట్ ఫార్మాట్ | సాధారణ టెక్స్ట్ | మీ కోడ్ ఫీల్డ్‌లను చదవాల్సి వచ్చినప్పుడు స్ట్రక్చర్డ్ JSON అవుట్‌పుట్ |
| మీ డేటా | సంబంధిత రికార్డ్‌ను చేర్చడం | చాలా ఎక్కువ ఉన్నప్పుడు మీ కంటెంట్‌పై రిట్రీవల్ (RAG అంటే ఏమిటి) |
| చర్యలు | మోడల్ టెక్స్ట్ మాత్రమే రాస్తుంది | టూల్ యూజ్, ఇక్కడ మోడల్ మీరు నిర్వచించిన ఫంక్షన్‌ను నడపమని మీ కోడ్‌ను అడుగుతుంది |
| బల్క్, అత్యవసరం కాని పని | ఐటమ్‌లపై లూప్ | Message Batches API, దాన్ని సమర్పించి ఫలితాల కోసం పోల్ చేయండి |
మీ AI బిల్డర్‌కు ఇచ్చే ప్రాంప్ట్‌లు
మొదటి ఫీచర్:
“Ask about this document” ప్యానెల్ జోడించండి. ఇది సర్వర్ రూట్ POST /api/ask ను కాల్ చేస్తుంది, ఇది యూజర్ లాగిన్ అయ్యాడో మరియు డాక్యుమెంట్ యజమాని అవునో తనిఖీ చేస్తుంది, తర్వాత అధికారిక Anthropic SDK మరియు సీక్రెట్ ANTHROPIC_API_KEY తో Claude Messages API ను కాల్ చేస్తుంది. మోడల్ ID ను సీక్రెట్ CLAUDE_MODEL నుంచి చదవండి. System ప్రాంప్ట్: “ఇచ్చిన డాక్యుమెంట్ నుంచే సమాధానం ఇవ్వండి. సమాధానం అందులో లేకపోతే, అలా చెప్పండి.” డాక్యుమెంట్ టెక్స్ట్ మరియు ప్రశ్నను పంపండి, max_tokens ను 800 కు సెట్ చేయండి, సమాధానాన్ని పేజీకి స్ట్రీమ్ చేయండి, మరియు కీని ఎప్పుడూ బ్రౌజర్‌కు బహిర్గతం చేయకండి.
గార్డ్‌రెయిల్స్ మరియు ఎర్రర్లు:
ప్రతి యూజర్‌కు గంటకు 20 ప్రశ్నలకు పరిమితి పెట్టండి, డేటాబేస్‌లో ట్రాక్ చేయండి. ప్రతి రిస్పాన్స్ నుంచి ఇన్‌పుట్ మరియు అవుట్‌పుట్ టోకెన్లను యూజర్ ID మరియు రిక్వెస్ట్ ID తో లాగ్ చేయండి. 429 లేదా 529 ఎర్రర్లపై, ఎక్స్‌పోనెన్షియల్ బ్యాక్‌ఆఫ్‌తో 3 సార్లు వరకు మళ్లీ ప్రయత్నించండి, retry-after హెడర్‌ను గౌరవిస్తూ, తర్వాత “The assistant is busy, try again shortly.” అని చూపించండి. API స్పెండ్ లిమిట్ ఎర్రర్ ఇస్తే, “AI features are paused” అని చూపించి అడ్మిన్‌కు హెచ్చరించండి.
మీరు ఎదుర్కొనే ఎర్రర్లు
Anthropic ఎర్రర్స్ డాక్యుమెంటేషన్ నుంచి, మీ యాప్ నిజంగా ఎదుర్కొనేవి:
| కోడ్ | రకం | ఏం చేయాలి |
|---|---|---|
| 400 | invalid_request_error | రిక్వెస్ట్‌ను సరిచేయండి; మీరు సెట్ చేసిన స్పెండ్ లిమిట్‌ను చేరుకున్నప్పుడు కూడా ఇది వస్తుంది |
| 401 | authentication_error | కీ ఉందో, సరైనదో, మరియు రద్దు కాలేదో తనిఖీ చేయండి |
| 413 | request_too_large | తక్కువ పంపండి; Messages API ఒక్కో రిక్వెస్ట్‌కు 32 MB వరకు అంగీకరిస్తుంది |
| 429 | rate_limit_error | retry-after ను గౌరవిస్తూ బ్యాక్ ఆఫ్ చేసి మళ్లీ ప్రయత్నించండి |
| 500 | api_error | బ్యాక్‌ఆఫ్‌తో మళ్లీ ప్రయత్నించండి; ఇది కొనసాగితే రిక్వెస్ట్ ID తో సపోర్ట్‌ను సంప్రదించండి |
| 529 | overloaded_error | అన్ని యూజర్ల నుంచి తాత్కాలిక అధిక ట్రాఫిక్; బ్యాక్ ఆఫ్ చేసి మళ్లీ ప్రయత్నించండి |
Anthropic డాక్యుమెంట్‌ల ప్రకారం, అధికారిక SDKలు తాత్కాలిక వైఫల్యాలను (కనెక్షన్ ఎర్రర్లు, రేట్ లిమిట్‌లు మరియు 5xx ఎర్రర్లు) డిఫాల్ట్‌గా రెండు సార్లు ఎక్స్‌పోనెన్షియల్ బ్యాక్‌ఆఫ్‌తో స్వయంచాలకంగా మళ్లీ ప్రయత్నిస్తాయి, మరియు మీరు దాన్ని కాన్ఫిగర్ చేయవచ్చు. ప్రతి రిస్పాన్స్‌లో request-id హెడర్ ఉంటుంది; సపోర్ట్ సమస్యలను ట్రేస్ చేయగలిగేలా దాన్ని లాగ్ చేయండి.
సాధారణ తప్పులు
- బ్రౌజర్ నుంచి API ను కాల్ చేయడం. మీ కీ బహిరంగమవుతుంది. ఎప్పుడూ మీ సర్వర్ ద్వారానే వెళ్లండి. API కీలను ఎలా సురక్షితంగా ఉంచాలి చూడండి.
max_tokensఅనేది లక్ష్యం కాదు, పరిమితి అని మర్చిపోవడం. ఫీచర్‌కు అవసరమైనదానికి సెట్ చేయండి; చాలా తక్కువైతే సమాధానాలు కత్తిరించబడతాయి, చాలా ఎక్కువైతే పొడవైన, ఖర్చుతో కూడిన రిప్లైలు వస్తాయి.- యూజర్ మెసేజ్‌లో నియమాలు పెట్టడం. స్థిరమైన సూచనలు
systemప్రాంప్ట్‌లో ఉండాలి; అనుమతులు మీ కోడ్‌లో ఉండాలి. - సంభాషణ మొత్తం ఎప్పటికీ పంపడం. సంభాషణలు పెరిగేకొద్దీ పాత టర్న్‌లను ట్రిమ్ చేయండి లేదా సారాంశం చేయండి.
- స్పెండ్ లిమిట్ లేదా ప్రతి-యూజర్ పరిమితి లేకపోవడం.
- మోడల్ ID ను హార్డ్-కోడ్ చేయడం. మోడళ్లు అప్‌డేట్ అవుతాయి మరియు రిటైర్ అవుతాయి.
- స్టాప్ రీజన్‌ను పట్టించుకోకపోవడం. రిప్లై
max_tokensచేరుకోవడం వల్ల ఆగిపోతే, యూజర్‌కు చెప్పండి లేదా పరిమితిని పెంచండి.
చెక్‌లిస్ట్
- Claude Console లో API కీ సృష్టించబడింది మరియు సర్వర్ వైపు సీక్రెట్గా నిల్వ చేయబడింది
- టెస్టింగ్ మరియు ప్రొడక్షన్ కోసం వేర్వేరు కీలు
- స్పెండ్ లిమిట్ సెట్ చేయబడింది; చేరుకున్నప్పుడు స్పష్టమైన సందేశం
- అన్ని రిక్వెస్ట్‌లు అనుమతి తనిఖీలతో మీ సర్వర్ ద్వారా వెళ్తాయి
- System ప్రాంప్ట్‌లో నియమాలు; మోడల్ ID కాన్ఫిగర్ చేయదగినది
- ప్రతి ఫీచర్‌కు
max_tokensసెట్ చేయబడింది; పొడవైన రిప్లైలు స్ట్రీమ్ చేయబడతాయి - మీ యాప్‌లో ప్రతి-యూజర్ రేట్ లిమిట్
- 429 మరియు 529 బ్యాక్‌ఆఫ్‌తో నిర్వహించబడ్డాయి; రిక్వెస్ట్ IDలు లాగ్ చేయబడ్డాయి
- పేజీని పాడుచేయని స్నేహపూర్వక ఎర్రర్ స్థితి
- ఖాళీ, చాలా పొడవైన మరియు శత్రుత్వ ఇన్‌పుట్‌లతో పరీక్షించబడింది
Mythex లో Claude API ను వాడటం
మీరు Mythex పై నిర్మించే యాప్‌లలో, Claude ఫీచర్లు మీ స్వంత Anthropic కీని ఉపయోగిస్తాయి మరియు అవి Mythex బిల్డ్ క్రెడిట్స్‌కు కాదు, మీ Anthropic ఖాతాకు బిల్ చేయబడతాయి. ఇది మీ కోడ్ రాసే Mythex ఏజెంట్ నుంచి వేరుగా ఉంటుంది. /secrets, ప్రాజెక్ట్ సెట్టింగ్‌లు లేదా చాట్‌లోని సీక్రెట్స్ కార్డ్ ద్వారా ANTHROPIC_API_KEY ను ప్రాజెక్ట్ సీక్రెట్గా జోడించండి, తర్వాత పైన ఉన్నట్లుగా ప్రాంప్ట్‌లతో ఫీచర్ వివరించండి. లైవ్ యాప్‌లో సీక్రెట్స్ మార్చిన తర్వాత మళ్లీ పబ్లిష్ చేయండి. మొదటి ప్రాంప్ట్ కోసం మీ స్వంత API కీలతో AI ఫీచర్లు జోడించడం చూడండి. ప్రొవైడర్ల మధ్య ఎంచుకుంటుంటే, OpenAI API ను ఎలా ఇంటిగ్రేట్ చేయాలి OpenAI కోసం అదే విషయాలను కవర్ చేస్తుంది.
ప్రశ్నలు
Claude API కీ ఎలా పొందాలి?
platform.claude.com లో Claude Console కి సైన్ ఇన్ చేయండి, బిల్లింగ్ సెటప్ చేయండి, మరియు API కీ సృష్టించండి. దాన్ని సర్వర్ వైపు సీక్రెట్గా నిల్వ చేయండి, సాధారణంగా ANTHROPIC_API_KEY అనే పేరుతో, మరియు ఎప్పుడూ బ్రౌజర్ కోడ్‌లో పెట్టకండి.
Claude API కు రిక్వెస్ట్‌కు ఏమేం కావాలి?
సెప్టెంబర్ 2026 నాటికి, Anthropic యొక్క Messages API రిఫరెన్స్ మూడు తప్పనిసరి బాడీ ఫీల్డ్‌లను జాబితా చేస్తుంది: model, max_tokens మరియు messages. నేరుగా HTTP కాల్స్‌కు x-api-key మరియు anthropic-version హెడర్‌లు కూడా కావాలి; అధికారిక SDKలు వాటిని మీ కోసం సెట్ చేస్తాయి.
Claude API నుంచి 529 ఎర్రర్ అంటే ఏమిటి?
Anthropic యొక్క ఎర్రర్స్ పేజీ 529 ను overloaded_error గా వివరిస్తుంది: అన్ని యూజర్ల నుంచి అధిక ట్రాఫిక్ వల్ల API తాత్కాలికంగా ఓవర్‌లోడ్ అయింది. ఎక్స్‌పోనెన్షియల్ బ్యాక్‌ఆఫ్‌తో మళ్లీ ప్రయత్నించండి. అధికారిక SDKలు కొన్ని తాత్కాలిక ఎర్రర్లను స్వయంగా మళ్లీ ప్రయత్నిస్తాయి.
OpenAI SDK కోసం రాసిన కోడ్‌తో Claude ను వాడవచ్చా?
OpenAI SDK ఇంటర్‌ఫేస్ ద్వారా Claude ను వాడటానికి Anthropic ఒక కంపాటిబిలిటీ లేయర్‌ను డాక్యుమెంట్ చేస్తుంది. కొత్త కోడ్ కోసం, దాని స్వంత SDKలు Claude-నిర్దిష్ట ఫీచర్లను అందిస్తాయి, కాబట్టి అవి సాధారణంగా మంచి ప్రారంభ బిందువు.