Si të Përdorni Çelësin API të Claude: Udhëzues i Plotë 2025

\n\n## Hyrje

Claude është një asistent i fuqishëm AI i zhvilluar nga Anthropic, i aftë për të kryer një gamë të gjerë detyrash, nga gjenerimi i përmbajtjes krijuese deri te ofrimi i shpjegimeve të detajuara. Për të hyrë në aftësitë e Claude në mënyrë programatike, ju nevojitet një çelës API. Ky udhëzues do t'ju udhëzojë nëpër procesin e marrjes dhe përdorimit të çelësit tuaj API të Claude, duke ofruar hapa të qartë dhe të zbatueshëm.

Ky udhëzues supozon se keni një kuptim bazë të koncepteve të programimit dhe jeni të njohur me përdorimin e API-ve. Nuk kërkohet përvojë e mëparshme me Claude. Në fund të këtij tutoriali, do të jeni në gjendje të vërtetoni me API-n e Claude dhe të bëni thirrjen tuaj të parë API.

Parakushtet

Përpara se të filloni, sigurohuni që keni sa vijon:

• Një Llogari Anthropic: Ju nevojitet një llogari me Anthropic për të hyrë në API-n e tyre. Shkoni në faqen e internetit të Anthropic dhe regjistrohuni për një llogari.
• Çelës API: Ju duhet të merrni një çelës API nga Anthropic. Ky çelës është thelbësor për vërtetimin e kërkesave tuaja në API-n e Claude.
• Mjedisi i Programimit: Zgjidhni një gjuhë programimi (p.sh., Python, Node.js) dhe konfiguroni mjedisin tuaj të zhvillimit. Ky udhëzues do të përdorë kryesisht Python për shembuj.
• Menaxheri i Pakove: Sigurohuni që keni të instaluar një menaxher pakosh (p.sh., pip për Python, npm për Node.js).
• Njohuri Bazë Programimi: Një kuptim bazë i koncepteve të programimit, siç janë variablat, funksionet dhe bërja e kërkesave HTTP, është thelbësor.

Hapi 1: Regjistrohu për një Llogari Anthropic

Nëse nuk keni tashmë një llogari Anthropic, do t'ju duhet të krijoni një të tillë.

1. Vizitoni Faqen e Internetit të Anthropic: Shkoni në faqen zyrtare të internetit të Anthropic (anthropic.com).
2. Regjistrohu: Kërkoni një buton "Sign Up" ose "Get Started". Formulimi i saktë mund të ndryshojë.
3. Jepni Informacion: Plotësoni informacionin e kërkuar, siç janë emri, adresa e emailit dhe fjalëkalimi juaj.
4. Verifikoni Email-in Tuaj: Kontrolloni kutinë tuaj të postës elektronike për një email verifikimi nga Anthropic. Klikoni lidhjen e verifikimit për të konfirmuar llogarinë tuaj.
5. Plotësoni Profilin (Nëse Kërkohet): Disa platforma mund të kërkojnë që të plotësoni informacionin e profilit tuaj pas verifikimit të email-it tuaj.

Hapi 2: Merrni Çelësin Tuaj API të Claude

Pasi të keni një llogari Anthropic, mund të merrni çelësin tuaj API.

1. Hyni: Hyni në llogarinë tuaj Anthropic në faqen e tyre të internetit.
2. Navigoni te Cilësimet e API-së: Kërkoni për një seksion që lidhet me "API Keys", "Developers" ose "Account Settings". Vendndodhja mund të ndryshojë në varësi të paraqitjes së faqes së internetit të Anthropic.
3. Gjeneroni Çelësin API: Klikoni në opsionin për të gjeneruar një çelës të ri API. Mund t'ju duhet të jepni një emër ose përshkrim për çelësin.
4. Kopjoni dhe Ruani në Mënyrë të Sigurt: Pasi të gjenerohet çelësi, kopjoni atë në një vend të sigurt. Kjo është thelbësore sepse nuk do të mund ta shihni më çelësin pasi të mbyllni faqen. Ruajeni në mënyrë të sigurt, si në një menaxher fjalëkalimesh dhe shmangni angazhimin e tij në sistemet e kontrollit të versionit si Git.

Hapi 3: Konfiguroni Mjedisin Tuaj të Programimit

Tani, konfiguroni mjedisin tuaj të programimit për të përdorur API-n e Claude. Ne do të përdorim Python në këtë shembull.

1. Instaloni Python: Nëse nuk keni të instaluar Python, shkarkoni dhe instaloni versionin më të fundit nga faqja zyrtare e internetit e Python (python.org).

