როგორ დავაინტეგროთ Claude API თქვენს აპში
Claude API-ის დასაინტეგრირებლად შექმენით API გასაღები Anthropic-ის Claude Console-ში, შეინახეთ იგი როგორც სერვერული საიდუმლო (ჩვეულებრივ ANTHROPIC_API_KEY) და გამოიძახეთ Messages API თქვენი სერვერის მარშრუტიდან ერთ-ერთი ოფიციალური Anthropic SDK-ით. ყოველი მოთხოვნა ასახელებს მოდელს, ადგენს max_tokens-ს (ყველაზე გრძელ პასუხს, რომელსაც მიიღებთ) და აგზავნის საუბარს messages-ად, ხოლო თქვენი ინსტრუქციები ცალკე system მოთხოვნაში მიდის. დააყენეთ ხარჯების ლიმიტი, გადაიყვანეთ გრძელი პასუხები სტრიმინგში და დაამუშავეთ ლიმიტის (429) და გადატვირთვის (529) შეცდომები ხელახალი ცდებით.
ეს გიდი მოიცავს დაყენებას, უსაფრთხო მოთხოვნის ნაკადს, AI-ბილდერისთვის განკუთვნილ მოთხოვნებს და შეცდომებს, რომლებისთვისაც უნდა მოემზადოთ. Anthropic-ის დეტალები აღებულია მათი დოკუმენტაციიდან 2026 წლის სექტემბრის მდგომარეობით. ტოკენებისა და ფასების მუშაობის ზოგადი წესებისთვის იხილეთ როგორ გამოვიყენოთ LLM API-ები.
რა შეგიძლიათ ააშენოთ მასთან
- ჩატ-ასისტენტები და დამხმარე ვიჯეტები (როგორ ავაშენოთ AI ჩატბოტის აპი)
- შეჯამებები, გადაწერები და მოპასუხე პასუხების პროექტები
- ველების ამოღება დოკუმენტებიდან, ელფოსტებიდან და ფორმებიდან
- კითხვებზე პასუხი თქვენი საკუთარი შინაარსიდან
- აგენტები, რომლებიც თქვენი აპის ფუნქციებს იძახებენ tool use-ით
მეტი იდეისთვის იხილეთ როგორ დავამატოთ 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 ხანგრძლივი მოთხოვნებისთვის სტრიმინგს ან batch-ებს გირჩევთ |
| გამოსავლის ფორმატი | ჩვეულებრივი ტექსტი | სტრუქტურირებული JSON, როცა თქვენს კოდს ველები უნდა წაიკითხოს |
| თქვენი მონაცემები | ჩართეთ შესაბამისი ჩანაწერი | მოძიება თქვენს შინაარსში, როცა ზედმეტად ბევრია (რა არის RAG) |
| მოქმედებები | მოდელი მხოლოდ წერს ტექსტს | Tool use, როცა მოდელი თქვენს კოდს სთხოვს თქვენს მიერ განსაზღვრული ფუნქციის გაშვებას |
| მასობრივი, არასასწრაფო სამუშაო | ციკლი ელემენტებზე | 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 MB-მდე იღებს |
| 429 | rate_limit_error | უკან დაიხიეთ და სცადეთ თავიდან, retry-after-ს დაემორჩილეთ |
| 500 | api_error | ხელახლა სცადეთ დაყოვნებით; თუ გრძელდება, მიმართეთ მხარდაჭერას მოთხოვნის ID-ით |
| 529 | overloaded_error | დროებით მაღალი ტრაფიკი ყველა მომხმარებელზე; უკან დაიხიეთ და სცადეთ თავიდან |
Anthropic-ის დოკუმენტაცია ამბობს, რომ ოფიციალური SDK-ები ავტომატურად იმეორებენ დროებით შეცდომებს (კავშირის შეცდომები, ლიმიტები და 5xx შეცდომები) ნაგულისხმევად ორჯერ, ექსპონენციური დაყოვნებით, და ეს კონფიგურირებადია. ყოველ პასუხს აქვს request-id სათაური; ჩაწერეთ იგი, რომ მხარდაჭერამ პრობლემა გაყვანოს.
გავრცელებული შეცდომები
- API-ის გამოძახება ბრაუზერიდან. თქვენი გასაღები საჯარო გახდება. ყოველთვის გაიარეთ თქვენი სერვერი. იხილეთ როგორ შევინახოთ API გასაღებები უსაფრთხოდ.
max_tokensარის ზღვარი და არა სამიზნე. დააყენეთ იმის მიხედვით, რაც ფუნქციას სჭირდება; ძალიან დაბალი პასუხებს წყვეტს, ძალიან მაღალი იწვევს გრძელ, ძვირ პასუხებს.- წესების მომხმარებლის შეტყობინებაში ჩაწერა. მუდმივი ინსტრუქციები
systemმოთხოვნაში უნდა იყოს; უფლებები — თქვენს კოდში. - მთელი ჩატის სამუდამოდ გაგზავნა. საუბრის ზრდასთან ერთად მოჭერით ან შეაჯამეთ ძველი რეპლიკები.
- ხარჯების ლიმიტის ან თითო მომხმარებელზე ლიმიტის არქონა.
- მოდელის ID-ის ხელით ჩაწერა კოდში. მოდელები განახლდება და გამოდის მწარმოებლისგან.
- stop reason-ის იგნორირება. თუ პასუხი შეჩერდა
max_tokens-ზე მისვლისას, შეატყობინეთ მომხმარებელს ან გაზარდეთ ზღვარი.
ჩამონათვალი
- API გასაღები შექმნილია Claude Console-ში და შენახულია სერვერულ საიდუმლოდ
- ცალკე გასაღებები ტესტირებისა და პროდაქშენისთვის
- ხარჯების ლიმიტი დაყენებულია; მიღწევისას ნათელი შეტყობინება
- ყველა მოთხოვნა გადის თქვენს სერვერზე უფლებების შემოწმებით
- სისტემური მოთხოვნა შეიცავს წესებს; მოდელის ID კონფიგურირებადია
-
max_tokensდაყენებულია თითო ფუნქციაზე; გრძელი პასუხები სტრიმინგდება - თითო მომხმარებელზე ლიმიტი თქვენს აპში
- 429 და 529 დამუშავებულია დაყოვნებით; მოთხოვნის ID-ები ჩაწერილია
- შეცდომის მშვიდი მდგომარეობა, რომელიც გვერდს არ ანგრევს
- გამოცდილია ცარიელი, ძალიან გრძელი და მტრული შეყვანებით
Claude API Mythex-ში
Mythex-ზე აშენებულ აპებში Claude-ის ფუნქციები იყენებს თქვენს საკუთარ Anthropic გასაღებს და ირიცხება თქვენს Anthropic ანგარიშზე, არა Mythex-ის build კრედიტებზე. ეს განცალკევებულია აგენტისგან, რომელიც თქვენს კოდს წერს. დაამატეთ 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-ისთვის დამახასიათებელ შესაძლებლობებს, ამიტომ ისინი ჩვეულებრივ უკეთესი დასაწყისია.