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

[Pengenalan](https://ailoot.ai/docs/ms/) 

# Kunci dan alamat API

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

Tempat mendapatkan kunci, alamat yang perlu digunakan dalam SDK berbeza dan cara menghantar kunci.

## [](https://ailoot.ai/docs/ms/keys/#key)Kunci API

Kunci dicipta dalam panel pengguna di [ailoot.ai](https://ailoot.ai) selepas [pendaftaran](https://ailoot.ai/register). Bentuknya seperti `sk-…`. Anda boleh mencipta beberapa kunci: berasingan untuk komputer kerja, pelayan dan setiap aplikasi — lebih mudah membatalkan satu kunci tanpa menyentuh yang lain.

Anda boleh menetapkan jumlah had perbelanjaan, tempoh sah, senarai IP yang dibenarkan dan disekat serta had perbelanjaan bagi tetingkap 5 jam, 1 hari dan 7 hari. Jika sekatan dicetuskan, anda menerima ralat yang jelas: `api_key_quota_exhausted` (jumlah had telah habis digunakan), `usage_limit_reached` (had perbelanjaan kunci bagi tetingkap masa telah habis digunakan — tunggu sehingga tetingkap diperbaharui atau naikkan had), `api_key_expired` atau `permission_denied` (contohnya, permintaan bukan daripada IP yang dibenarkan).

Jangan dedahkan kunci dalam kod, repositori atau tangkapan skrin. Simpannya dalam pemboleh ubah persekitaran atau pengurus rahsia. Jika kunci bocor, padamkannya dalam panel pengguna dan cipta kunci baharu.

## [](https://ailoot.ai/docs/ms/keys/#base-url)Alamat API

Peraturan utama: bagi klien yang serasi dengan OpenAI, alamat dengan `/v1`, bagi Anthropic dan Gemini — tanpanya.

| Klien | Alamat asas | Destinasi permintaan |
| --- | --- | --- |
| OpenAI SDK dan klien yang serasi | `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` |
| Klien meminta alamat penuh | `https://api.ailoot.ai/v1/chat/completions` | seperti yang dinyatakan |

Menerima 404 sejurus selepas konfigurasi? Hampir selalu berpunca daripada alamat: terdapat lebihan atau kekurangan `/v1`, garis condong berganda atau `/chat/completions` apabila klien menambahkannya sendiri.

## [](https://ailoot.ai/docs/ms/keys/#auth)Cara menghantar kunci

Ailoot menerima kunci dalam mana-mana daripada tiga pengepala — gunakan pengepala yang dihantar oleh SDK anda:

| Pengepala | Penggunanya |
| --- | --- |
| `Authorization: Bearer sk-…` | OpenAI SDK, kebanyakan klien |
| `x-api-key: sk-…` | Anthropic SDK, Claude Code dengan ANTHROPIC\_API\_KEY |
| `x-goog-api-key: sk-…` | Google GenAI SDK, Gemini CLI |

Pada laluan `/v1/…` kunci dalam alamat (`?key=` atau `?api_key=`) tidak diterima: permintaan menerima 400 dengan kod `invalid_request` dan mesej bahawa kunci dihantar dalam alamat. Dengan cara ini, kunci tidak masuk ke dalam log atau sejarah pelayar. Jika kunci pernah dimasukkan dalam alamat, sebaiknya cipta kunci baharu.

Pada laluan Gemini `/v1beta/…` untuk keserasian dengan Google, bentuk berikut diterima `?key=` — dengan keutamaan paling rendah, selepas pengepala. `?api_key=` juga ditolak dengan 400 di situ. Walau bagaimanapun, lebih andal menghantar kunci dalam pengepala `x-goog-api-key`.

## [](https://ailoot.ai/docs/ms/keys/#env)Pemboleh ubah persekitaran

Lebih mudah mencipta satu pemboleh ubah dan menggunakannya dalam tetapan pelbagai program:

```bash
# ~/.zshrc atau ~/.bashrc
export AILOOT_API_KEY="sk-..."

# untuk program yang membaca nama standard
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-..."

# untuk program yang membaca nama standard
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-..."
# mulakan semula terminal supaya pemboleh ubah dimuatkan
```

## [](https://ailoot.ai/docs/ms/keys/#check)Semakan kunci

Cara paling murah untuk menyemak kunci ialah meminta senarai model: ini percuma.

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

Masih ada soalan? Hantar Request ID dan penerangannya — kami akan membantu menyiasatnya.[Hubungi sokongan](mailto:support@ailoot.ai)

## Ailoot · Syarikat dan portfolio projeknya





Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.





Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.





Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.