भाषा मोडेललाई पहिलो API कल

API की प्राप्त गर्ने

हामी उदाहरणका रूपमा Anthropic को Claude प्रयोग गर्नेछौँ। तपाईं OpenAI, Google, वा कुनै पनि अन्य प्रमुख API सँग उही अभ्यास गर्न सक्नुहुन्छ; कोड लगभग शब्द-शब्द एउटै हुन्छ।

1. console.anthropic.com मा जानुहोस् र साइन अप गर्नुहोस्। तपाईंलाई इमेल र फोन नम्बर चाहिनेछ।
2. Anthropic ले अधिकांश नयाँ खाताहरूलाई थोरै निःशुल्क क्रेडिट दिन्छ — सामान्यतया केही अमेरिकी डलर। यो यो ट्र्याकका सयौँ साना प्रयोगका लागि काफी हो।
3. लग इन भएपछि, कन्सोलमा API Keys पृष्ठ खोज्नुहोस्। “Create Key” क्लिक गर्नुहोस्, “building-ai-course” जस्तो नाम दिनुहोस्, र की तुरुन्तै प्रतिलिपि गर्नुहोस्। कन्सोलले की एक पटक मात्र देखाउनेछ।

की sk-ant-api03-... र पछि लामो अनियमित स्ट्रिङ जस्तो देखिन्छ। यसलाई पासवर्डझैँ ठान्नुहोस्। यो की भएको जुनसुकैले तपाईंको खाताबाट पैसा खर्च गर्न सक्छ।

की सुरक्षित रूपमा भण्डारण

परियोजना फोल्डरमा .env नामको फाइल बनाउनुहोस्:

ANTHROPIC_API_KEY=sk-ant-api03-...your-key...

.env .gitignore मा छ भन्ने सुनिश्चित गर्नुहोस्। (अध्याय 4 बाट पहिले नै हुनुपर्छ।)

Python मा यसरी लोड गर्नुहोस्:

import os
from dotenv import load_dotenv

load_dotenv()

api_key = os.environ["ANTHROPIC_API_KEY"]

यसका लागि एक थप स्थापना चाहिन्छ — python-dotenv प्याकेज:

pip install python-dotenv

load_dotenv() कलले .env फाइल पढ्छ र यसको सामग्रीलाई os.environ मा थप्छ। अनि os.environ["ANTHROPIC_API_KEY"] ले की निकाल्छ। तपाईंको कोडमा कहिल्यै की प्रत्यक्ष रूपमा हुँदैन; फाइलमा मात्र (जुन कहिल्यै कमिट हुँदैन)।

Anthropic SDK स्थापना

Anthropic ले सबै HTTP प्लम्बिङ ह्यान्डल गर्ने Python पुस्तकालय प्रकाशन गर्छ:

pip install anthropic

अनि requirements.txt अद्यावधिक गर्नुहोस्:

pip freeze > requirements.txt

तपाईंको पहिलो कल

सबैभन्दा सानो पूर्ण कार्यक्रम:

import os
from dotenv import load_dotenv
import anthropic

load_dotenv()

client = anthropic.Anthropic()  # ANTHROPIC_API_KEY स्वचालित रूपमा उठाउँछ

response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=300,
    messages=[
        {"role": "user", "content": "Explain in two sentences what NEPSE is."},
    ],
)

print(response.content[0].text)

चलाउनुहोस्। एक-दुई सेकेन्ड कुरेपछि, यस्तो देख्नुहुनेछ:

NEPSE — the Nepal Stock Exchange — is the country's main equity market,
where shares in Nepali companies, banks, and hydropower projects are
listed and traded. It is regulated by the Securities Board of Nepal
(SEBON) and located in Singha Durbar, Kathmandu.

त्यो हरेक भाषा-मोडेल कार्यक्रमको सम्पूर्ण आकार हो जुन तपाईंले कहिल्यै लेख्नुहुनेछ। बिस्तारै फेरि पढ्नुहोस्:

