tAI API istinadı

Endpoint

Bu API-dəki hər şey tək bir URL üzərindən keçir:

# Baza URL
https://api.artfical.com/v1

Tək bir tamamlama endpoint-i, POST /v1/chat/completions, və tək bir yalnız-oxunan siyahılama endpoint-i, GET /v1/models mövcuddur. Bütün səth elə budur. Hər model üçün ayrı endpoint yoxdur, axın (streaming) ilə axın olmayan cavablar üçün ayrı endpoint yoxdur (eyni URL hər ikisini idarə edir, sorğu gövdəsindəki bir sahə ilə seçilir), və alət çağırışı (tool-calling) növbələri üçün ayrı endpoint yoxdur. OpenAI-nin Chat Completions API-sinə, GitHub-un inference endpoint-lərinə və ya OpenAI ilə uyğun format təqdim edən bir çox provayderdən hər hansı birinə qarşı kod yazmısınızsa, bu sizə artıq tanış gələcək. Bu bənzərlik təsadüfi deyil: mövcud bir OpenAI ilə uyğun klienti (rəsmi openai Python və ya Node paketi, LangChain, LlamaIndex, OpenCode kimi bir kodlaşdırma agenti və ya öz sadə wrapper-inizi) tAI API açarı ilə https://api.artfical.com/v1 ünvanına yönəltmək demək olar ki, heç bir kod dəyişikliyi olmadan işləməlidir.

İlk sorğuya ən qısa yol

Üç şey lazımdır: console.artfical.com üzərində bir iş sahəsi, həmin iş sahəsindəki API açarları səhifəsindən yaradılmış bir API açarı, və istənilən HTTP klienti. Budur curl istifadə edərək ən qısa versiya:

# tai-sk-... yerinə öz açarınızı yazın
curl https://api.artfical.com/v1/chat/completions \
  -H "Authorization: Bearer tai-sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tai-4.1",
    "messages": [{"role": "user", "content": "Merhaba, kendini tanıt."}]
  }'

Bu tək sorğu tam, işlək bir inteqrasiyadır. Bu bölmədə qalan hər şey — axın, alət çağırışı, şəkil girişi, nümunələmə tənzimləmələri — öyrənilməli fərqli bir API deyil, məhz eyni formanın üzərinə əlavə olunan könüllü bir qatdır. Söhbət tamamlamaları səhifəsi tam sorğu və cavabı ətraflı izah edir; Autentifikasiya səhifəsi isə açarın özünün necə verildiyini, hansı əhatədə olduğunu və necə yeniləndiyini əhatə edir.

Bu bölmə necə təşkil olunub

Buradakı səhifələr, əsas implementasiyanın necə təşkil olunmasına deyil, insanların onlara faktiki olaraq hansı sırada ehtiyac duyduğuna uyğun qruplaşdırılıb. Birinci qrup, başlanğıc, nə qurmasından asılı olmayaraq hər kəsin ehtiyac duyduğu hissədir: necə autentifikasiya olunacağı, sorğu və cavabın forması, axının tək bir bloklayıcı cavabdan nə ilə fərqləndiyi, və hansı modellərin mövcud olduğunu, hər birinin nəyə başa gəldiyini və nəyi dəstəklədiyini necə aşkar edəcəyiniz. İkinci qrup, sorğu seçimləri, əsas bir sorğunun üzərində könüllü olan hər şeyi əhatə edir: cavabın necə yaradıldığını formalaşdıran nümunələmə tənzimləmələri, modelə çağıra biləcəyi alətləri necə verəcəyiniz, və mətnlə yanaşı şəkli necə göndərəcəyiniz. Üçüncü qrup, istinad, başdan sona oxunmaq üçün deyil, ehtiyac olanda müraciət etmək üçün nəzərdə tutulub: xəta cavabının dəqiq forması və hər növün nə demək olduğu, sürət məhdudlaşdırmasının necə işlədiyi və bunu hansı başlıqların əks etdirdiyi, modelə görə qiymət cədvəli, və mövcud bir OpenAI-SDK inteqrasiyasını köçürən hər kəs üçün xüsusi olaraq nəyin olduğu kimi dəstəkləndiyi və nəyin dəstəklənmədiyi.

Bu kimin üçündür

Bu bölmə birbaşa API-yə qarşı kod yazan kəs üçün yazılıb — istər bu bir backend xidməti, bir skript, istərsə də tAI-ni bir-birini əvəz edə bilən bir neçə OpenAI ilə uyğun provayderdən biri kimi qəbul edən OpenCode kimi bir agent çərçivəsi olsun. HTTP sorğuları göndərmək və JSON oxumaqda rahat olmağı nəzərdə tutur, lakin tAI ilə əvvəlcədən heç bir tanışlığı tələb etmir. Əgər siz tAI-ni birbaşa söhbət məhsulu vasitəsilə necə istifadə edəcəyinizi axtarırsınızsa, bu, bu bölmədə deyil, əsas tAI sənədlərində əhatə olunub. Əgər tAI-nin təhlükəsizlik baxımından necə qiymətləndirildiyini və məhsulun hansı qoruyucu tədbirlərlə qurulduğunu axtarırsınızsa, bu, Təhlükəsizlik bölməsidir. Bu bölmə xüsusi olaraq developer üçün nəzərdə tutulmuş HTTP API ilə məhdudlaşır: nə göndərirsiniz, nə geri alırsınız, və hər sahə ilə başlığın nə demək olduğu.

Sabitlik haqqında qeyd

Bu bölmədə sənədləşdirilmiş sorğu və cavab formaları bizim sabit saxlamağı planladığımız formalardır. API böyüdükcə zaman-zaman yeni bir sahənin əlavə olunması gözlənilən bir şeydir; lakin sənədləşdirilmiş bir sahənin mənasının dəyişməsi və ya əvəzsiz aradan qalxması bizim asanlıqla etdiyimiz bir şey deyil. Bir şeyin həqiqətən müvəqqəti olduğu və ya dəyişmə ehtimalı olduğu yerlərdə, müvafiq səhifə bunu sizi çətin yolla öyrənməyə qoymaq əvəzinə açıq şəkildə bildirir. Əgər bir sahə və ya davranış bu bölmədə heç yerdə qeyd olunmayıbsa, cavabda onu müşahidə etsəniz belə, bunu dəstəklənən müqavilənin bir hissəsi hesab etməyin, çünki xəbərdarlıq edilmədən dəyişə və ya yox ola bilər.