Menguji API Key
Panduan langkah demi langkah untuk memverifikasi apakah API key STRIX AI Anda aktif, terhubung dengan benar, dan siap digunakan di aplikasi Anda.
⚠️ PENTING: Base URL yang Benar
STRIX AI beroperasi sebagai API Gateway. API key Anda (yang berawalan sk-strix-...) adalah kunci otentikasi untuk server STRIX AI, bukan untuk BandelAI atau upstream lainnya.
- ✅ Base URL yang Benar:
https://strix-ai.my.id/v1 - ❌ Base URL yang Salah:
https://bandelbanget.xyz/v1(Koneksi ke upstream ditangani secara internal oleh server STRIX AI).
Cara 1: Uji Interaktif via Dashboard Playground (Rekomendasi)
Cara termudah untuk menguji key tanpa koding adalah melalui Dashboard Playground atau langsung di menu API Keys:
- Buka Dashboard → Playground.
- Tempel API key Anda di kolom API Key Anda (jika baru membuat key, key Anda otomatis terisi).
- Klik tombol Tes Validitas. Sistem akan mengirim permintaan
GET /v1/models. Jika berhasil, Anda akan melihat badge hijau "Key Valid & Aktif" beserta daftar model yang tersedia. - Pilih model dan klik Kirim Permintaan untuk mencoba respons chat langsung dari model AI.
Cara 2: Uji Menggunakan cURL (Terminal / Command Prompt)
Buka terminal Anda (Git Bash, macOS/Linux Terminal, atau WSL) dan jalankan perintah berikut:
Langkah A: Tes Validasi Key & Daftar Model
curl https://strix-ai.my.id/v1/models \
-H "Authorization: Bearer sk-strix-xxxxxxxxxxxxxxxx"Jika key valid, Anda akan menerima respons HTTP 200 berupa daftar model JSON:
{
"object": "list",
"data": [
{ "id": "gpt-4o-mini", "object": "model", "owned_by": "openai" },
{ "id": "qwen/qwen3-235b-a22b", "object": "model", "owned_by": "bandelai" }
]
}Langkah B: Tes Chat Completion
curl https://strix-ai.my.id/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-strix-xxxxxxxxxxxxxxxx" \
-d '{
"model": "gpt-4o-mini",
"messages": [
{ "role": "user", "content": "Halo! Jawab dengan satu kalimat." }
]
}'Untuk Pengguna Windows PowerShell
Jika Anda menggunakan PowerShell di Windows, gunakan skrip berikut:
$headers = @{
"Authorization" = "Bearer sk-strix-xxxxxxxxxxxxxxxx"
"Content-Type" = "application/json"
}
$body = @{
model = "gpt-4o-mini"
messages = @(
@{ role = "user"; content = "Halo, ini tes dari PowerShell!" }
)
} | ConvertTo-Json
Invoke-RestMethod -Uri "https://strix-ai.my.id/v1/chat/completions" -Method Post -Headers $headers -Body $bodyCara 3: Uji Menggunakan Python (OpenAI SDK)
Karena STRIX AI 100% kompatibel dengan format OpenAI API, Anda dapat menggunakan pustaka openai standar.
pip install openaiBuat file test_strix.py:
import os
from openai import OpenAI
# Arahkan base_url ke endpoint STRIX AI
client = OpenAI(
base_url="https://strix-ai.my.id/v1",
api_key="sk-strix-xxxxxxxxxxxxxxxx",
)
try:
response = client.chat.completions.create(
model="gpt-4o-mini",
messages=[
{"role": "user", "content": "Halo, tes koneksi API STRIX!"}
],
)
print("Respons AI:")
print(response.choices[0].message.content)
except Exception as e:
print(f"Terjadi kesalahan: {e}")Cara 4: Uji Menggunakan Node.js / TypeScript
npm install openaiBuat file test_strix.js:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://strix-ai.my.id/v1",
apiKey: "sk-strix-xxxxxxxxxxxxxxxx",
});
async function runTest() {
try {
const completion = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "Halo dari Node.js!" }],
});
console.log("Respons AI:");
console.log(completion.choices[0].message.content);
} catch (err) {
console.error("Error:", err.message);
}
}
runTest();Panduan Mengatasi Masalah (Troubleshooting)
Jika pengujian Anda menghasilkan error, berikut adalah arti kode status dan solusinya:
| Kode Status | Arti | Penyebab & Solusi |
|---|---|---|
| 401 Unauthorized | Invalid API Key | Key salah, terpotong, atau telah dicabut di dashboard. Pastikan header Authorization: Bearer sk-strix-... ditulis lengkap tanpa spasi ekstra. |
| 402 Payment Required | Insufficient Credits | Saldo kredit akun Anda tidak mencukupi untuk memproses token permintaan. Lakukan isi ulang di menu Billing. |
| 404 Not Found | Model Not Found | ID model yang Anda panggil tidak terdaftar atau sedang tidak aktif. Periksa daftar model valid di Katalog Model atau panggil GET /v1/models. |
| 502 Bad Gateway | Upstream Error | Penyedia AI upstream sedang mengalami gangguan atau mengembalikan respons tidak relevan. Kredit Anda tidak dipotong pada kondisi ini. Silakan coba beberapa saat lagi. |
Butuh Bantuan Lebih Lanjut?
Jika Anda masih mengalami kendala dalam menghubungkan API key, Anda dapat membuka tiket bantuan atau hubungi tim pengembang kami di support@strix-ai.my.id.