2. Instaloni Bibliotekën Python të Anthropic: Hapni terminalin tuaj ose komandën e shpejtë dhe përdorni pip për të instaluar bibliotekën Python të Anthropic:

   pip install anthropic
   

   Kjo komandë shkarkon dhe instalon bibliotekën e nevojshme Python për bashkëveprim me API-n e Claude.

3. Verifikoni Instalimin: Për të verifikuar që biblioteka është instaluar saktë, ekzekutoni komandën e mëposhtme në terminalin tuaj:

   pip show anthropic
   

   Kjo duhet të shfaqë informacion në lidhje me bibliotekën e instaluar Anthropic, duke përfshirë versionin dhe vendndodhjen e saj.

Hapi 4: Vërtetoni me API-n e Claude

Përpara se të mund të përdorni API-n e Claude, duhet të vërtetoni kërkesat tuaja duke përdorur çelësin tuaj API.

1. Importoni Bibliotekën Anthropic: Në skriptin tuaj Python, importoni bibliotekën Anthropic:

   import anthropic
   

2. Vendosni Çelësin API: Vendosni variablin e mjedisit ANTHROPIC_API_KEY ose kaloni drejtpërdrejt çelësin API kur krijoni klientin.

   Opsioni 1: Përdorimi i Variablit të Mjedisit (Rekomandohet):

   Vendosni variablin e mjedisit ANTHROPIC_API_KEY në sistemin tuaj operativ. Kjo ju pengon të kodoni çelësin në skriptin tuaj.

   • Linux/macOS:

     export ANTHROPIC_API_KEY="ÇELËSI_JUAJ_API"
     

   • Windows:

     set ANTHROPIC_API_KEY=ÇELËSI_JUAJ_API
     

   Zëvendësoni ÇELËSI_JUAJ_API me çelësin aktual API që keni marrë nga Anthropic.

   Opsioni 2: Kalimi Drejtpërdrejt i Çelësit API (Më Pak i Sigurt):

   Ju mund të kaloni drejtpërdrejt çelësin API kur krijoni klientin Anthropic, por kjo është më pak e sigurt dhe nuk rekomandohet për mjedise prodhimi.

   client = anthropic.Anthropic(api_key="ÇELËSI_JUAJ_API")
   

   Zëvendësoni ÇELËSI_JUAJ_API me çelësin tuaj aktual API.

3. Krijoni një Klient Anthropic: Krijoni një instancë të klasës Anthropic për të bashkëvepruar me API-në:

   client = anthropic.Anthropic() # Duke supozuar se ANTHROPIC_API_KEY është vendosur
   

   Nëse po përdorni metodën e variablit të mjedisit, klienti automatikisht do të marrë çelësin API nga mjedisi.

Hapi 5: Bëni Thirrjen Tuaj të Parë API

Tani që jeni vërtetuar, mund të bëni thirrjen tuaj të parë API në API-n e Claude. Ne do të përdorim pikë-fundin messages.create për t'i dërguar një mesazh Claude dhe për të marrë një përgjigje.

1. Përgatitni Nxitjen Tuaj: Krijoni një nxitje për t'ia dërguar Claude. Nxitja duhet të jetë e qartë dhe e përmbledhur, duke i thënë Claude se çfarë dëshironi që të bëjë.

   prompt = "Shkruaj një poezi të shkurtër për oqeanin."
   

2. Thirrni Pikën-Fundore messages.create: Përdorni metodën messages.create për t'i dërguar nxitjen tuaj Claude dhe për të marrë një përgjigje.

   message = client.messages.create(
       model="claude-3-opus-20240229", # Zëvendësoni me modelin tuaj të dëshiruar
       max_tokens=1024,
       messages=[{"role": "user", "content": prompt}],
   )
   

   • model: Specifikon modelin Claude që dëshironi të përdorni. Kontrolloni dokumentacionin e Anthropic për modelet më të fundit të disponueshme.
   • max_tokens: Specifikon numrin maksimal të argumenteve në përgjigjen e gjeneruar.
   • messages: Një listë mesazhesh që përfaqësojnë historinë e bisedës. Çdo mesazh ka një role (ose "user" ose "assistant") dhe content.

3. Printoni Përgjigjen: Printoni përmbajtjen e përgjigjes për të parë se çfarë gjeneroi Claude.

   print(message.content[0].text)
   

   Kjo do të printojë poezinë e gjeneruar nga Claude.

Hapi 6: Kodi Shembull i Plotë

Këtu është kodi i plotë Python për të bërë një thirrje API në API-n e Claude: