मुख्य कंटेंट तक स्किप करें

आपकी पहली API कॉल

शुरुआती

API आपके प्रोग्राम को Claude से बात करने देता है। इस पाठ के अंत तक आप एक वास्तविक अनुरोध चला चुके होंगे और आप ठीक-ठीक समझ जाएँगे कि इसका हर हिस्सा क्या करता है।

What you'll learn
  • एक API कुंजी बनाएँ और उसे एक एनवायरनमेंट वेरिएबल के रूप में सुरक्षित रखें
  • Python या TypeScript के लिए आधिकारिक SDK इंस्टॉल करें (या सादा cURL उपयोग करें)
  • अपना पहला messages अनुरोध भेजें और Claude का जवाब पढ़ें
  • चार मुख्य फ़ील्ड समझें: model, max_tokens, messages, और system

पूरी यात्रा तीन चरणों में​

नीचे दी गई हर चीज़ एक सरल अनुक्रम में फिट होती है। आगे बढ़ते समय इस नक्शे को ध्यान में रखें।

Guided walkthrough1 of 3
  1. Anthropic Console में एक कुंजी बनाएँ और उसे एक एनवायरनमेंट वेरिएबल के रूप में एक्सपोर्ट करें ताकि यह कभी आपके कोड में न रहे।

1. एक API कुंजी प्राप्त करें​

Anthropic Console में एक बनाएँ। फिर इसे एक एनवायरनमेंट वेरिएबल के रूप में सेट करें ताकि यह कभी आपके कोड में न रहे:

अपनी API कुंजी एक्सपोर्ट करें

export ANTHROPIC_API_KEY="sk-ant-..."
Watch out
  • अपनी कुंजी कभी कमिट न करें। कुंजियाँ एनवायरनमेंट वेरिएबल्स या किसी सीक्रेट्स मैनेजर में रखें, कभी सोर्स कंट्रोल में नहीं। देखें सुरक्षा पेज (/docs/security)।

2. SDK इंस्टॉल करें​

अपनी भाषा चुनें। SDK उस एनवायरनमेंट वेरिएबल से कुंजी अपने-आप पढ़ता है जिसे आपने अभी सेट किया है।

इंस्टॉल (Python)

pip install anthropic

3. कॉल करें​

हर अनुरोध messages की एक सूची है। मॉडल content के साथ जवाब देता है। अपनी भाषा के लिए स्निपेट चलाएँ और आप Claude को प्रश्न का उत्तर देते हुए देखेंगे।

import anthropic

client = anthropic.Anthropic()  # reads ANTHROPIC_API_KEY from the environment

message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "In one sentence, what is an API?"}
    ],
)

print(message.content[0].text)

अभी क्या हुआ​

आपने जानकारी के चार टुकड़े भेजे। यहाँ बताया गया है कि हर एक क्या नियंत्रित करता है:

  • model — किस Claude का उपयोग करना है। आँख मूँदकर हार्ड-कोड न करें; देखें एक मॉडल चुनना।
  • max_tokens — उत्तर की लंबाई पर एक सीमा (टोकन में)। यह कॉन्टेक्स्ट विंडो सेट नहीं करता।
  • messages — अब तक की बातचीत। API स्टेटलेस है: चैट जारी रखने के लिए, हर बार पूरा इतिहास वापस भेजें।
  • system (वैकल्पिक) — एक शीर्ष-स्तरीय निर्देश जो कॉल के लिए Claude की भूमिका सेट करता है।
चार मुख्य फ़ील्ड
कार्ड पलटने के लिए Enter या Space दबाएँ। कार्ड बदलने के लिए बाएँ और दाएँ तीर कुंजियों का उपयोग करें।शब्द दिखाया गया।
1 / 4
Pro tip
  • क्योंकि API स्टेटलेस है, एक मल्टी-टर्न चैट बस एक बढ़ती हुई messages सरणी है: हर जवाब को जोड़ें और अगली कॉल पर पूरी सूची दोबारा भेजें।

खुद को परखें

0/3
  1. max_tokens क्या नियंत्रित करता है?
  2. API के साथ एक मल्टी-टर्न बातचीत कैसे जारी रखते हैं?
  3. आपकी API कुंजी कहाँ रहनी चाहिए?
Key takeaways
  • तीन चरण: एक कुंजी प्राप्त करें, SDK इंस्टॉल करें, एक messages अनुरोध भेजें।
  • कुंजी को ANTHROPIC_API_KEY में रखें ताकि SDK इसे अपने-आप पढ़े और यह कभी आपके कोड में न आए।
  • एक अनुरोध messages की एक सूची है; जवाब content में वापस आता है।
  • API स्टेटलेस है: चैट जारी रखने के लिए पूरी बातचीत का इतिहास दोबारा भेजें।
  • model, max_tokens, messages, और system वे फ़ील्ड हैं जिन तक आप सबसे पहले पहुँचेंगे।

आगे​