Si ta integroni Claude API në aplikacionin tuaj

Për të integruar Claude API, krijoni një çelës API në Claude Console të Anthropic, ruajeni si sekret në server (zakonisht ANTHROPIC_API_KEY), dhe thirrni Messages API nga një rrugë në serverin tuaj duke përdorur një nga SDK-të zyrtare të Anthropic. Çdo kërkesë emëron një model, vendos max_tokens (përgjigjja më e gjatë që pranoni) dhe dërgon bisedën si messages, me udhëzimet tuaja në një system prompt të veçantë. Vendosni një kufi shpenzimesh, transmetoni përgjigjet e gjata dhe trajtoni gabimet e kufirit të shpejtësisë (429) dhe të mbingarkesës (529) me riprova.

Ky udhëzues mbulon konfigurimin, një rrjedhë kërkese të sigurt, udhëzime për një AI builder dhe gabimet për t'u përballuar. Të dhënat e Anthropic janë nga dokumentacioni i tyre që nga shtatori 2026. Për mënyrën si funksionojnë tokenët dhe çmimet në përgjithësi, shihni si të përdorni LLM API.

Çfarë mund të ndërtoni me të

Asistentë bisede dhe widget-e ndihme (si të ndërtoni një aplikacion chatbot me AI)
Përmbledhje, rishkrime dhe përgjigje të hartuara
Nxjerrje fushash nga dokumente, email dhe formularë
Përgjigje pyetjesh nga përmbajtja juaj
Agjentë që thërrasin funksionet e aplikacionit tuaj përmes tool use

Për më shumë ide, shihni si të shtoni veçori AI në aplikacionin tuaj.

Messages API në përmbledhje

Sipas referencës së API të Anthropic, një kërkesë është një POST te https://api.anthropic.com/v1/messages me:

Pjesa	Çfarë është
header `x-api-key`	Çelësi juaj API
header `anthropic-version`	Versioni i API-t, për shembull `2023-06-01`
`model` (e detyrueshme)	Cilin model Claude të përdorni
`max_tokens` (e detyrueshme)	Numri maksimal i tokenëve që mund të përmbajë përgjigjja; modeli mund të ndalojë më herët
`messages` (e detyrueshme)	Biseda: radhë alternative të kthesave `user` dhe `assistant`
`system` (opsionale)	Udhëzime që zbatohen për gjithë bisedën
`stream` (opsionale)	Vendoseni `true` për të marrë përgjigjen ndërsa shkruhet, përmes server-sent events

API është pa gjendje: për të vazhduar një bisedë, dërgoni përsëri kthesat e mëparshme me çdo kërkesë. Prandaj bisedat e gjata kushtojnë më shumë për çdo mesazh.

Anthropic publikon SDK zyrtare për Python, TypeScript, C#, Go, Java, PHP dhe Ruby. Ato vendosin header-at, analizojnë përgjigjet dhe mbështesin streaming. Përdorni një nga ato në vend të HTTP të thjeshtë, përveç nëse keni një arsye.

Zgjedhja e modelit

Anthropic ofron disa modele Claude që ndërmjetësojnë midis aftësisë, shpejtësisë dhe çmimit, dhe lista ndryshon. Zgjidhni modelin më të vogël që e bën mirë detyrën, testojeni me shembuj reale dhe mbajeni ID-në e modelit në konfigurim, që ta ndryshoni pa ndryshuar kodin. Shihni faqet e modeleve dhe çmimeve të Anthropic për opsionet dhe tarifat aktuale.

Konfigurimi i llogarisë

Hyni në Claude Console në platform.claude.com dhe shtoni faturimin.
Krijoni një çelës API. Mbajeni një çelës për çdo mjedis (testim dhe prodhim), që të mund ta revokoni njërin pa e prishur tjetrin.
Vendosni një kufi shpenzimesh. Faqja e gabimeve të Anthropic thotë se kur përdorimi arrin një kufi shpenzimesh që keni vendosur, API kthen një gabim 400, prandaj aplikacioni juaj duhet të shfaqë një mesazh të qartë kur ndodh kjo.
Kontrolloni kufijtë e shpejtësisë për llogarinë tuaj në Console; ato matet për organizatë.

Rrjedha e kërkesës

