Kunci dan alamat API
MarkdownTempat mendapatkan kunci, alamat yang perlu digunakan dalam SDK berbeza dan cara menghantar kunci.
Panduan lengkap
Kunci API
Kunci dicipta dalam panel pengguna di ailoot.ai selepas pendaftaran. 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).
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 |
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.
Pemboleh ubah persekitaran
Lebih mudah mencipta satu pemboleh ubah dan menggunakannya dalam tetapan pelbagai program:
# ~/.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"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 dimuatkanSemakan kunci
Cara paling murah untuk menyemak kunci ialah meminta senarai model: ini percuma.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"