Penguji Kunci API AI: Verifikasi Kunci dalam 30 Detik

Mengapa menguji secara lokal bukan di halaman web

Mencari penguji kunci API AI menghasilkan banyak halaman tempat Anda menempelkan kunci dan menekan tombol. Hindari mereka. Kunci adalah kata sandi yang menghabiskan uang Anda, dan Anda tidak tahu apa yang dilakukan halaman tersebut dengan kunci tersebut. Pengujian di bawah ini memakan waktu setengah menit, berjalan di mesin Anda sendiri, dan mengirimkan kunci hanya ke API yang ingin Anda gunakan.

Anda membutuhkan tiga hal: kunci, base URL https://api.getaiapikey.com/v1, dan model ID uncensored. Masukkan kunci ke variabel lingkungan agar tidak masuk ke riwayat shell atau file yang mungkin Anda commit.

Copyexport API_KEY="paste-your-key-here"

Kunci berasal dari halaman kunci API. Jika Anda belum memilikinya, pengguna baru dapat mengklaim kredit uji coba senilai $0,50 di sana dengan satu klik setelah masuk, yang sudah cukup untuk setiap pengujian dalam artikel ini berkali-kali.

Pemeriksaan 1: daftar model dengan curl

Pengujian termurah adalah daftar model. Ini memerlukan kunci valid dan base URL yang benar, dan tidak menghasilkan teks apa pun.

Copycurl -i https://api.getaiapikey.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

Flag -i mencetak header respons. Jawaban yang sehat dimulai dengan HTTP/2 200 dan body JSON yang menyertakan ID model uncensored. Jika Anda melihat kesalahan autentikasi, biasanya status 401, kuncinya salah, disalin dengan spasi di akhir, atau header tidak menyertakan kata Bearer. Status 404 berarti URL salah, biasanya karena /v1 hilang atau ganda.

Pemeriksaan 2: jalankan satu completion nyata

Kunci bisa valid dan tetap gagal pada permintaan nyata, misalnya karena saldo kosong. Jadi kirimkan panggilan chat kecil dan batasi output untuk menjaga biaya mendekati nol:

Copycurl -i https://api.getaiapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","max_tokens":5,"messages":[{"role":"user","content":"Say ok."}]}'

Baca header sebelum body. X-Request-Id mengidentifikasi panggilan, yang merupakan hal yang diminta oleh dukungan. X-Balance-USD menunjukkan sisa kredit. X-RateLimit-Limit-Requests dan X-RateLimit-Limit-Concurrency mengungkap batas kunci Anda: 300 dan 8 untuk kunci penuh, 60 dan 2 untuk kunci uji coba. Panggilan tersebut oleh karena itu memeriksa autentikasi, model, saldo, dan jenis kunci.

Biaya pengujian dapat diabaikan. Prompt sekitar 10 token dan balasan 5 token menghabiskan 10 x $0,15 / 1M + 5 x $0,50 / 1M, yaitu sekitar $0,000004. Permintaan yang gagal atau ditolak tidak dikenakan biaya sama sekali.

Pemeriksaan 3: pengujian yang sama dalam Python

Jika kode asli Anda menggunakan Python, ujilah seperti cara kode akan berjalan. Skrip ini menggunakan paket openai resmi, jadi keberhasilan di sini berarti pengaturan aplikasi Anda juga berfungsi:

Copyimport os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.getaiapikey.com/v1",
    api_key=os.environ["API_KEY"],
)

raw = client.chat.completions.with_raw_response.create(
    model="uncensored",
    max_tokens=5,
    messages=[{"role": "user", "content": "Say ok."}],
)
print("status:", raw.status_code)
print("balance:", raw.headers.get("X-Balance-USD"))
print("req/min limit:", raw.headers.get("X-RateLimit-Limit-Requests"))
print("concurrency limit:", raw.headers.get("X-RateLimit-Limit-Concurrency"))
print("reply:", raw.parse().choices[0].message.content)

Wrapper with_raw_response memberikan akses ke header sementara parse() mengembalikan objek respons biasa. Penyiapan Python sendiri dibahas di cara menginstal klien LLM di Python jika impor gagal.

Periksa saldo Anda tanpa completion

Untuk membaca saldo tanpa menghasilkan teks, panggil salah satu endpoint saldo. Ada yang bergaya OpenAI dan yang pendek:

Copycurl https://api.getaiapikey.com/v1/balance \
  -H "Authorization: Bearer $API_KEY"

