Cara Menguji Kunci API AI Dengan curl dan Python

Berikut cara Anda menguji akses kunci API tanpa membangun apa pun: tiga panggilan, sekitar dua menit, dan Anda akan mengetahui apakah kunci tersebut valid, memiliki dana, dan diizinkan untuk menghasilkan teks.
Poin utama
- Panggil GET /v1/models terlebih dahulu: ini membuktikan kunci diterima tanpa menghabiskan kredit.
- Kirim satu permintaan obrolan singkat ke model uncensored untuk mengkonfirmasi bahwa generasi berfungsi.
- Baca header X-Balance-USD atau GET /v1/balance untuk melihat sisa saldo.
- 401 menunjuk ke kunci, 402 ke saldo, 429 ke laju permintaan Anda.
Uji tiga panggilan
Untuk menguji kunci API AI dengan benar, Anda perlu membuktikan tiga hal terpisah: server menerima kunci, kunci memiliki saldo di belakangnya, dan penyelesaian nyata kembali. Satu panggilan per pertanyaan menjaga diagnosis tetap sederhana. Jika sesuatu gagal, Anda tahu lapisan mana yang menjadi kesalahan.
- Daftar model. Mengautentikasi kunci dan tidak memakan biaya.
- Penyelesaian obrolan. Mengkonfirmasi bahwa model menjawab dan format permintaan Anda benar.
- Saldo. Mengkonfirmasi sisa saldo setelah pengujian.
Semua di bawah ini menggunakan base URL https://api.aiapisource.com/v1 dan ID model uncensored. Masukkan kunci Anda ke dalam variabel lingkungan agar tidak berakhir di riwayat shell atau repositori Anda.
export AIAPI_KEY="paste-your-key-here"
Jika Anda belum memiliki kunci, halaman kunci API menunjukkan cara membuatnya. Akun baru dapat mengklaim kredit uji coba $0,50 di sana dengan satu klik, yang lebih dari cukup untuk setiap pengujian dalam artikel ini.
Langkah 1: daftar model dengan curl
Pemeriksaan termurah adalah permintaan baca-saja. GET /v1/models mengembalikan daftar model dan memerlukan kunci yang valid, sehingga jawaban yang sukses membuktikan autentikasi.
curl -s https://api.aiapisource.com/v1/models \
-H "Authorization: Bearer $AIAPI_KEY"
Respons yang sehat adalah JSON dengan array data yang mencakup uncensored. Jika Anda melihat halaman HTML, kesalahan koneksi, atau respons kosong, masalahnya adalah URL, bukan kunci. Periksa apakah Anda mempertahankan suffix /v1 dan bahwa tidak ada spasi trailing setelah kunci di variabel Anda.
Tambahkan -i ke perintah curl untuk melihat header respons. API mengirim X-Request-Id pada setiap panggilan. Simpan nilai tersebut jika Anda menghubungi dukungan, karena itu mengidentifikasi permintaan yang tepat.
Langkah 2: kirim satu permintaan obrolan
Sekarang periksa generasi. Pertahankan prompt kecil dan batasi output agar pengujian memakan biaya sepersekian sen.
curl -s https://api.aiapisource.com/v1/chat/completions \
-H "Authorization: Bearer $AIAPI_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Reply with the single word: ready"}],
"max_tokens": 10
}'
Cari choices[0].message.content dan objek usage dengan prompt_tokens dan completion_tokens. Permintaan sekitar 20 token input dan 5 token output biayanya 20 / 1.000.000 x $0,15 ditambah 5 / 1.000.000 x $0,50, yaitu sekitar $0,0000055. Anda dapat menjalankan seratus dari ini dengan biaya jauh di bawah satu sen.
Endpoint yang sama juga berfungsi untuk streaming: tambahkan "stream": true dan token tiba sebagai acara yang dikirim server. Uji secara terpisah setelah panggilan dasar berfungsi.
Langkah 3: uji yang sama di Python
Jika kode asli Anda menggunakan SDK OpenAI, uji melalui SDK juga. SDK menangkap masalah yang tidak akan ditangkap curl, seperti base URL yang diteruskan ke argumen yang salah.
import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["AIAPI_KEY"],
base_url="https://api.aiapisource.com/v1",
)
print([m.id for m in client.models.list().data])
r = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Reply with the single word: ready"}],
max_tokens=10,
)
print(r.choices[0].message.content)
print(r.usage)
Cetak pertama harus menampilkan daftar yang berisi uncensored. Cetak kedua menunjukkan balasan model. Untuk panduan lebih panjang tentang pengaturan SDK, lihat panduan Python API OpenAI di situs ini.
Jalankan versi Python dari shell yang sama tempat Anda mengekspor kunci. Jika itu menaikkan KeyError pada AIAPI_KEY, variabel tidak diatur di sesi itu, yang merupakan alasan paling umum pengujian gagal sebelum mencapai jaringan.
Node bekerja dengan cara yang sama: teruskan baseURL: "https://api.aiapisource.com/v1" dan kunci ke konstruktor klien OpenAI.
Periksa saldo
Kunci bisa valid dan masih tidak memiliki apa pun untuk dibelanjakan. Dua cara untuk membaca saldo:
curl -s https://api.aiapisource.com/v1/balance \
-H "Authorization: Bearer $AIAPI_KEY"
# OpenAI-style alternative
curl -s https://api.aiapisource.com/v1/dashboard/billing/credit_grants \
-H "Authorization: Bearer $AIAPI_KEY"
Setiap respons juga membawa header X-Balance-USD, sehingga panggilan obrolan dari langkah 2 sudah memberi tahu Anda saldo yang tersisa jika Anda menjalankannya dengan -i. Di Python, SDK OpenAI mengekspos ini melalui client.chat.completions.with_raw_response.create(...), di mana Anda membaca response.headers["X-Balance-USD"].
Permintaan yang gagal atau ditolak tidak dikenakan biaya, sehingga pengujian yang error tidak menghabiskan saldo. Kredit prabayar tidak kedaluwarsa, yang berarti saldo yang belum digunakan akan tetap ada minggu depan.
Membaca kode kesalahan
Ketika pengujian gagal, status HTTP dengan cepat mempersempit kemungkinan penyebabnya.
| Kode | Makna umum | Apa yang harus dilakukan |
|---|---|---|
| 401 | Kunci hilang, salah ketik, atau dicabut | Periksa header Authorization: Bearer, salin kunci lagi, cari spasi tersembunyi atau tanda kutip |
| 402 | Tidak ada saldo tersisa untuk membayar permintaan | Baca saldo, lalu isi saldo di halaman harga |
| 404 | Jalur salah atau ID model salah | Gunakan /v1/chat/completions dan model uncensored |
| 429 | Batas laju atau batas konkurensi, atau kelebihan beban singkat | Tunggu dan coba lagi; lihat di bawah |
429 membawa kode kesalahan. rate_limited berarti terlalu banyak permintaan per menit dan concurrency berarti terlalu banyak sekaligus. Kunci penuh mengizinkan 300 permintaan per menit dan 8 permintaan konkuren; kunci uji coba mengizinkan 60 per menit dan 2 sekaligus. Saat kelebihan beban sementara, API menjawab 429 dengan Retry-After: 5, jadi tunggu lima detik dan kirim permintaan lagi. Permintaan streaming memegang slot konkurensinya hingga proses streaming selesai, yang merupakan alasan umum kunci uji coba memicu batas selama pengujian paralel.
Kode status 401, 402 dan 404 mengikuti konvensi API normal, sehingga perlakukan tabel sebagai tebakan pertama dan baca tubuh kesalahan JSON untuk pesan yang tepat.
Skrip uji asap yang dapat digunakan kembali
Setelah pengujian manual berhasil, simpan skrip yang dapat Anda jalankan setelah memutar kunci atau mengubah lingkungan.
import os, sys
import requests
BASE = "https://api.aiapisource.com/v1"
H = {"Authorization": "Bearer " + os.environ["AIAPI_KEY"]}
m = requests.get(BASE + "/models", headers=H, timeout=15)
print("models", m.status_code)
c = requests.post(
BASE + "/chat/completions",
headers=H,
json={"model": "uncensored",
"messages": [{"role": "user", "content": "ping"}],
"max_tokens": 5},
timeout=60,
)
print("chat", c.status_code, "balance", c.headers.get("X-Balance-USD"))
sys.exit(0 if m.ok and c.ok else 1)
Kode keluar memudahkan Anda untuk masuk ke pemeriksaan deployment. Untuk parameter di luar minimum ini, dokumentasi API mencantumkan semua yang diterima endpoint.
Panduan lainnya
Tanya jawab
Apakah pengujian kunci API memerlukan biaya?
Daftar model gratis untuk dipanggil. Permintaan chat pendek dengan max_tokens rendah biayanya beberapa seper-sejuta dolar pada $0,15 per 1M token input dan $0,50 per 1M token output. Permintaan yang gagal tidak dikenakan biaya.
Bagaimana cara menguji kunci tanpa kartu?
Klaim kredit uji coba gratis sebesar $0,50 di halaman kunci API setelah masuk. Anda tidak perlu kartu dan kredit ini berlaku selama 7 hari, satu per orang.
Mengapa kunci yang valid langsung mengembalikan 429?
Anda mungkin mencapai batas konkurensi atau per menit. Kunci uji coba mengizinkan 2 permintaan paralel dan 60 per menit; kunci penuh mengizinkan 8 dan 300. Periksa kode kesalahan, lalu kurangi laju atau coba lagi setelah beberapa detik.
Dapatkah saya menguji kunci di Postman atau aplikasi alih-alih curl?
Ya. Klien yang kompatibel dengan OpenAI apa pun dapat digunakan: atur base URL ke https://api.aiapisource.com/v1, tempelkan kunci sebagai token Bearer, dan gunakan model uncensored.
Kunci Anda hanya perlu mengisi satu formulir
Buat akun, salin kunci, ubah URL dasar. Itu saja seluruh proses pengaturannya.