დეველოპერებისთვის

ორი ცვლადი და ერთი მისამართი

სერვერზე განსაზღვრე AIAPI_API_KEY და AIAPI_MODEL. პირველი შენს API გასაღებს შეიცავს, მეორე — კატალოგიდან დაკოპირებულ ზუსტ მოდელის სახელს. ქვემოთ მოცემული მაგალითები არ იყენებს შენს ნამდვილ მონაცემებს და ავტომატურად არაფერს აგზავნის.

Base URL: https://aiapi.ge/v1
Chat Completions: POST /v1/chat/completions
ავტორიზაცია: Authorization: Bearer <შენი_API_გასაღები>

პირველი მოთხოვნის მაგალითები

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

# POSIX shell: set AIAPI_API_KEY and AIAPI_MODEL first.
curl --fail-with-body --max-time 60 \
  https://aiapi.ge/v1/chat/completions \
  -H "Authorization: Bearer $AIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<JSON
{
  "model": "$AIAPI_MODEL",
  "messages": [
    { "role": "user", "content": "გამარჯობა!" }
  ]
}
JSON

წარმატებული პასუხიც შეამოწმე

HTTP სტატუსისა და JSON-ის მიღება მხოლოდ ტექნიკური ეტაპია. დარწმუნდი, რომ პასუხში მოსალოდნელი მონაცემებია. აპლიკაციამ უნდა გაითვალისწინოს ცარიელი პასუხი, მოულოდნელი ფორმატი და შემთხვევა, როცა მოდელის ტექსტი დამატებით გადამოწმებას მოითხოვს.

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

შეცდომა მართვადი სცენარი უნდა იყოს

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

401/403: გადაამოწმე გასაღები, ვადა, უფლებები და მოდელზე წვდომა.
429: შესაძლოა მოქმედებდეს მოთხოვნების ან რესურსის ლიმიტი; ნუ გაიმეორებ მოთხოვნას უსასრულოდ.
5xx ან კავშირის შეცდომა: დაგეგმე შეზღუდული გამეორება მზარდი დაყოვნებით.

საჯარო გაშვებამდე

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

განვითარებისა და სამუშაო გარემოსთვის ცალკე გასაღებები გამოიყენე.
დააყენე აპლიკაციის საკუთარი ლიმიტები და აკონტროლე ხარჯი.
ცვლილება ჯერ მცირე მოცულობით გამოსცადე.
საიდუმლო მონაცემები არც კოდში და არც ჟურნალებში დატოვო.