• client.messages.create(...) कल हो। यसले Anthropic को सर्भरमा अनुरोध पठाउँछ र जवाफ पर्खन्छ।
• model="claude-haiku-4-5-20251001" ले कुन मोडेल छान्छ। Anthropic ले शृङ्खला दिन्छ — Haiku छिटो र सस्तो; Sonnet सन्तुलित; Opus सबैभन्दा सक्षम। यो ट्र्याकको अधिकांशका लागि Haiku पर्याप्त छ।
• max_tokens=300 ले जवाफ कति लामो हुन सक्छ सीमा गर्छ। टोकनहरू लगभग शब्दको तीन-चौथाइ हुन्; 300 टोकन झन्डै 220 शब्द हो।
• messages=[...] सम्म भएको कुराकानी हो। यहाँ यसमा एउटा सन्देश छ — तपाईंको, "user" भूमिकाले चिनिएको। Course 04 मा, कुराकानी निर्माण गर्न तपाईंले लामो सन्देश सूची पास गर्नुहुनेछ।
• response.content[0].text मोडेलको जवाफ कसरी पढ्ने हो। प्रतिक्रियाको संरचना सामग्री ब्लकहरूको सूची हो; पहिलोको .text फिल्डमा मोडेलले के लेख्यो हुन्छ।

अझ चाखलाग्दो कल

NEPSE सारांश लाइन लिने र मोडेललाई नेपालीमा अनुवाद र व्याख्या गर्न भन्ने कार्यक्रम:

import os
from dotenv import load_dotenv
import anthropic

load_dotenv()

client = anthropic.Anthropic()

market_note = (
    "NEPSE closed at 2,134.7 — up 0.8 percent on the day. "
    "Banking shares led the gains; hydropower was mixed."
)

prompt = (
    f"You are explaining the Nepali stock market to a shopkeeper "
    f"in Itahari who does not read English. Translate and gently "
    f"explain the following market note in plain Nepali, in 3-4 sentences. "
    f"Use Devanagari script.\n\n"
    f"Market note: {market_note}"
)

response = client.messages.create(
    model="claude-haiku-4-5-20251001",
    max_tokens=400,
    messages=[
        {"role": "user", "content": prompt},
    ],
)

print(response.content[0].text)

प्रतिक्रिया देवनागरीमा 3-4 वाक्यको नेपाली व्याख्या हुनेछ। त्यो प्रम्प्टमा तीन वास्तविक निर्माता चालहरू ध्यान दिनुहोस्:

• भूमिका। मोडेललाई “तपाईं इटहरीको पसलेलाई व्याख्या गर्दै हुनुहुन्छ” भन्नाले यसलाई सरल, भुइँमा टेकेको भाषातर्फ डोर्‍याउँछ।
• लम्बाइ। “3-4 वाक्य” ले मोडेललाई बकवास गर्नबाट रोक्छ।
• ढाँचा। “देवनागरी लिपि प्रयोग गर्नुहोस्” ले कुन लिपिमा लेख्ने भन्छ।

Course 04 मा हामी कोडमा प्रम्प्टिङमा पूरा अध्याय खर्च गर्छौँ। अहिलेलाई, यी तीन साना ढाँचाहरूले मात्र पनि आउटपुटलाई नाटकीय रूपमा राम्रो बनाउँछन् भन्ने नोट गर्नुहोस्।

यसको लागत के हो

Anthropic ले प्रति लाखौँ इनपुट र आउटपुट टोकनमा मूल्य लगाउँछ, र मूल्य बदलिन्छ। 2025 को अन्त्यतिर, Haiku लगभग एक चौथाइ अमेरिकी डलर प्रति लाखौँ इनपुट टोकन छ — अर्थात् माथिको जस्तो साधारण सानो कलको लागत एक पैसाको सानो अंश हो। तपाईंको निःशुल्क क्रेडिट ले होस गरेर चलाए पूरै ट्र्याक टिक्छ।

