Bu qanday ishlaydi
MarkdownDasturingiz va model o‘rtasida so‘rov bilan nimalar sodir bo‘ladi.
To‘liq qo‘llanma
Ailoot API’ga so‘rovni bevosita OpenAI, Anthropic yoki Google’ga yuborgandek yuborasiz. Ailoot kalit va balansni tekshiradi, so‘rovni modelga uzatadi, javobni ayni formatda qaytaradi va haqiqiy sarf bo‘yicha pul yechib oladi.
Bitta kalit — uchta format
Formatni model emas, so‘rov yo‘li belgilaydi. Ayni Claude modelini OpenAI Chat, OpenAI Responses yoki Anthropic Messages orqali chaqirish mumkin — javob siz chaqirgan yo‘l formatida keladi.
| Format | Yo‘l | Kim foydalanadi |
|---|---|---|
| OpenAI Chat Completions | /v1/chat/completions | OpenAI SDK, aksariyat chat va muharrirlar, n8n, LangChain |
| OpenAI Responses | /v1/responses | Codex CLI, OpenAI Agents SDK, SDK’larning yangi versiyalari |
| Anthropic Messages | /v1/messages | Claude Code, Anthropic SDK, Zed, Cline |
| Gemini | /v1beta/models/{model}:generateContent | Gemini CLI, Google GenAI SDK |
Pul: zaxira va bitta yechib olish
- Yangi matn so‘rovini yuborishdan oldin Ailoot kirish va odatiy javobning taxminiy narxini zaxiraga oladi; bunda limit (
max_tokens) va aniq model shartlari hisobga olinadi. Agar zaxira erkin balans yoki kalit limitiga sig‘masa, yuboriladigan limitni faqat unga haqiqatan rioya qiladigan model va metodda kamaytirish mumkin; bunda u 256 tokendan ham, belgilangan minimal javob hajmidan ham past bo‘lmasligi kerak. Chiqishdagi rasmlar, video va audio uchun natijaning to‘liq narxi zaxiralanadi. - Javobdan keyin — haqiqiy sarf bo‘yicha bitta yechib olish. Ishlatilmagan zaxira darhol balansga qaytariladi.
- Javob zaxiradan qimmatga tushsa, farq erkin balansdan olinadi. Balans hech qachon manfiy bo‘lmaydi.
- Pul hatto eng kichik zaxiraga ham yetmasa, so‘rov yuborilmaydi: tushunarli 402 xatosini olasiz, hech narsa yechib olinmaydi.
- Natijasiz yakunlangan xato uchun haq olinmaydi.
Tafsilotlar va hisoblash misoli quyidagi sahifada: Zaxira va yechib olish.
Request ID bilan xatolar
Har bir javobga so‘rov identifikatori beriladi: quyidagi sarlavhada X-Request-ID va xato matnida. Xatolar siz chaqirgan formatdagi JSON’da keladi, shu sababli SDK’lar ularni to‘g‘ri taniydi. Biror muammo bo‘lsa, Request ID’ni yuboring: yordam xizmatiga — shunda so‘rovni bir daqiqada topamiz.
{
"code": "API_KEY_REQUIRED",
"error": {
"code": "invalid_api_key",
"message": "No API key was sent with the request. Nothing was charged. Please check that the full key is sent in the Authorization header as \"Bearer <key>\". Request ID: 3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6.",
"param": null,
"reason": "invalid_api_key",
"request_id": "3b28d3de-5b02-4d07-9f3c-4b9a7d0e68d6",
"type": "invalid_request_error"
},
"message": "No API key was sent with the request. Nothing was charged. …"
}Oqim va taymautlar
Oqimli javoblar (stream: true) Server-Sent Events sifatida keladi. Ailoot pullik matnli javobni narx hisoblangach qaytaradi. Shuning uchun stream: true bilan format oqimli (SSE) bo‘lib qoladi, lekin matn model ishini tugatgach so‘zma-so‘z emas, bitta blokda keladi. Javob tayyorlanishi taxminan 15 soniyadan oshsa, Chat Completions, Responses va Messages oqimlarida avval xizmat satrlari keladi: : ping (taxminan har 10 soniyada), so‘ng quyidagi satr : ailoot-charged-usd … yechib olingan summa va ma’lumotlarning o‘zi bilan keladi. SDK’lar bunday satrlarni o‘tkazib yuboradi.
Gemini formatida xizmat satrlari yo‘q: javob :streamGenerateContent to‘liq hisob-kitobdan keyin keladi. Mulohaza yurituvchi modellar uchun mijoz dasturi taymautini yetarli zaxira bilan belgilang: bir necha daqiqa — odatiy holat.
Javob sarlavhalari
X-Request-ID har bir javobda keladi. Qolgan sarlavhalarni Ailoot pullik matnli javoblarga qo‘shadi:
| Sarlavha | Undagi ma’lumot |
|---|---|
X-Request-ID | So‘rov identifikatori — uni yordam xizmati so‘raydi |
X-Ailoot-Charged-USD | Bu so‘rov uchun yechib olingan summa, dollarda |
X-Ailoot-Output-Tokens | Haqi to‘langan javob tokenlari soni |
X-Ailoot-Max-Tokens-Capped | To‘liq zaxiraga balans yetmagani sababli javob uzunligi limiti kamaytirilgan qiymat |
X-Ailoot-Notice-Code, X-Ailoot-Notice | Javob uzunlik limitida to‘xtagan bo‘lsa, izoh |
Oqim xizmat satrlari bilan allaqachon boshlangan bo‘lsa, bu ma’lumotlar sarlavha sifatida emas, ma’lumotlardan oldin izoh satri sifatida keladi.
Prompt keshi
Model keshlashni qo‘llab-quvvatlasa, qayta yuborilgan uzun prefiks (tizim ko‘rsatmasi, hujjatlar) arzonroq bo‘lishi mumkin. Keshni o‘qish va yozish narxlari model kartasida ko‘rsatilgan: katalogda. Keshga tushishni model ishlab chiquvchisi belgilaydi; Ailoot buni kafolatlamaydi.