curl https://api.getaiapikey.com/v1/dashboard/billing/credit_grants \
  -H "Authorization: Bearer $API_KEY"

Alat yang sudah mengharapkan format pemberian kredit OpenAI dapat menggunakan jalur kedua tanpa perubahan. Tambahkan panggilan seperti ini ke skrip pemantauan dan Anda akan mendapatkan peringatan sebelum bot produksi kehabisan. Top-up dimulai dari $20 dan kredit tidak pernah kedaluwarsa, sehingga tidak ada penalti untuk menyimpan cadangan yang nyaman. Jumlah dan bonus ada di halaman harga.

Ubah pengujian menjadi pemeriksaan kesehatan

Setelah kunci berfungsi, simpan pengujian tersebut. Skrip kecil yang berjalan secara berkala memberi tahu Anda tentang deployment yang buruk, secret yang kedaluwarsa, atau saldo rendah sebelum pengguna Anda menyadarinya. Berikut adalah versi Node menggunakan fetch bawaan (Node 18 atau lebih baru):

Copyconst base = "https://api.getaiapikey.com/v1";

async function check() {
  const res = await fetch(`${base}/chat/completions`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "uncensored",
      max_tokens: 5,
      messages: [{ role: "user", content: "Say ok." }],
    }),
  });
  const balance = Number(res.headers.get("X-Balance-USD"));
  console.log(res.status, "balance:", balance);
  if (res.status >= 400 || balance < 5) process.exitCode = 1;
}

check();

Skrip keluar dengan kode non-nol ketika panggilan gagal atau saldo turun di bawah $5, sehingga cron job atau langkah CI dapat memberi Anda peringatan. Pilih ambang batas dari laju pengeluaran Anda sendiri: pada $2 sehari, $5 memberi Anda peringatan lebih dari dua hari.

Apa yang dibuktikan oleh pengujian yang lulus

Centang hijau menunjukkan bahwa autentikasi, routing, dan model berfungsi pada saat itu, dengan beban rendah. Hal ini tidak menunjukkan bagaimana aplikasi Anda berperilaku dengan 20 pengguna secara bersamaan. Untuk itu, ingat batasnya: kunci penuh menjalankan 8 permintaan secara bersamaan, dan permintaan streaming mempertahankan slotnya hingga streaming berakhir. Uji beban kode Anda sendiri dengan batas panggilan paralel sebelum peluncuran.

Membaca kegagalan

Yang Anda lihat	Kemungkinan alasan terbesar	Apa yang harus dilakukan
Kesalahan autentikasi, sering 401	Kunci salah, spasi ekstra, tanpa awalan Bearer	Salin ulang kunci, periksa string header
404 atau HTML bukan JSON	Base URL salah	Gunakan tepat https://api.getaiapikey.com/v1
Model tidak ditemukan	Model ID berbeda dalam permintaan	Atur model menjadi uncensored
429 dengan rate_limited atau concurrency	Terlalu banyak permintaan per menit atau sekaligus	Tunggu, lalu coba lagi dengan jeda
429 dengan Retry-After: 5	Beban berlebih sementara	Tunggu 5 detik dan coba lagi
Kesalahan koneksi atau timeout	Jaringan, proxy, atau firewall	Uji dari jaringan lain, periksa variabel proxy

Permintaan di atas 8 MB ditolak, jadi jika hanya panggilan besar yang gagal, periksa ukuran body. dokumentasi mencantumkan semua kode kesalahan dan header.

Kebiasaan baik untuk menangani kunci

• Simpan kunci di variabel lingkungan atau tempat penyimpanan rahasia, jangan pernah di kode sisi klien, repositori publik, atau screenshot.
• Gunakan satu kunci per aplikasi jika memungkinkan, sehingga kebocoran mudah dilacak dan diganti.
• Jika kunci mungkin telah bocor, ganti, lalu periksa saldo untuk pengeluaran yang tidak terduga.
• Jangan bagikan kunci uji coba di antara beberapa program: dengan 2 permintaan bersamaan, kunci tersebut akan mencapai batas dengan cepat.

Jika Anda hanya ingin melihat apakah opsi gratis ada sebelum Anda mendaftar, artikel tentang kunci API LLM gratis menjelaskan apa yang tersedia. Jika tidak, tiga pemeriksaan di atas adalah semua pengujian yang dibutuhkan kunci.

Panduan lainnya

• Harga Kunci API AI: Berapa Biaya Satu Kunci Sebenarnya
• Daftar Periksa API AI