Përdoruesi vepron në aplikacionin tuaj: dërgon një mesazh, klikon „Përmblidh".
Shfletuesi thërret rrugën tuaj në server, kurrë Anthropic direkt.
Serveri juaj kontrollon që përdoruesi është i kyçur dhe i lejuar të përdorë veçorinë, dhe zbaton një kufi për përdorues.
Ndërton kërkesën: një system prompt me rregullat tuaja, input-in e përdoruesit dhe çdo të dhënë që detyra kërkon nga baza juaj e të dhënave.
Thërret Messages API me çelësin nga mjedisi dhe një max_tokens të arsyeshëm.
Transmeton përgjigjen te shfletuesi dhe regjistron përdorimin e tokenëve nga përgjigjja.

Opsionet dhe kompromiset

Vendimi	Zgjedhja e thjeshtë	Kur të shkoni më tej
Streaming	Prisni përgjigjen e plotë	Përdoreni streaming për bisedë dhe gjithçka të gjatë; Anthropic rekomandon streaming ose batch për kërkesat me kohë të gjatë
Formati i daljes	Tekst i thjeshtë	JSON i strukturuar kur kodi juaj duhet të lexojë fusha
Të dhënat tuaja	Përfshini regjistrimin e duhur	Kërkim mbi përmbajtjen tuaj kur janë shumë të dhëna (çfarë është RAG)
Veprime	Modeli shkruan vetëm tekst	Tool use, ku modeli i kërkon kodit tuaj të ekzekutojë një funksion që keni definuar
Punë masive, jo urgjente	Cikël mbi elementet	Message Batches API, që e dërgoni dhe pyesni për rezultatet

Udhëzime për t'i dhënë AI builder-it tuaj

Një veçori e parë:

Shtoni një panel „Pyet për këtë dokument". Ai thërret një rrugë serveri POST /api/ask që kontrollon që përdoruesi është i kyçur dhe është pronar i dokumentit, pastaj thërret Claude Messages API me Anthropic SDK zyrtare dhe sekretin ANTHROPIC_API_KEY. Lexoni ID-në e modelit nga sekreti CLAUDE_MODEL. System prompt: "Përgjigju vetëm nga dokumenti i dhënë. Nëse përgjigjja nuk është aty, thuaj këtë." Dërgo tekstin e dokumentit dhe pyetjen, vendos max_tokens në 800, transmeto përgjigjen te faqja dhe mos e ekspozo kurrë çelësin te shfletuesi.

Mbrojtjet dhe gabimet:

Kufizo çdo përdorues në 20 pyetje në orë, të ruajtura në bazën e të dhënave. Regjistro tokenët hyrës dhe dalës nga çdo përgjigje me ID-në e përdoruesit dhe ID-në e kërkesës. Për gabimet 429 ose 529, riprovo me backoff eksponencial deri në 3 herë, duke respektuar header-in retry-after nëse ekziston, pastaj shfaq "Asistenti është i zënë, provo pak më vonë." Nëse API raporton gabim kufiri shpenzimesh, shfaq "Veçoritë AI janë pezulluar" dhe njofto administratorin.

Gabimet për t'u përballuar

Nga dokumentacioni i gabimeve të Anthropic, ato që aplikacioni juaj do t'i hasë realisht:

Kodi	Tipi	Çfarë të bëni
400	`invalid_request_error`	Rregulloni kërkesën; kthehet edhe kur arrini një kufi shpenzimesh që keni vendosur
401	`authentication_error`	Kontrolloni që çelësi ekziston, është i saktë dhe nuk është revokuar
413	`request_too_large`	Dërgoni më pak; Messages API pranon deri në 32 MB për kërkesë
429	`rate_limit_error`	Ndaluni dhe riprovoni, duke respektuar `retry-after`
500	`api_error`	Riprovoni me backoff; kontaktoni mbështetjen me ID-në e kërkesës nëse vazhdon
529	`overloaded_error`	Trafik i lartë i përkohshëm nga të gjithë përdoruesit; ndaluni dhe riprovoni

Dokumentacioni i Anthropic thotë se SDK-të zyrtare riprovojnë automatikisht dështimet kalimtare (gabimet e lidhjes, kufijtë e shpejtësisë dhe gabimet 5xx) dy herë si parazgjedhje, me backoff eksponencial, dhe mund ta konfiguroni këtë. Çdo përgjigje përmban header-in request-id; regjistrojeni që mbështetja të gjurmojë problemet.

