როგორ დავაინტეგროთ OpenAI API თქვენს აპში

OpenAI API-ის დასაინტეგრირებლად შექმენით API გასაღები OpenAI-ის პროექტში, შეინახეთ იგი როგორც სერვერული საიდუმლო სახელით OPENAI_API_KEY და გამოიძახეთ API თქვენი სერვერის მარშრუტიდან OpenAI-ის ოფიციალური SDK-ით, არასდროს ბრაუზერის კოდიდან. 2026 წლის სექტემბრის მდგომარეობით, OpenAI-ის quickstart ახალი პროექტების დასაწყისად Responses API-ს წარმოადგენს. გაშვებამდე დააყენეთ ხარჯების ლიმიტი, შეზღუდეთ პასუხის სიგრძე, განსაზღვრეთ, რამდენად ხშირად შეუძლია თითო მომხმარებელს ფუნქციის გამოძახება, და ლიმიტის შეცდომები ხელახალი ცდებით დაამუშავეთ.

ეს გიდი მოიცავს დაყენებას, მოთხოვნის ნაკადს, AI-ბილდერისთვის განკუთვნილ მოთხოვნებს და შეცდომებს, რომლებიც გასაღებებს ჟონავს ან ფულს ხარჯავს. OpenAI-ის დეტალები აღებულია მისი ოფიციალური დოკუმენტაციიდან 2026 წლის სექტემბრის მდგომარეობით. ზოგადი ცნებებისთვის (ტოკენები, კონტექსტის ფანჯრები, ფასები) ჯერ წაიკითხეთ როგორ გამოვიყენოთ LLM API-ები.

რა შეგიძლიათ ააშენოთ მასთან

• ჩატ-ასისტენტი თქვენს აპში (როგორ ავაშენოთ AI ჩატბოტის აპი)
• ღილაკები „შეაჯამე ეს“, „გადაწერე ეს“ ან „შეადგინე პასუხი“
• მონაცემების ამოღება თავისუფალი ტექსტიდან: ელფოსტის გადაქცევა შეკვეთად, support-ის ბილეთების მარკირება
• ძიება და კითხვებზე პასუხი თქვენს საკუთარ შინაარსზე
• სურათების გენერირება, ხმა და სხვა მედია ფუნქციები, მოდელების მიხედვით

მეტი იდეისთვის იხილეთ როგორ დავამატოთ AI ფუნქციები თქვენს აპში.

OpenAI ანგარიშის დაყენება

1. შექმენით ანგარიში და პროექტი OpenAI პლატფორმაზე. OpenAI-ის production საუკეთესო პრაქტიკები გირჩევთ ცალკე პროექტებს სატესტო და პროდაქშენისთვის, რომ თითოეულს ჰქონდეს საკუთარი გასაღებები და ლიმიტები.
2. შექმენით პროექტის API გასაღები. OpenAI გირჩევთ ვადის დაყენებას და გასაღებების რეგულარულ ცვლას.
3. დააყენეთ ხარჯების შეტყობინებები და მკაცრი ლიმიტი ლიმიტების გვერდზე. OpenAI-ის გიდის მიხედვით, შეტყობინებები გაგაფრთხილებთ, როცა გამოყენება თანხას გადააჭარბებს, ხოლო მკაცრი ლიმიტი ყოველთვიურ ზღვარს ახორციელებს.
4. დაამატეთ გადახდა. OpenAI-ის rate-limit დოკუმენტაცია აღწერს გამოყენების დონეებს: თქვენი ლიმიტები ავტომატურად იზრდება, რაც მეტს დახარჯავთ დროთა განმავლობაში.

მოთხოვნის ნაკადი

ბრაუზერი  ->  თქვენი სერვერის მარშრუტი  ->  OpenAI API
          <-  (სტრიმული) პასუხი        <-

