Source: https://ailoot.ai/docs/kk/keys/
Canonical: https://ailoot.ai/docs/kk/keys/
Language: kk

[Бастау](https://ailoot.ai/docs/kk/) 

# Кілттер және API мекенжайы

[Markdown](https://ailoot.ai/docs/kk/keys/index.md)

Кілтті қайдан алу, әртүрлі SDK-да қандай мекенжай көрсету және кілтті қалай жіберу керек.

## [](https://ailoot.ai/docs/kk/keys/#key)API кілті

Кілт жеке кабинетте мына сайтта жасалады: [ailoot.ai](https://ailoot.ai) — алдымен [тіркеліңіз](https://ailoot.ai/register). Оның пішімі мынадай: `sk-…`. Бірнеше кілт жасауға болады: жұмыс компьютеріне, серверге және әр қолданбаға бөлек — сонда қалғанын қозғамай, біреуін қайтарып алу оңайырақ.

Кілтке жалпы шығын лимитін, жарамдылық мерзімін, IP мекенжайларының ақ және қара тізімдерін, сондай-ақ 5 сағат, 1 күн және 7 күн аралықтарындағы шығын лимиттерін беруге болады. Шектеу іске қосылса, түсінікті қате келеді: `api_key_quota_exhausted` (жалпы лимит біткен), `usage_limit_reached` (кілттің шығын аралығы біткен — аралық жаңарғанша күтіңіз немесе лимитті арттырыңыз), `api_key_expired` немесе `permission_denied` (мысалы, сұрау рұқсат етілген IP-ден емес).

Кілтті кодта, репозиторийлерде және скриншоттарда жарияламаңыз. Оны орта айнымалысында немесе құпиялар менеджерінде сақтаңыз. Кілт жария болып кетсе — жеке кабинеттен жойып, жаңасын жасаңыз.

## [](https://ailoot.ai/docs/kk/keys/#base-url)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` | көрсетілгендей |

Баптаудан кейін бірден 404 алдыңыз ба? Әрдайым дерлік мәселе мекенжайда: артық немесе жетіспейтін `/v1`, қос қиғаш сызық немесе `/chat/completions` клиент оны өзі қосатын жерде.

## [](https://ailoot.ai/docs/kk/keys/#auth)Кілтті қалай жіберу керек

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`.

## [](https://ailoot.ai/docs/kk/keys/#env)Орта айнымалылары

Бір айнымалы жасап, оны әртүрлі бағдарлама баптауына қою ыңғайлы:

```bash
# ~/.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"
```

```powershell
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-..."
# айнымалылар қолданылуы үшін терминалды қайта іске қосыңыз
```

## [](https://ailoot.ai/docs/kk/keys/#check)Кілтті тексеру

Кілтті тексерудің ең арзан тәсілі — модельдер тізімін сұрау: бұл тегін.

```bash
curl -s https://api.ailoot.ai/v1/models \
  -H "Authorization: Bearer $AILOOT_API_KEY"
```

Сұрақтарыңыз қалды ма? Request ID мен сипаттаманы жіберіңіз — мәселені анықтауға көмектесеміз.[Қолдау қызметіне жазу](mailto:support@ailoot.ai)

## Ailoot · Компания және оның жобалар портфелі





Ailoot жинақталған жұмыс тәжірибесіне, кең клиенттік базаға, тұрақты қызметке және KPI көрсеткіштерін үздіксіз бақылауға сүйенеді.





Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.





Ailoot осы тәжірибені клиенттердің өнімдерінде, агенттерінде, қолданбаларында және автоматтандыруларында жасанды интеллект мүмкіндіктеріне API арқылы қол жеткізуді қамтамасыз етуге пайдаланады.