प्रयोग जाँच्न, API कन्सोलमा “Usage” पृष्ठ छ। सिकाइको बेला हप्तामा एक पटक हेर्नुहोस्। यदि कुनै बेला दैनिक सङ्ख्या अप्रत्याशित रूपमा बढ्यो भने, तपाईंसँग अनन्त लूप छ वा मार्न बिर्सिएको स्क्रिप्ट छ।

त्रुटि ह्यान्डलिङ, छोटकरीमा

नेटवर्क कल विफल हुन्छन्। API ले त्रुटि फिर्ता दिन्छन्। तपाईंको कोड तयार हुनुपर्छ:

try:
    response = client.messages.create(
        model="claude-haiku-4-5-20251001",
        max_tokens=300,
        messages=[{"role": "user", "content": "Say hi"}],
    )
    print(response.content[0].text)
except anthropic.APIError as e:
    print(f"API error: {e}")

अहिलेलाई एउटा try/except पर्याप्त छ। Course 04 मा हामी रेट लिमिट, रिट्राई, र टाइमआउटलाई राम्ररी सम्हाल्नेछौं।

आफ्नो बुझाइ जाँच्नुहोस्

Quick check

—

एक जुनियर डेभलपरले यो फाइल सार्वजनिक GitHub रिपोमा कमिट गर्छन्: # config.py ANTHROPIC_API_KEY = 'sk-ant-api03-abc123...' तिनले के गर्नुपर्छ?

1. Aकेही पनि होइन — `config.py` सामान्य Python फाइल हो।
2. BAnthropic कन्सोलमा तुरुन्तै की घुमाउनुहोस् (ताकि लीक भएको अब काम गर्दैन), अनि की लाई `.gitignore` मा भएको `.env` फाइलमा सार्नुहोस्। `os.environ` मार्फत लोड गर्न कोडलाई रिफ्याक्टर गर्नुहोस्।
3. Cलाइनमाथि "यो की प्रयोग नगर्नुहोस्" भन्ने टिप्पणी थप्नुहोस्।
4. Dरिपो निजी बनाउनुहोस् — त्यसले की लाई फिर्ता गएर सुरक्षित गर्छ।

Check answer→

Quick check

—

तपाईंले 'यो अनुच्छेद सारांश गर्नुहोस्' भन्ने प्रम्प्ट लेख्नुहुन्छ। मोडेलको जवाफ बकवासयुक्त, औपचारिक अंग्रेजीमा, र तपाईंले चाहेभन्दा तीन गुणा लामो छ। इनपुट अनुच्छेद नबदल्ने हो भने, यो खण्डका आधारमा कुन परिवर्तनले सबैभन्दा बढी मद्दत गर्न सक्छ?

1. AHaiku बाट Opus मा सर्नुहोस्; ठूला मोडेलले सधैं राम्रो सारांश दिन्छन्।
2. Bमोडेललाई बढी ठाउँ हुन max_tokens बढाउनुहोस्।
3. Cप्रम्प्टमा भूमिका, लम्बाइ, र ढाँचा थप्नुहोस्: जस्तै 'तपाईं पोखराका कक्षा-9 का विद्यार्थीलाई व्याख्या गर्दै हुनुहुन्छ। अनुच्छेदलाई दुई छोटा वाक्यमा सरल नेपालीमा सारांश गर्नुहोस्।'
4. Dछोटो जवाफ नआउँदासम्म उही प्रम्प्ट धेरै पटक पठाउँदै रहनुहोस्।

Check answer→

अब के आउँछ

तपाईंले आफ्नै कोडबाट भाषा मोडेलसँग कुरा गर्नुभयो। अर्को खण्डमा फरक केही गर्नुहुन्छ: आफ्नै ल्यापटपमा मोडेल लोड गरेर तस्बिरबाट नेपाली पाठ पढ्न प्रयोग गर्नुहुन्छ। इन्टरनेट छैन, API छैन। शुद्ध अन-डिभाइस एआई — तपाईंले अघि गरेकोको अर्को पाटो, र कहिल्यै बनाउने हरेक गोपनीयता-संवेदनशील एआई अनुप्रयोगको आधार।