अपने ऐप में Claude API कैसे जोड़ें

Claude API को इंटीग्रेट करने के लिए, Anthropic के Claude Console में एक API key बनाएं, उसे सर्वर-साइड सीक्रेट के रूप में सेव करें (आमतौर पर ANTHROPIC_API_KEY), और अपने सर्वर के एक रूट से Anthropic के आधिकारिक SDK में से किसी एक के ज़रिए Messages API को कॉल करें। हर रिक्वेस्ट में एक model का नाम होता है, max_tokens सेट होता है (जितना लंबा जवाब आप स्वीकार करेंगे), और बातचीत messages के रूप में जाती है, जबकि आपके निर्देश अलग system prompt में होते हैं। खर्च की सीमा (spend limit) तय करें, लंबे जवाब स्ट्रीम करें, और rate-limit (429) और overload (529) errors को retries के साथ संभालें।

यह गाइड सेटअप, एक सुरक्षित रिक्वेस्ट फ़्लो, AI बिल्डर के लिए prompts, और जिन errors का सामना करना पड़ सकता है उन्हें कवर करती है। Anthropic की जानकारी सितंबर 2026 तक के उसके दस्तावेज़ से ली गई है। टोकन और प्राइसिंग सामान्य रूप से कैसे काम करती है, इसके लिए पहले LLM APIs कैसे इस्तेमाल करें पढ़ें।

इससे आप क्या बना सकते हैं

चैट असिस्टेंट और हेल्प विजेट (AI चैटबॉट ऐप कैसे बनाएं)
सारांश, फिर से लिखना और ड्राफ़्ट किए गए जवाब
दस्तावेज़ों, ईमेल और फ़ॉर्म से फ़ील्ड निकालना
आपकी अपनी सामग्री से सवालों के जवाब देना
ऐसे एजेंट जो tool use के ज़रिए आपके ऐप के फ़ंक्शन कॉल करते हैं

और आइडिया के लिए देखें अपने ऐप में AI फ़ीचर कैसे जोड़ें।

Messages API एक नज़र में

Anthropic के API रेफ़रेंस के अनुसार, एक रिक्वेस्ट https://api.anthropic.com/v1/messages पर POST होती है, जिसमें:

हिस्सा	यह क्या है
`x-api-key` हेडर	आपकी API key
`anthropic-version` हेडर	API का वर्शन, जैसे `2023-06-01`
`model` (ज़रूरी)	कौन-सा Claude model इस्तेमाल करना है
`max_tokens` (ज़रूरी)	जवाब में अधिकतम कितने टोकन हो सकते हैं; model इससे पहले रुक भी सकता है
`messages` (ज़रूरी)	बातचीत: `user` और `assistant` टर्न बारी-बारी से
`system` (वैकल्पिक)	निर्देश जो पूरी बातचीत पर लागू होते हैं
`stream` (वैकल्पिक)	जवाब लिखे जाते समय पाने के लिए `true` सेट करें, server-sent events के ज़रिए

API स्टेटलेस है: बातचीत जारी रखने के लिए हर रिक्वेस्ट के साथ पिछले टर्न फिर से भेजने होते हैं। इसीलिए लंबी चैट का हर मैसेज ज़्यादा खर्च करता है।

Anthropic Python, TypeScript, C#, Go, Java, PHP और Ruby के लिए आधिकारिक SDK प्रकाशित करता है। ये हेडर सेट करते हैं, जवाब पार्स करते हैं, और streaming सपोर्ट करते हैं। किसी ख़ास कारण के बिना कच्चे HTTP के बजाय इनमें से एक इस्तेमाल करें।

model चुनना

Anthropic कई Claude models देता है जो क्षमता, गति और कीमत के बीच अलग-अलग संतुलन रखते हैं, और इनकी लाइन-अप बदलती रहती है। वह सबसे छोटा model चुनें जो आपका काम अच्छे से करे, उसे असली उदाहरणों पर टेस्ट करें, और model ID को कॉन्फ़िगरेशन में रखें ताकि कोड बदले बिना बदला जा सके। मौजूदा विकल्पों और दरों के लिए Anthropic के models और pricing पेज देखें।

अपना अकाउंट सेट करना

Claude Console में साइन इन करें platform.claude.com पर और बिलिंग जोड़ें।
एक API key बनाएं। हर environment (टेस्टिंग और प्रोडक्शन) के लिए एक key रखें, ताकि एक को रद्द करने से दूसरी न टूटे।
खर्च की सीमा सेट करें। Anthropic का errors पेज बताता है कि जब आपके सेट की हुई spend limit तक usage पहुँचता है, तो API 400 error लौटाता है, इसलिए आपके ऐप को उस स्थिति में साफ़ संदेश दिखाना चाहिए।
Rate limits देखें Console में आपके अकाउंट के लिए; ये organization के हिसाब से मापी जाती हैं।