1. მომხმარებელი აჭერს ღილაკს ან აგზავნის შეტყობინებას.
2. ბრაუზერი იძახებს თქვენს მარშრუტს, მაგალითად POST /api/summarise.
3. თქვენი სერვერი ამოწმებს, რომ მომხმარებელი შესულია და უფლება აქვს ფუნქციით სარგებლობა.
4. სერვერი აგებს მოთხოვნას: ინსტრუქციებს, მომხმარებლის შეყვანას და მონაცემებს თქვენი ბაზიდან, თუ დავალებას სჭირდება.
5. ის იძახებს OpenAI-ს გარემოდან აღებული გასაღებით. OpenAI-ის SDK-ები OPENAI_API_KEY-ს ავტომატურად კითხულობენ.
6. პასუხს სტრიმავს ან აბრუნებს და აღრიცხავს ტოკენების გამოყენებას.

OpenAI-ის ოფიციალურ SDK პაკეტს ჰქვია openai როგორც JavaScript/TypeScript-ისთვის (npm), ისე Python-ისთვის (pip).

მოდელის არჩევა

OpenAI გთავაზობთ რამდენიმე მოდელს სხვადასხვა ფასსა და სიჩქარეში, და ასორტიმენტი ხშირად იცვლება. დაიწყეთ უფრო პატარა, იაფი მოდელით, გაზომეთ ხარისხი რეალურ მაგალითებზე და გადადით უფრო დიდზე მხოლოდ საჭიროების შემთხვევაში. მოდელის სახელი შეინახეთ კონფიგურაციის მნიშვნელობაში ან საიდუმლოში, რომ კოდის გადაწერის გარეშე შეცვალოთ. მიმდინარე ტარიფებისთვის შეამოწმეთ OpenAI-ის ფასების გვერდი.

ვარიანტები და კომპრომისები

მოთხოვნები თქვენს AI-ბილდერისთვის

პირველი ფუნქცია:

დაამატე ღილაკი „შეაჯამე“ ბილეთის გვერდზე. ის იძახებს სერვერულ მარშრუტს POST /api/summarise, რომელიც ამოწმებს, რომ მომხმარებელი შესულია, ტვირთავს ბილეთს და იძახებს OpenAI Responses API-ს ოფიციალური openai SDK-ით და საიდუმლო OPENAI_API_KEY-ით. წაიკითხე მოდელის სახელი საიდუმლო OPENAI_MODEL-იდან. ინსტრუქცია: „შეაჯამე 3 პუნქტად, შემდეგ შესთავაზე მოკლე პასუხი. არ მოიგონო შეკვეთის ნომრები.“ შეზღუდე გამომავალი სიგრძე, პასუხი სტრიმე გვერდზე და არასდროს გაუგზავნო გასაღები ბრაუზერს.

დაცვა:

შეზღუდე თითო მომხმარებელი 30 AI მოთხოვნით საათში, ბაზაში შენახული. აღრიცხე შემავალი და გამომავალი ტოკენები თითო მოთხოვნაზე მომხმარებლის ID-ითა და ფუნქციის სახელით. თუ OpenAI 429-ს აბრუნებს, დაემორჩილე Retry-After სათაურს და სცადე ექსპონენციური დაყოვნებითა და jitter-ით მაქსიმუმ 3-ჯერ; ამის შემდეგ აჩვენე „AI დაკავებულია, სცადეთ ერთ წუთში.“ ნებისმიერ სხვა შეცდომაზე აჩვენე მეგობრული შეტყობინება და დატოვე დანარჩენი გვერდი მუშა.

შეცდომებისა და ლიმიტების დამუშავება

OpenAI rate limit-ებს რამდენიმე გზით ზომავს, მათ შორის მოთხოვნებს წუთში და ტოკენებს წუთში, და ის ლიმიტი, რომელიც პირველი ამოიწურება, ხვდება. როცა ერთ-ერთს გადააჭარბებთ, API 429-ს აბრუნებს Retry-After სათაურით. OpenAI-ის დოკუმენტაცია ამბობს, რომ ეს მნიშვნელობა მინიმუმად უნდა მივიჩნიოთ და დავამატოთ პატარა შემთხვევითი დაყოვნება, რომ კლიენტები ერთდროულად არ სცადონ ხელახლა.

ასევე მოემზადეთ:

