तुमच्या ॲपमध्ये 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 API कसे वापरायचे पहा.
तुम्ही यासह काय बनवू शकता
- चॅट सहाय्यक आणि मदत विजेट्स (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 की तयार करा. चाचणी आणि उत्पादन प्रत्येकासाठी एक की ठेवा, जेणेकरून एक रद्द केल्याने दुसरी तुटणार नाही.
- खर्चाची मर्यादा सेट करा. Anthropic च्या एरर पानानुसार, तुम्ही सेट केलेली खर्च मर्यादा गाठल्यावर API 400 एरर देते, म्हणून तेव्हा तुमच्या ॲपने स्पष्ट संदेश दाखवावा.
- Console मध्ये तुमच्या खात्यासाठी रेट लिमिट्स तपासा; त्या संस्थेनुसार मोजल्या जातात.
रिक्वेस्ट फ्लो
- वापरकर्ता तुमच्या ॲपमध्ये कृती करतो: संदेश पाठवतो, "Summarise" वर क्लिक करतो.
- ब्राउझर तुमच्या सर्व्हर राउटला कॉल करतो, कधीही Anthropic ला थेट नाही.
- तुमचा सर्व्हर तपासतो की वापरकर्ता लॉग इन आहे आणि फीचर वापरण्याची परवानगी आहे, आणि प्रति-वापरकर्ता मर्यादा लागू करतो.
- ते रिक्वेस्ट तयार करते: तुमच्या नियमांसह एक system प्रॉम्प्ट, वापरकर्त्याचा इनपुट, आणि कार्याला लागणारा कोणताही डेटा तुमच्या डेटाबेसमधून.
- ते वातावरणातील की आणि योग्य
max_tokensसह Messages API कॉल करते. - ते उत्तर ब्राउझरला स्ट्रीम करते आणि प्रतिसादातून टोकन वापराची नोंद ठेवते.
पर्याय आणि तडजोडी
| निर्णय | सोपी निवड | कधी पुढे जायचे |
|---|---|---|
| स्ट्रीमिंग | संपूर्ण उत्तराची वाट पाहा | चॅट आणि लांब उत्तरांसाठी स्ट्रीम करा; Anthropic दीर्घकाळ चालणाऱ्या रिक्वेस्टसाठी स्ट्रीमिंग किंवा बॅचेसची शिफारस करते |
| आउटपुट फॉरमॅट | प्लेन टेक्स्ट | तुमच्या कोडला फील्ड्स वाचायचे असतील तेव्हा structured JSON आउटपुट |
| तुमचा डेटा | संबंधित रेकॉर्ड समाविष्ट करा | खूप जास्त असल्यास तुमच्या कंटेंटवर retrieval (RAG म्हणजे काय) |
| कृती | मॉडेल फक्त मजकूर लिहितो | टूल यूज, जिथे मॉडेल तुम्ही परिभाषित केलेले फंक्शन चालवण्यास तुमच्या कोडला सांगते |
| मोठ्या प्रमाणावरील, तातडीचे नसलेले काम | आयटम्सवर लूप चालवा | Message Batches API, जिथे तुम्ही सबमिट करून परिणामांसाठी पोल करता |
तुमच्या AI बिल्डरसाठी प्रॉम्प्ट्स
पहिले फीचर:
एक "Ask about this document" पॅनल जोडा. ते सर्व्हर राउट POST /api/ask ला कॉल करते, जो तपासतो की वापरकर्ता लॉग इन आहे आणि दस्तऐवजाचा मालक आहे, आणि नंतर अधिकृत Anthropic SDK आणि सिक्रेट ANTHROPIC_API_KEY वापरून Claude Messages API कॉल करते. CLAUDE_MODEL या सिक्रेटमधून मॉडेल ID वाचा. System प्रॉम्प्ट: "फक्त दिलेल्या दस्तऐवजावरून उत्तर द्या. उत्तर त्यात नसेल तर तसे सांगा." दस्तऐवजाचा मजकूर आणि प्रश्न पाठवा, max_tokens 800 ठेवा, उत्तर पेजवर स्ट्रीम करा, आणि कधीही की ब्राउझरला उघड करू नका.
सुरक्षा रक्षक आणि एरर्स:
प्रत्येक वापरकर्त्याला तासाला 20 प्रश्नांची मर्यादा घाला, डेटाबेसमध्ये नोंदवलेली. प्रत्येक प्रतिसादातील इनपुट आणि आउटपुट टोकन्स वापरकर्ता ID आणि रिक्वेस्ट ID सह नोंदवा. 429 किंवा 529 एरर आल्यास, एक्स्पोनेन्शियल बॅकऑफसह 3 वेळा पर्यंत पुन्हा प्रयत्न करा, retry-after हेडरचा आदर करून, आणि नंतर "सहाय्यक व्यस्त आहे, कृपया लवकरच पुन्हा प्रयत्न करा." दाखवा. API ने खर्च मर्यादेची एरर दिल्यास, "AI फीचर्स थांबवली आहेत" दाखवा आणि ॲडमिनला सूचित करा.
नियोजन करायच्या एरर्स
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 वापरता येईल का?
Anthropic OpenAI SDK च्या माध्यमातून Claude वापरण्यासाठी एक OpenAI SDK compatibility layer दस्तऐवजीकरण करते. नव्या कोडसाठी, त्यांचे स्वतःचे SDK Claude-विशिष्ट फीचर्स देतात, त्यामुळे ते सहसा चांगली सुरुवात असतात.