रिक्वेस्ट का फ़्लो

यूज़र आपके ऐप में कुछ करता है: मैसेज भेजता है, "Summarise" पर क्लिक करता है।
ब्राउज़र आपके सर्वर रूट को कॉल करता है, Anthropic को सीधे कभी नहीं।
आपका सर्वर जाँचता है कि यूज़र लॉग इन है और इस फ़ीचर की अनुमति है, और प्रति-यूज़र सीमा लागू करता है।
यह रिक्वेस्ट बनाता है: आपके नियमों वाला system prompt, यूज़र का इनपुट, और कार्य के लिए ज़रूरी कोई भी डेटा आपके डेटाबेस से।
यह environment की key और एक उचित max_tokens के साथ Messages API को कॉल करता है।
यह जवाब को ब्राउज़र पर स्ट्रीम करता है और रिस्पॉन्स से टोकन उपयोग लॉग करता है।

विकल्प और ट्रेड-ऑफ़

निर्णय	सरल विकल्प	कब आगे जाएं
Streaming	पूरे जवाब का इंतज़ार	चैट और किसी भी लंबे काम के लिए स्ट्रीम करें; Anthropic लंबे चलने वाले अनुरोधों के लिए streaming या batches की सलाह देता है
आउटपुट फ़ॉर्मेट	सादा टेक्स्ट	जब आपके कोड को फ़ील्ड पढ़ने हों तो structured JSON आउटपुट
आपका डेटा	संबंधित रिकॉर्ड शामिल करें	जब बहुत ज़्यादा हो, तो अपनी सामग्री पर retrieval (RAG क्या है)
क्रियाएं	मॉडल केवल टेक्स्ट लिखता है	Tool use, जहाँ model आपके कोड से आपका परिभाषित फ़ंक्शन चलाने को कहता है
बड़े पैमाने पर, गैर-ज़रूरी काम	आइटमों पर लूप	Message Batches API, जिसे आप सबमिट करते हैं और नतीजों के लिए पोल करते हैं

अपने AI बिल्डर को देने वाले prompts

एक पहला फ़ीचर:

एक "Ask about this document" पैनल जोड़ें। यह एक सर्वर रूट POST /api/ask को कॉल करता है, जो जाँचता है कि यूज़र लॉग इन है और दस्तावेज़ का मालिक है, फिर आधिकारिक Anthropic SDK और सीक्रेट ANTHROPIC_API_KEY से Claude Messages API को कॉल करता है। model ID सीक्रेट CLAUDE_MODEL से पढ़ें। System prompt: "Answer only from the document provided. If the answer isn't in it, say so." दस्तावेज़ का टेक्स्ट और सवाल भेजें, max_tokens 800 सेट करें, जवाब पेज पर स्ट्रीम करें, और key को कभी ब्राउज़र तक न पहुँचने दें।

Guardrails और errors:

हर यूज़र को प्रति घंटे 20 सवाल तक सीमित करें, जो डेटाबेस में ट्रैक हों। हर जवाब से इनपुट और आउटपुट टोकन यूज़र ID और request ID के साथ लॉग करें। 429 या 529 errors पर exponential backoff के साथ 3 बार तक दोबारा कोशिश करें, retry-after हेडर का सम्मान करते हुए, फिर "The assistant is busy, try again shortly." दिखाएं। अगर API spend limit error दे, तो "AI features are paused" दिखाएं और एडमिन को सूचित करें।

जिन errors के लिए तैयार रहना है

Anthropic के errors दस्तावेज़ से, वे जो आपके ऐप को सच में मिलेंगी:

कोड	प्रकार	क्या करें
400	`invalid_request_error`	रिक्वेस्ट ठीक करें; यह तब भी आता है जब आप अपनी सेट की spend limit तक पहुँचते हैं
401	`authentication_error`	जाँचें कि key मौजूद, सही और रद्द न हुई हो
413	`request_too_large`	कम भेजें; Messages API प्रति रिक्वेस्ट 32 MB तक स्वीकार करता है
429	`rate_limit_error`	backoff करें और दोबारा कोशिश करें, `retry-after` का सम्मान करते हुए
500	`api_error`	backoff के साथ दोबारा कोशिश करें; अगर बनी रहे तो request ID के साथ सपोर्ट से संपर्क करें
529	`overloaded_error`	सभी यूज़र पर अस्थायी ज़्यादा ट्रैफ़िक; backoff करें और दोबारा कोशिश करें

Anthropic के दस्तावेज़ कहते हैं कि आधिकारिक SDK अस्थायी विफलताओं (कनेक्शन errors, rate limits और 5xx errors) को डिफ़ॉल्ट रूप से दो बार exponential backoff के साथ अपने आप दोबारा कोशिश करते हैं, और आप इसे कॉन्फ़िगर कर सकते हैं। हर जवाब में request-id हेडर होता है; उसे लॉग करें ताकि सपोर्ट समस्याओं का पता लगा सके।

