Kunci dan alamat API
MarkdownTempat mendapatkan kunci, alamat untuk berbagai SDK, dan cara mengirim kunci.
Panduan lengkap
Kunci API
Kunci dibuat dalam dasbor di ailoot.ai setelah pendaftaran. Bentuknya seperti sk-…. Anda dapat membuat beberapa kunci: untuk komputer kerja, server, dan setiap aplikasi secara terpisah — agar satu kunci mudah dicabut tanpa memengaruhi lainnya.
Kunci dapat memiliki batas pengeluaran total, masa berlaku, daftar IP yang diizinkan dan diblokir, serta batas pengeluaran per jendela 5 jam, 1 hari, dan 7 hari. Jika batasan berlaku, kesalahan yang jelas dikembalikan: api_key_quota_exhausted (batas total habis), usage_limit_reached (batas pengeluaran kunci per jendela habis — tunggu hingga diperbarui atau naikkan batas), api_key_expired atau permission_denied (misalnya, permintaan bukan dari IP yang diizinkan).
Alamat API
Aturan utama: alamat untuk klien yang kompatibel dengan OpenAI menggunakan /v1, untuk Anthropic dan Gemini — tanpa sufiks tersebut.
| Klien | Alamat dasar | Tujuan permintaan |
|---|---|---|
| OpenAI SDK dan klien yang kompatibel | 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 lengkap | https://api.ailoot.ai/v1/chat/completions | sesuai yang ditentukan |
Cara mengirim kunci
Ailoot menerima kunci dalam salah satu dari tiga header — header yang dikirim SDK Anda dapat digunakan:
| Header | Yang mengirimnya |
|---|---|
Authorization: Bearer sk-… | OpenAI SDK, sebagian besar klien |
x-api-key: sk-… | Anthropic SDK, Claude Code dengan ANTHROPIC_API_KEY |
x-goog-api-key: sk-… | Google GenAI SDK, Gemini CLI |
Pada jalur /v1/… kunci dalam alamat (?key= atau ?api_key=) tidak diterima: permintaan mendapat 400 dengan kode invalid_request dan pesan bahwa kunci dikirim dalam alamat. Dengan demikian, kunci tidak masuk ke log atau riwayat browser. Jika kunci sudah pernah digunakan dalam alamat, sebaiknya buat kunci baru.
Pada jalur Gemini /v1beta/… untuk kompatibilitas dengan Google, diterima ?key= — dengan prioritas terendah, setelah header. ?api_key= juga ditolak dengan 400 di sana. Tetap lebih andal mengirim kunci melalui header x-goog-api-key.
Variabel lingkungan
Praktis membuat satu variabel dan menggunakannya dalam pengaturan berbagai aplikasi:
# ~/.zshrc atau ~/.bashrc
export AILOOT_API_KEY="sk-..."
# untuk program yang membaca nama variabel standar
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 variabel standar
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-..."
# mulai ulang terminal agar variabel terbacaPemeriksaan kunci
Cara paling hemat untuk memeriksa kunci adalah meminta daftar model: gratis.
curl -s https://api.ailoot.ai/v1/models \
-H "Authorization: Bearer $AILOOT_API_KEY"