Gabimet e zakonshme

Thirrja e API nga shfletuesi. Çelësi juaj bëhet publik. Kaloni gjithmonë përmes serverit tuaj. Shihni si t'i mbani të sigurta çelësat API.
Harrimi që max_tokens është kufi, jo objektiv. Vendoseni sipas nevojës së veçorisë; shumë të ulët prish përgjigjet, shumë të lartë rrezikon përgjigje të gjata dhe të kushtueshme.
Vendosja e rregullave në mesazhin e përdoruesit. Udhëzimet e qëndrueshme i takojnë system prompt-it; lejet i takojnë kodit tuaj.
Dërgimi i gjithë bisedës përgjithmonë. Shkurtoni ose përmblidhni kthesat e vjetra ndërsa bisedat rriten.
Pa kufi shpenzimesh ose kufi për përdorues.
Harduakodimi i ID-së së modelit. Modelet përditësohen dhe hiqen.
Injorimi i arsyes së ndalimit. Nëse përgjigjja u ndal sepse arriti max_tokens, njoftoni përdoruesin ose rrisni kufirin.

Lista e kontrollit

Çelësi API u krijua në Claude Console dhe u ruajt si sekret në server
Çelësa të veçantë për testim dhe prodhim
Kufi shpenzimesh i vendosur; mesazh i qartë kur arrihet
Të gjitha kërkesat kalojnë përmes serverit tuaj me kontroll lejesh
System prompt mban rregullat; ID-ja e modelit është e konfigurueshme
max_tokens i vendosur për çdo veçori; përgjigjet e gjata transmetohen
Kufi shpejtësie për përdorues në aplikacionin tuaj
429 dhe 529 trajtohen me backoff; ID-të e kërkesave regjistrohen
Gjendje e qartë gabimi që nuk prish faqen
Testuar me inpute bosh, shumë të gjatë dhe armiqësore

Përdorimi i Claude API në Mythex

Në aplikacionet që ndërtoni në Mythex, veçoritë Claude përdorin çelësin tuaj Anthropic dhe faturohen në llogarinë tuaj Anthropic, jo në kredite e ndërtimit të Mythex. Kjo është e ndarë nga agjenti Mythex që shkruan kodin tuaj. Shtoni ANTHROPIC_API_KEY si sekret projekti përmes /secrets, cilësimeve të projektit ose kartës së sekreteve në bisedë, pastaj përshkruani veçorinë me prompt-e si ato më lart. Publikoni përsëri pasi ndryshoni sekretet në një aplikacion live. Shihni Shto veçori AI me çelësat e tu API për një prompt fillestar. Nëse jeni duke zgjedhur midis ofruesve, si të integroni OpenAI API mbulon të njëjtën gjë për OpenAI.

Pyetje

Si marr një çelës Claude API?

Hyni në Claude Console në platform.claude.com, konfiguroni faturimin dhe krijoni një çelës API. Ruajeni si sekret në server, zakonisht me emrin ANTHROPIC_API_KEY, dhe mos e vendosni kurrë në kodin e shfletuesit.

Çfarë i duhet një kërkese te Claude API?

Që në shtator 2026, referenca e Messages API të Anthropic liston tre fusha të detyrueshme në trup: model, max_tokens dhe messages. Thirrjet direkte HTTP kanë nevojë edhe për header-at x-api-key dhe anthropic-version; SDK-të zyrtare i vendosin ato për ju.

Çfarë është një gabim 529 nga Claude API?

Faqja e gabimeve të Anthropic e përshkruan 529 si overloaded_error: API është përkohësisht i mbingarkuar nga trafiku i lartë i të gjithë përdoruesve. Riprovoni me backoff eksponencial. SDK-të zyrtare riprovojnë automatikisht disa gabime kalimtare.

A mund të përdor Claude me kod të shkruar për SDK-në e OpenAI?

Anthropic dokumenton një shtresë përputhshmërie me SDK-në e OpenAI për përdorimin e Claude përmes sipërfaqes së OpenAI SDK. Për kod të ri, SDK-të e veta ju japin qasje në veçoritë specifike të Claude, kështu që zakonisht janë pika më e mirë për të filluar.