• დროის ლიმიტები გრძელ გენერაციებზე. სტრიმინგი ეხმარება, ასევე გონივრული გამომავალი ზღვარი.
• პროვაიდერის გაუმართაობა. AI ფუნქციამ უნდა გააჩერო ისე, რომ გვერდი არ დაინგრეს.
• ცუდი გამომავალი. სტრუქტურირებული გამომავალი შეამოწმეთ შენახვამდე და არ მისცეთ მოდელის გამომავალს მგრძნობიარე ქმედების გამოწვევის უფლება თქვენი კოდის შემოწმების გარეშე.

გავრცელებული შეცდომები

• გასაღები frontend-ში ან რეპოზიტორიაში. ბრაუზერის კოდი საჯაროა, და გაჟონილი გასაღები წუთებში შეიძლება გამოიყენონ. იხილეთ როგორ შევინახოთ API გასაღებები უსაფრთხოდ.
• ხარჯების ლიმიტის არქონა. ციკლმა ან ბოროტად მოქმედმა მომხმარებელმა სწრაფად შეიძლება დიდი ანგარიში გამოიწვიოს.
• თითო მომხმარებელზე ლიმიტის არქონა. პროვაიდერის ლიმიტი თქვენს საფულეს იცავს, არა სხვა მომხმარებლებს.
• უსაფრთხოების მოთხოვნაზე დაყრდნობა. მომხმარებელს შეუძლია ჩაწეროს „უგულებელყავი წინა ინსტრუქციები“. უფლებები სერვერულ კოდში უნდა იყოს.
• ზედმეტის გაგზავნა. მთელი დოკუმენტები და გრძელი ისტორიები ხარჯს ამრავლებს. გაუგზავნეთ მხოლოდ დავალებისთვის საჭირო.
• მოდელის სახელის ხელით ჩაწერა კოდში. მოდელები განახლდება და ვეღარ იარსებებს; გახადეთ ის პარამეტრად.
• პერსონალური მონაცემების გაგზავნა ფიქრის გარეშე. წაიკითხეთ OpenAI-ის მონაცემთა გამოყენების პირობები და გაუგზავნეთ მხოლოდ ის, რაც ფუნქციას სჭირდება.

ჩამონათვალი

• ცალკე OpenAI პროექტები (ან გასაღებები) ტესტირებისა და პროდაქშენისთვის
• გასაღები შენახულია სერვერულ საიდუმლოდ, არასდროს ბრაუზერის კოდში ან რეპოზიტორიაში
• ხარჯების შეტყობინებები და მკაცრი ლიმიტი დაყენებულია
• ყველა გამოძახება გადის თქვენს სერვერზე და ამოწმებს მომხმარებლის უფლებებს
• გამომავალი სიგრძე შეზღუდულია; მოდელის სახელი კონფიგურირებადია
• თითო მომხმარებელზე ლიმიტი თქვენს აპში
• 429 დამუშავებულია Retry-After-ით, დაყოვნებით და jitter-ით
• მეგობრული შეცდომის მდგომარეობა; გვერდი მუშაობს AI-ის გარეშეც
• ტოკენების გამოყენება აღრიცხულია ფუნქციის მიხედვით
• გამოცდილია გრძელი, ცარიელი და მტრული შეყვანებით

OpenAI API Mythex-ში

AI ფუნქციები აპებში, რომლებსაც Mythex-ზე აშენებთ, იყენებს თქვენს საკუთარ OpenAI გასაღებს და ირიცხება თქვენს OpenAI ანგარიშზე, არა Mythex-ის build კრედიტებზე. დაამატეთ OPENAI_API_KEY პროექტის საიდუმლოდ /secrets-ით, პროექტის პარამეტრებით ან საიდუმლოების ბარათით, რომელსაც აგენტი აჩვენებს, როცა გასაღები სჭირდება. შემდეგ აღწერეთ ფუნქცია ზემოთ მოცემულის მსგავსი მოთხოვნით. გამოქვეყნებულ აპზე საიდუმლოების შეცვლის შემდეგ ხელახლა გამოაქვეყნეთ, რომ ისინი აიღოს. დოკუმენტაციის რეცეპტს AI ფუნქციების დამატება საკუთარი API გასაღებებით აქვს საწყისი მოთხოვნა, ხოლო საიდუმლოები ჩატში განმარტავს საიდუმლოების ბარათს. პროვაიდერებს თუ ადარებთ, იხილეთ როგორ დავაინტეგროთ Claude API.

კითხვები