आम गलतियाँ

ब्राउज़र से API कॉल करना। आपकी key सार्वजनिक हो जाती है। हमेशा अपने सर्वर से गुज़रें। देखें API keys को सुरक्षित कैसे रखें।
यह भूल जाना कि max_tokens एक सीमा है, लक्ष्य नहीं। इसे उतना सेट करें जितना फ़ीचर को चाहिए; बहुत कम जवाब काट देता है, बहुत ज़्यादा लंबे और महंगे जवाबों का जोखिम है।
नियम यूज़र मैसेज में डालना। स्थायी निर्देश system prompt में रखें; अनुमतियाँ आपके कोड में रहें।
पूरी चैट हमेशा भेजते रहना। जैसे-जैसे बातचीत बढ़े, पुराने टर्न घटाएं या सारांश बनाएं।
कोई खर्च सीमा या प्रति-यूज़र सीमा न होना।
model ID हार्ड-कोड करना। Models अपडेट और बंद होते रहते हैं।
stop reason को अनदेखा करना। अगर जवाब max_tokens तक पहुँचकर रुका, तो यूज़र को बताएं या सीमा बढ़ाएं।

चेकलिस्ट

Claude Console में API key बनाई गई और सर्वर-साइड सीक्रेट के रूप में सेव की गई
टेस्टिंग और प्रोडक्शन के लिए अलग keys
खर्च की सीमा सेट; उस तक पहुँचने पर साफ़ संदेश
सभी रिक्वेस्ट आपके सर्वर से, अनुमति जाँच के साथ
System prompt में नियम; model ID कॉन्फ़िगर करने योग्य
हर फ़ीचर के लिए max_tokens सेट; लंबे जवाब स्ट्रीम किए गए
आपके ऐप में प्रति-यूज़र rate limit
429 और 529 backoff के साथ संभाले गए; request IDs लॉग
दोस्ताना error स्टेट जो पेज को न तोड़े
खाली, बहुत लंबे और दुर्भावनापूर्ण इनपुट के साथ टेस्ट किया गया

Mythex में Claude API का इस्तेमाल

Mythex पर बनाए गए ऐप में Claude फ़ीचर आपकी अपनी Anthropic key इस्तेमाल करते हैं, और उनका बिल आपके Anthropic अकाउंट पर जाता है, Mythex build credits पर नहीं। यह उस Mythex एजेंट से अलग है जो आपका कोड लिखता है। ANTHROPIC_API_KEY को /secrets, प्रोजेक्ट सेटिंग्स या चैट में दिखने वाले secrets कार्ड के ज़रिए प्रोजेक्ट सीक्रेट के रूप में जोड़ें, फिर ऊपर जैसे prompts से फ़ीचर का वर्णन करें। लाइव ऐप पर सीक्रेट बदलने के बाद फिर से पब्लिश करें। स्टार्टर prompt के लिए अपनी API keys के साथ AI फ़ीचर जोड़ें देखें। अगर आप प्रोवाइडर चुन रहे हैं, तो OpenAI API कैसे इंटीग्रेट करें वही बात OpenAI के लिए समझाता है।

सवाल

Claude API key कैसे मिलती है?

platform.claude.com पर Claude Console में साइन इन करें, बिलिंग सेट करें और एक API key बनाएं। इसे सर्वर-साइड सीक्रेट के रूप में सेव करें, आमतौर पर ANTHROPIC_API_KEY नाम से, और इसे कभी ब्राउज़र कोड में न डालें।

Claude API की रिक्वेस्ट को क्या चाहिए?

सितंबर 2026 तक, Anthropic के Messages API रेफ़रेंस में तीन ज़रूरी बॉडी फ़ील्ड लिखे हैं: model, max_tokens और messages। सीधे HTTP कॉल में x-api-key और anthropic-version हेडर भी चाहिए; आधिकारिक SDK ये खुद सेट कर देते हैं।

Claude API से 529 error क्या है?

Anthropic के errors पेज के अनुसार 529 को overloaded_error कहा जाता है: सभी यूज़र के ज़्यादा ट्रैफ़िक से API अस्थायी रूप से ओवरलोड है। exponential backoff के साथ दोबारा कोशिश करें। आधिकारिक SDK कुछ अस्थायी errors पर अपने आप दोबारा कोशिश करते हैं।

क्या OpenAI SDK के लिए लिखा कोड Claude के साथ चल सकता है?

Anthropic एक OpenAI SDK compatibility layer का दस्तावेज़ देता है, ताकि OpenAI SDK के ज़रिए Claude इस्तेमाल हो सके। नए कोड के लिए, इसके अपने SDK Claude की खास सुविधाएं देते हैं, इसलिए आमतौर पर वही बेहतर शुरुआत है।