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:

  1. Buka Dashboard → Playground.
  2. Tempel API key Anda di kolom API Key Anda (jika baru membuat key, key Anda otomatis terisi).
  3. 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.
  4. 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 $body

Cara 3: Uji Menggunakan Python (OpenAI SDK)

Karena STRIX AI 100% kompatibel dengan format OpenAI API, Anda dapat menggunakan pustaka openai standar.

pip install openai

Buat 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 openai

Buat 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 StatusArtiPenyebab & Solusi
401 UnauthorizedInvalid API KeyKey salah, terpotong, atau telah dicabut di dashboard. Pastikan header Authorization: Bearer sk-strix-... ditulis lengkap tanpa spasi ekstra.
402 Payment RequiredInsufficient CreditsSaldo kredit akun Anda tidak mencukupi untuk memproses token permintaan. Lakukan isi ulang di menu Billing.
404 Not FoundModel Not FoundID model yang Anda panggil tidak terdaftar atau sedang tidak aktif. Periksa daftar model valid di Katalog Model atau panggil GET /v1/models.
502 Bad GatewayUpstream ErrorPenyedia 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.