Кілттер және API мекенжайы
MarkdownКілтті қайдан алу, әртүрлі SDK-да қандай мекенжай көрсету және кілтті қалай жіберу керек.
Толық нұсқаулық
API кілті
Кілт жеке кабинетте мына сайтта жасалады: ailoot.ai — алдымен тіркеліңіз. Оның пішімі мынадай: sk-…. Бірнеше кілт жасауға болады: жұмыс компьютеріне, серверге және әр қолданбаға бөлек — сонда қалғанын қозғамай, біреуін қайтарып алу оңайырақ.
Кілтке жалпы шығын лимитін, жарамдылық мерзімін, IP мекенжайларының ақ және қара тізімдерін, сондай-ақ 5 сағат, 1 күн және 7 күн аралықтарындағы шығын лимиттерін беруге болады. Шектеу іске қосылса, түсінікті қате келеді: api_key_quota_exhausted (жалпы лимит біткен), usage_limit_reached (кілттің шығын аралығы біткен — аралық жаңарғанша күтіңіз немесе лимитті арттырыңыз), api_key_expired немесе permission_denied (мысалы, сұрау рұқсат етілген IP-ден емес).
API мекенжайы
Негізгі ереже: OpenAI-мен үйлесімді клиенттер үшін мекенжай мына бөлікпен: /v1, Anthropic және Gemini үшін — онсыз.
| Клиент | Базалық мекенжай | Сұрау қайда жіберіледі |
|---|---|---|
| OpenAI SDK және үйлесімді клиенттер | 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 |
| Клиент толық мекенжай сұрайды | https://api.ailoot.ai/v1/chat/completions | көрсетілгендей |
Кілтті қалай жіберу керек
Ailoot кілтті үш тақырыптың кез келгенінде қабылдайды — SDK қайсысын жіберсе, сол жарайды:
| Тақырып | Кім осылай жібереді |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, клиенттердің көбі |
x-api-key: sk-… | Anthropic SDK, ANTHROPIC_API_KEY бар Claude Code |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Мына жолдарда: /v1/… мекенжайдағы кілт (?key= немесе ?api_key=) қабылданбайды: сұрау 400 кодын, мына қате кодын алады: invalid_request және кілттің мекенжайда берілгені туралы хабарламаны алады. Сонда кілт журналдар мен браузер тарихына түспейді. Кілт мекенжайда қолданылып қойған болса, жаңасын жасаған дұрыс.
Gemini жолдарында /v1beta/… Google-мен үйлесімділік үшін мына нұсқа қабылданады: ?key= — тақырыптардан кейін, ең төмен басымдықпен. ?api_key= мұнда да 400 кодымен қабылданбайды. Дегенмен кілтті мына тақырыпта жіберу сенімдірек: x-goog-api-key.
Орта айнымалылары
Бір айнымалы жасап, оны әртүрлі бағдарлама баптауына қою ыңғайлы:
# ~/.zshrc немесе ~/.bashrc
export AILOOT_API_KEY="sk-..."
# стандартты атауларды оқитын бағдарламалар үшін
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-..."
# стандартты атауларды оқитын бағдарламалар үшін
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-..."
# айнымалылар қолданылуы үшін терминалды қайта іске қосыңызКілтті тексеру
Кілтті тексерудің ең арзан тәсілі — модельдер тізімін сұрау: бұл тегін.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"