Autentifikasiya

Açar yaratmaq

API açarları console.artfical.com saytındakı bir iş sahəsindən, API açarları səhifəsindən verilir. Açar əldə etməyin yeganə yolu oradan yaratmaqdır; açarı API-nin özü vasitəsilə yaratmaq və ya yeniləmək mümkün deyil, və bu qəsdən belədir: açar yaratmaq həssas, az tezlikli bir əməliyyatdır, və bunu konsolun öz autentifikasiya olunmuş sessiyasının arxasında saxlamaq, yalnız API səviyyəsində girişi olan hər hansı bir şeyin ona çatmasının qarşısını alır.

Açar belə görünür, həmişə eyni prefiksi daşıyır:

tai-sk-bSL2q4ja-skivx5JVNaJyyDVtKgiBAxuq8yRzsb6-e8

Açarın tam dəyəri yalnız bir dəfə, onu yaratdığınız anda göstərilir. Bundan sonra konsol identifikasiya üçün yalnız qısaldılmış formanı göstərir (ilk bir neçə simvol və son bir neçə simvol, ortası gizlədilmiş halda). Tam dəyəri itirsəniz, onu bərpa etməyin heç bir yolu yoxdur; yeganə seçim həmin açarı ləğv edib yenisini yaratmaqdır. Açara verilənlər bazası parolu ilə eyni cür yanaşın: onu mühit dəyişənində və ya sirlər meneceində saxlayın, mənbə kodunda yox, və heç vaxt son istifadəçinin brauzerinin oxuya biləcəyi client-side bir tətbiqdə saxlamayın.

Açarı sorğuda göndərmək

/v1/chat/completions və /v1/models ünvanlarına hər sorğu açarı, Bearer sxemindən istifadə edərək, standart Authorization başlığında daxil etməlidir:

Authorization: Bearer tai-sk-bSL2q4ja-skivx5JVNaJyyDVtKgiBAxuq8yRzsb6-e8

Bu, OpenAI-nin öz API-sinin istifadə etdiyi başlıq forması ilə tamamilə eynidir, buna görə də mövcud bir openai-SDK əsaslı klienti tAI-yə yönəltmək adətən bir sətirlik dəyişiklikdir: base_url-ü https://api.artfical.com/v1 olaraq, api_key-i isə öz tAI açarınız olaraq təyin edin, SDK-nın öz sorğu kodunu dəyişməyə ehtiyac yoxdur.

# Python, rəsmi openai paketindən istifadə edərək
from openai import OpenAI

client = OpenAI(
    base_url="https://api.artfical.com/v1",
    api_key="tai-sk-...",
)

response = client.chat.completions.create(
    model="tai-4.1",
    messages=[{"role": "user", "content": "Merhaba"}],
)
print(response.choices[0].message.content)

Başlığı tamamilə buraxan, və ya onu yanlış formada göndərən (Bearer prefiksi olmadan, boş dəyər, parse olunmayan açar) bir sorğu, tamamilə yanlış açarla eyni şəkildə rədd edilir: authentication_error tipli 401. Dəqiq cavab formatı üçün Xətalar səhifəsinə baxın.

İş sahələri və əhatə dairəsi

Açar dəqiq bir iş sahəsinə aiddir və yalnız həmin iş sahəsi adından sorğu etmək üçün istifadə oluna bilər. Bir neçə iş sahəsini əhatə edən açar anlayışı yoxdur, və tək bir açara yalnız bəzi modellərə və ya bəzi sürət limiti səviyyəsinə qismən giriş vermək mümkün deyil; bir iş sahəsindəki hər açar Modellər səhifəsində sadalanan hər modelə eyni girişə malikdir. İki fərqli layihə arasında istifadəni və ya faktura hesablamasını ayırmağa ehtiyacınız varsa, cavab öz açarları olan iki iş sahəsidir, ikisi arasında paylaşılan tək bir açar deyil.

Müəyyən bir açarla edilən istifadə — sorğu sayları, token sayları və təxmini xərc — həmin açara aid edilir və açarın aid olduğu iş sahəsi ilə məhdudlaşan konsolun İstifadə səhifəsində görünür. Bu tamamilə sizin tərəfinizdən görünürlük üçündür; sorğunun necə emal olunmasına təsir etmir.

Etibarlılıq müddəti

Açar istəyə görə bir bitmə tarixi ilə yaradıla bilər (7, 30 və ya 90 gün sonra, ya da heç vaxt — açar yaradılarkən seçilir). Açar bitmə tarixini keçdikdən sonra, onunla edilən hər sorğu etibarsız açarla eyni 401 authentication_error kodu ilə rədd edilir, kənardan fərqləndirilə bilmir. Əvvəllər işləyən bir açardan istifadə edən sorğular birdən 401 ilə uğursuz olmağa başlayırsa, başqa bir şeyin xarab olduğunu düşünməzdən əvvəl API açarları səhifəsində yoxlanmalı ilk şey bitmiş açardır.

Avtomatik yenilənmə yoxdur. Bitmə tarixinə yaxınlaşan açar yeni yaradılmış biri ilə əvəz olunmalıdır; konsol mövcud açarın ömrünü yerində uzatmır.

Açarı ləğv etmək

Açar istənilən vaxt API açarları səhifəsindən dərhal və geri dönülməz şəkildə ləğv oluna bilər. Ləğv edilmiş açar API-nin baxımından tam olaraq bitmiş açar kimi davranır: onunla edilən hər sonrakı sorğu 401 alır. Ləğvetmə sızmış bir açara düzgün cavabdır; açarın gizli dəyərini yerində yeniləməyin heç bir yolu yoxdur, yalnız köhnəsini ləğv edib onun əvəzinə yenisini yaratmaq mümkündür.

Açarın tək başına vermədiyi şeylər

Etibarlı bir API açarına sahib olmaq söhbət tamamlama sorğuları etmək və modelləri siyahıya almaq üçün kifayətdir. Bu, konsolun istifadəçi interfeysindəki heç bir şeyə, iş sahəsi ayarlarına, faktura məlumatlarına və ya digər üzvlərin fəaliyyətinə giriş vermir; bunlar API açarlarından tamamilə ayrı olan konsolun öz sessiya əsaslı girişi ilə qorunur. Sızmış bir API açarı real bir problemdir, çünki bu, kiminsə iş sahəniz adından sorğular etməsinə (və müvafiq istifadəni yaratmasına) imkan verir, lakin bu tək başına konsol hesabınızı açmır və ya kiminsə sizin adınızdan daxil olmasına imkan vermir.