Kalitlar va API manzili
MarkdownKalitni qayerdan olish, turli SDK’larda qaysi manzilni ko‘rsatish va kalitni qanday yuborish kerak.
To‘liq qo‘llanma
API kaliti
Kalit yaratiladigan boshqaruv paneli: ailoot.ai — avval ro‘yxatdan o‘ting. U quyidagicha ko‘rinadi: sk-…. Bir nechta kalit yaratish mumkin: ish kompyuteri, server va har bir ilova uchun alohida — shunda qolganlariga tegmasdan bitta kalitni bekor qilish osonroq.
Kalit uchun umumiy sarf limiti, amal qilish muddati, IP manzillarining oq va qora ro‘yxatlari hamda 5 soat, 1 kun va 7 kunlik sarf davrlari limitlarini belgilash mumkin. Cheklov ishga tushsa, tushunarli xato keladi: api_key_quota_exhausted (umumiy limit tugagan), usage_limit_reached (kalitning sarf davri limiti tugagan — davr yangilanishini kuting yoki limitni oshiring), api_key_expired yoki permission_denied (masalan, so‘rov ruxsat etilgan IP’dan emas).
API manzili
Asosiy qoida: OpenAI bilan mos mijoz dasturlari uchun manzil quyidagi bilan: /v1, Anthropic va Gemini uchun — usiz.
| Mijoz dasturi | Bazaviy manzil | So‘rov qayerga yuboriladi |
|---|---|---|
| OpenAI SDK va mos mijoz dasturlari | https://api.ailoot.ai/v1 | /v1/chat/completions, /v1/responses, /v1/embeddings |
| Anthropic SDK, Claude Code | https://api.ailoot.ai | /v1/messages |
| Google GenAI SDK, Gemini CLI | https://api.ailoot.ai | /v1beta/models/{model}:generateContent |
| Mijoz dasturi to‘liq manzilni so‘raydi | https://api.ailoot.ai/v1/chat/completions | ko‘rsatilganidek |
Kalitni qanday yuborish kerak
Ailoot uchta sarlavhaning istalgan birida kalitni qabul qiladi — SDK’ingiz qaysi birini yuborsa, o‘sha mos keladi:
| Sarlavha | Kim shunday yuboradi |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, aksariyat mijoz dasturlari |
x-api-key: sk-… | ANTHROPIC_API_KEY bilan Anthropic SDK, Claude Code |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Quyidagi yo‘llarda /v1/… manzildagi kalit (?key= yoki ?api_key=) qabul qilinmaydi: so‘rov 400 va quyidagi kodni oladi: invalid_request hamda kalit manzilda yuborilgani haqidagi xabarni. Shunda kalit jurnallar va brauzer tarixiga tushmaydi. Kalit allaqachon manzilda ishlatilgan bo‘lsa, yangisini yaratgan ma’qul.
Gemini’ning quyidagi yo‘llarida /v1beta/… Google bilan moslik uchun qabul qilinadi: ?key= — eng past ustuvorlik bilan, sarlavhalardan keyin. ?api_key= u yerda ham 400 bilan rad etiladi. Baribir kalitni quyidagi sarlavhada yuborish ishonchliroq: x-goog-api-key.
Muhit o‘zgaruvchilari
Bitta o‘zgaruvchi yaratib, uni turli dasturlar sozlamalariga qo‘yish qulay:
# ~/.zshrc yoki ~/.bashrc
export AILOOT_API_KEY="sk-..."
# standart nomlarni o‘qiydigan dasturlar uchun
export OPENAI_BASE_URL="https://api.ailoot.ai/v1"
export OPENAI_API_KEY="$AILOOT_API_KEY"
export ANTHROPIC_BASE_URL="https://api.ailoot.ai"
export ANTHROPIC_AUTH_TOKEN="$AILOOT_API_KEY"setx AILOOT_API_KEY "sk-..."
# standart nomlarni o‘qiydigan dasturlar uchun
setx OPENAI_BASE_URL "https://api.ailoot.ai/v1"
setx OPENAI_API_KEY "sk-..."
setx ANTHROPIC_BASE_URL "https://api.ailoot.ai"
setx ANTHROPIC_AUTH_TOKEN "sk-..."
# o‘zgaruvchilar yuklanishi uchun terminalni qayta ishga tushiringKalitni tekshirish
Kalitni tekshirishning eng arzon usuli — modellar ro‘yxatini so‘rash: bu bepul.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"