API Key
Semua permintaan API AI Sonar memerlukan API key.
Untuk endpoint yang kompatibel dengan OpenAI, kirim sebagai:
Authorization: Bearer sk-your-api-key
/v1/messages yang kompatibel dengan Anthropic, Anda juga dapat menggunakan:
x-api-key: sk-your-api-key
Mendapatkan API Key Anda
- Masuk ke AI Sonar Dashboard Anda
- Buka API Keys
- Buat key baru
- Beri nama yang deskriptif
- Salin segera karena hanya ditampilkan satu kali
- Jangan pernah mengekspos API key dalam kode sisi klien
- Jangan pernah melakukan commit API key ke version control
- Gunakan environment variables atau secret manager
- Rotasi key secara berkala
- Hapus key yang tidak digunakan
Menggunakan API Key
curl https://api.aisonar.dev/v1/responses \
-H "Authorization: Bearer $TOKENLAB_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-5.4",
"input": "Hello!"
}'
Fitur API Key
Batas Penggunaan
Anda dapat menetapkan batas penggunaan pada setiap API key:
| Pengaturan | Deskripsi |
|---|
| No Limit | Key menggunakan saldo akun Anda tanpa batasan |
| Fixed Limit | Key berhenti berfungsi setelah mencapai jumlah yang ditentukan |
Prefix Key
Semua API key AI Sonar diawali dengan sk-.
Kompatibilitas Anthropic
Untuk endpoint /v1/messages, header bergaya Anthropic berfungsi sebagaimana mestinya:
curl https://api.aisonar.dev/v1/messages \
-H "x-api-key: sk-your-api-key" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{
"model": "claude-sonnet-4-6",
"max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello!"}]
}'
Gunakan Authorization: Bearer ... untuk endpoint yang kompatibel dengan OpenAI seperti /v1/responses, /v1/chat/completions, /v1/models, dan sebagian besar route AI Sonar lainnya.
Respons Error
| Kode Status | Tipe | Kode | Deskripsi |
|---|
| 401 | invalid_api_key | invalid_api_key | API key tidak ada atau tidak valid |
| 401 | expired_api_key | expired_api_key | API key telah dicabut |
| 402 | insufficient_balance | insufficient_balance | Saldo akun tidak mencukupi |
| 402 | quota_exceeded | quota_exceeded | Batas penggunaan API key tercapai |
{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key",
"code": "invalid_api_key"
}
}
