Ինչպես ինտեգրել Claude API-ն ձեր հավելվածում
Claude API-ն ինտեգրելու համար ստեղծեք API բանալի Anthropic-ի Claude Console-ում, պահեք այն որպես սերվերային գաղտնիք (սովորաբար ANTHROPIC_API_KEY) և կանչեք Messages API-ն ձեր սերվերի երթուղուց՝ Anthropic-ի պաշտոնական SDK-ներից մեկով։ Յուրաքանչյուր հարցում նշում է model, սահմանում է max_tokens (ամենաերկար պատասխանը, որ ընդունում եք) և ուղարկում զրույցը որպես messages, իսկ ձեր հրահանգները՝ առանձին system հուշումում։ Սահմանեք ծախսերի սահման, հոսքով ուղարկեք երկար պատասխանները և մշակեք սահմանաչափի (429) և գերբեռնվածության (529) սխալները կրկնակի փորձերով։
Այս ուղեցույցը ներառում է տեղադրումը, անվտանգ հարցման հոսքը, հուշումներ AI կառուցողի համար և սխալները, որոնց համար պետք է պատրաստվել։ Anthropic-ի տվյալները վերցված են իր փաստաթղթերից՝ 2026 թվականի սեպտեմբերի դրությամբ։ Տոկենների և գների ընդհանուր աշխատանքի համար տե՛ս ինչպես օգտագործել LLM API-ները։
Ինչ կարող եք կառուցել դրանով
- Զրուցող օգնականներ և օգնության վիջեթներ (ինչպես կառուցել AI չաթբոթ հավելված)
- Ամփոփումներ, վերագրություններ և պատասխանների նախագծեր
- Դաշտերի արդյունահանում փաստաթղթերից, էլփոստերից և ձևերից
- Հարցերին պատասխանել ձեր սեփական բովանդակությունից
- Գործակալներ, որոնք կանչում են ձեր հավելվածի ֆունկցիաները գործիքների օգտագործման միջոցով
Ավելի շատ գաղափարների համար տե՛ս ինչպես ավելացնել AI գործառույթներ ձեր հավելվածին։
Messages API-ն համառոտ
Ըստ Anthropic-ի API հղման, հարցումը POST է դեպի https://api.anthropic.com/v1/messages՝ հետևյալ մասերով․
| Մաս | Ի՞նչ է |
|---|---|
x-api-key վերնագիր | Ձեր API բանալին |
anthropic-version վերնագիր | API տարբերակը, օրինակ՝ 2023-06-01 |
model (պարտադիր) | Որ Claude մոդելը օգտագործել |
max_tokens (պարտադիր) | Ամենաշատ տոկենները, որ պատասխանը կարող է պարունակել․ մոդելը կարող է ավելի վաղ կանգ առնել |
messages (պարտադիր) | Զրույցը՝ փոխարինվող user և assistant հերթափոխներով |
system (ըստ ցանկության) | Հրահանգներ, որոնք վերաբերում են ամբողջ զրույցին |
stream (ըստ ցանկության) | Դրեք true՝ պատասխանը ստանալու համար, երբ այն գրվում է, server-sent events-ով |
API-ն անվիճակ է․ զրույցը շարունակելու համար ամեն հարցումի հետ նորից ուղարկեք նախորդ հերթափոխները։ Ահա թե ինչու երկար զրույցները յուրաքանչյուր հաղորդագրության համար ավելի թանկ են։
Anthropic-ը հրապարակում է պաշտոնական SDK-ներ Python, TypeScript, C#, Go, Java, PHP և Ruby համար։ Դրանք սահմանում են վերնագրերը, վերլուծում պատասխանները և աջակցում հոսքին։ Օգտագործեք դրանցից մեկը՝ հում HTTP-ի փոխարեն, եթե չունեք հատուկ պատճառ։
Մոդել ընտրելը
Anthropic-ը առաջարկում է մի քանի Claude մոդել, որոնք փոխարինում են կարողությունը արագության և գնի հետ, և մոդելների շարքը փոխվում է։ Ընտրեք ամենափոքր մոդելը, որը լավ է կատարում ձեր աշխատանքը, փորձարկեք այն իրական օրինակների վրա և պահեք մոդելի ID-ն կոնֆիգուրացիայում, որպեսզի կարողանաք փոխել այն առանց կոդի փոփոխության։ Ընթացիկ տարբերակների և դրույքաչափերի համար ստուգեք Anthropic-ի մոդելների և գների էջերը։
Ձեր հաշիվը կարգավորելը
- Մուտք գործեք Claude Console platform.claude.com-ում և ավելացրեք վճարում։
- Ստեղծեք API բանալի։ Պահեք մեկ բանալի յուրաքանչյուր միջավայրի համար (փորձարկում և արտադրություն), որպեսզի կարողանաք չեղարկել մեկը՝ առանց մյուսը խզելու։
- Սահմանեք ծախսերի սահման։ Anthropic-ի սխալների էջը նշում է, որ երբ օգտագործումը հասնում է ձեր սահմանած ծախսերի սահմանին, API-ն վերադարձնում է 400 սխալ, ուստի ձեր հավելվածը պետք է ցույց տա հստակ հաղորդագրություն, երբ դա տեղի է ունենում։
- Ստուգեք սահմանաչափերը ձեր հաշվի համար Console-ում․ դրանք չափվում են ըստ կազմակերպության։
Հարցման հոսքը
- Օգտատերը գործում է ձեր հավելվածում․ ուղարկում է հաղորդագրություն, սեղմում է «Ամփոփել»։
- Բրաուզերը կանչում է ձեր սերվերի երթուղին, երբեք ուղղակիորեն Anthropic-ին։
- Ձեր սերվերը ստուգում է, որ օգտատերը մուտք է գործել և թույլատրված է այդ գործառույթը, և կիրառում է մեկ օգտատիրոջ սահմանաչափը։
- Այն կառուցում է հարցումը․ ձեր կանոններով համակարգային հուշում, օգտատիրոջ մուտքը և այն տվյալները, որ խնդիրը պահանջում է ձեր տվյալների բազայից։
- Կանչում է Messages API-ն՝ միջավայրից բանալիով և խելամիտ
max_tokens-ով։ - Հոսքով ուղարկում է պատասխանը բրաուզերին և գրանցում տոկենների օգտագործումը պատասխանից։
Տարբերակներ և փոխզիջումներ
| Որոշում | Պարզ ընտրություն | Երբ գնալ հետ |
|---|---|---|
| Հոսք | Սպասել ամբողջ պատասխանին | Չաթի և ցանկացած երկար պատասխանի համար օգտագործեք հոսք․ Anthropic-ը երկար աշխատող հարցումների համար խորհուրդ է տալիս հոսք կամ batches |
| Ելքի ձևաչափ | Պարզ տեքստ | Կառուցվածքային JSON ելք, երբ ձեր կոդը պետք է կարդա դաշտերը |
| Ձեր տվյալները | Ներառել համապատասխան գրառումը | Ձեր բովանդակության որոնում, երբ շատ է (տե՛ս ինչ է RAG-ը) |
| Գործողություններ | Մոդելը միայն տեքստ է գրում | Գործիքների օգտագործում, երբ մոդելը խնդրում է ձեր կոդին գործարկել ձեր սահմանած ֆունկցիան |
| Մեծածավալ, չշտապող աշխատանք | Կրկնել ըստ տարրերի | Message Batches API, որը դուք ներկայացնում եք և հարցնում արդյունքները |
Հուշումներ AI կառուցողին տալու համար
Առաջին գործառույթ․
Ավելացրեք «Հարցրեք այս փաստաթղթի մասին» վահանակ։ Այն կանչում է սերվերի երթուղի POST /api/ask, որը ստուգում է, որ օգտատերը մուտք է գործել և տիրապետում է փաստաթղթին, ապա կանչում է Claude Messages API-ն պաշտոնական Anthropic SDK-ով և գաղտնիք ANTHROPIC_API_KEY-ով։ Կարդացեք մոդելի ID-ն գաղտնիք CLAUDE_MODEL-ից։ Համակարգային հուշում․ «Պատասխանեք միայն տրված փաստաթղթից։ Եթե պատասխանը դրանում չկա, ասեք դա»։ Ուղարկեք փաստաթղթի տեքստը և հարցը, սահմանեք max_tokens 800, հոսքով ուղարկեք պատասխանը էջին և երբեք մի բացահայտեք բանալին բրաուզերին։
Պաշտպանիչ միջոցներ և սխալներ․
Սահմանեք յուրաքանչյուր օգտատիրոջ համար ժամում 20 հարց՝ պահված տվյալների բազայում։ Գրանցեք յուրաքանչյուր պատասխանի մուտքային և ելքային տոկենները օգտատիրոջ ID-ով և հարցման ID-ով։ 429 կամ 529 սխալների դեպքում կրկին փորձեք էքսպոնենցիալ հետաձգմամբ մինչև 3 անգամ՝ հարգելով retry-after վերնագիրը, ապա ցույց տվեք «Օգնականը զբաղված է, փորձեք քիչ հետո»։ Եթե API-ն հայտնում է ծախսերի սահմանի սխալ, ցույց տվեք «AI գործառույթները դադարեցված են» և տեղեկացրեք ադմինին։
Սխալներ, որոնց համար պետք է պատրաստվել
Ըստ Anthropic-ի սխալների փաստաթղթերի՝ այն, ինչ ձեր հավելվածը իրականում կհանդիպի․
| Կոդ | Տեսակ | Ինչ անել |
|---|---|---|
| 400 | invalid_request_error | Ուղղել հարցումը․ վերադարձվում է նաև երբ հասնում եք ձեր սահմանած ծախսերի սահմանին |
| 401 | authentication_error | Ստուգել, որ բանալին առկա է, ճիշտ է և չի չեղարկվել |
| 413 | request_too_large | Ուղարկել ավելի քիչ․ Messages API-ն ընդունում է մինչև 32 ՄԲ մեկ հարցման համար |
| 429 | rate_limit_error | Հետաձգել և կրկին փորձել՝ հարգելով retry-after |
| 500 | api_error | Կրկին փորձել հետաձգմամբ; եթե շարունակվում է, դիմել աջակցությանը հարցման ID-ով |
| 529 | overloaded_error | Ժամանակավոր բարձր թրաֆիկ բոլոր օգտատերերի մոտ․ հետաձգել և կրկին փորձել |
Anthropic-ի փաստաթղթերը ասում են, որ պաշտոնական SDK-ները ավտոմատ կրկին փորձում են ժամանակավոր ձախողումները (կապի սխալներ, սահմանաչափեր և 5xx սխալներ) լռելյայն երկու անգամ էքսպոնենցիալ հետաձգմամբ, և դուք կարող եք այն կարգավորել։ Յուրաքանչյուր պատասխան կրում է request-id վերնագիր․ գրանցեք այն, որպեսզի աջակցությունը կարողանա հետևել խնդիրներին։
Սովորական սխալներ
- API-ն կանչել բրաուզերից։ Ձեր բանալին հանրային է դառնում։ Միշտ անցեք ձեր սերվերով։ Տե՛ս ինչպես պահել API բանալիները անվտանգ։
- Մոռանալ, որ
max_tokens-ը սահման է, ոչ թե թիրախ։ Սահմանեք այն այն չափով, որ պահանջում է գործառույթը․ շատ ցածրը կտրում է պատասխանները, շատ բարձրը ռիսկի է ենթարկում երկար, թանկ պատասխանները։ - Կանոնները դնել օգտատիրոջ հաղորդագրության մեջ։ Մշտական հրահանգները պատկանում են
systemհուշմանը, իսկ թույլտվությունները՝ ձեր կոդին։ - Ամբողջ չաթը անվերջ ուղարկել։ Կրճատեք կամ ամփոփեք հին հերթափոխները, երբ զրույցները մեծանան։
- Առանց ծախսերի սահմանի կամ օգտատիրոջ սահմանաչափի։
- Մոդելի ID-ն կոդում ամրացնել։ Մոդելները թարմացվում և հանվում են։
- Անտեսել դադարեցման պատճառը։ Եթե պատասխանը կանգ է առել, քանի որ հասել է
max_tokens-ին, տեղեկացրեք օգտատիրոջը կամ բարձրացրեք սահմանը։
Ստուգաթերթ
- API բանալին ստեղծված է Claude Console-ում և պահված է որպես սերվերային գաղտնիք
- Առանձին բանալիներ փորձարկման և արտադրության համար
- Ծախսերի սահմանը դրված է․ հստակ հաղորդագրություն, երբ հասնում է դրան
- Բոլոր հարցումները անցնում են ձեր սերվերով թույլտվության ստուգումներով
- Համակարգային հուշումը պահում է կանոնները․ մոդելի ID-ն կոնֆիգուրացվելի է
-
max_tokens-ը սահմանված է յուրաքանչյուր գործառույթի համար․ երկար պատասխանները հոսքով - Մեկ օգտատիրոջ սահմանաչափ ձեր հավելվածում
- 429 և 529 մշակված են հետաձգմամբ․ հարցման ID-ները գրանցված են
- Ընկալելի սխալի վիճակ, որ չի կոտրում էջը
- Փորձարկված դատարկ, շատ երկար և թշնամական մուտքերով
Claude API-ի օգտագործումը Mythex-ում
Mythex-ի վրա կառուցած հավելվածներում Claude գործառույթները օգտագործում են ձեր սեփական Anthropic բանալին և վճարվում են ձեր Anthropic հաշվից, ոչ թե Mythex-ի կառուցման կրեդիտներից։ Դա առանձին է Mythex գործակալից, որը գրում է ձեր կոդը։ Ավելացրեք ANTHROPIC_API_KEY-ը որպես նախագծի գաղտնիք /secrets-ի, նախագծի կարգավորումների կամ չաթի գաղտնիքների քարտի միջոցով, ապա նկարագրեք գործառույթը վերը նշվածների նման հուշումներով։ Փոխելուց հետո նորից հրապարակեք կենդանի հավելվածը, որպեսզի գաղտնիքները կիրառվեն։ Տե՛ս Ավելացրեք AI գործառույթներ ձեր սեփական API բանալիներով սկզբնական հուշման համար։ Եթե ընտրում եք մատակարարների միջև, ինչպես ինտեգրել OpenAI API-ն ներկայացնում է նույն հողը OpenAI-ի համար։
Հարցեր
Ինչպե՞ս ստանամ Claude API բանալի։
Մուտք գործեք Claude Console՝ platform.claude.com, կարգավորեք վճարումը և ստեղծեք API բանալի։ Պահեք այն որպես սերվերային գաղտնիք, սովորաբար ANTHROPIC_API_KEY անունով, և երբեք մի դրեք բրաուզերի կոդում։
Ի՞նչ է պահանջվում Claude API-ի հարցումի համար։
2026 թվականի սեպտեմբերի դրությամբ Anthropic-ի Messages API հղումը թվարկում է երեք պարտադիր դաշտ՝ model, max_tokens և messages։ Ուղղակի HTTP կանչերին նաև անհրաժեշտ են x-api-key և anthropic-version վերնագրերը․ պաշտոնական SDK-ները դրանք սահմանում են ձեզ համար։
Ի՞նչ է 529 սխալը Claude API-ից։
Anthropic-ի սխալների էջը նկարագրում է 529-ը որպես overloaded_error․ API-ն ժամանակավորապես գերբեռնված է բարձր թրաֆիկի պատճառով բոլոր օգտատերերի մոտ։ Կրկին փորձեք էքսպոնենցիալ հետաձգմամբ։ Պաշտոնական SDK-ները ավտոմատ կրկին փորձում են որոշ ժամանակավոր սխալներ։
Կարո՞ղ եմ օգտագործել Claude-ը OpenAI SDK-ի համար գրված կոդով։
Anthropic-ը փաստաթղթավորում է OpenAI SDK-ի համատեղելիության շերտ՝ Claude-ը OpenAI SDK մակերեսի միջոցով օգտագործելու համար։ Նոր կոդի համար իր սեփական SDK-ները տալիս են Claude-ին հատուկ առանձնահատկությունների հասանելիություն, ուստի սովորաբար դրանք լավ սկիզբ են։