Menghubungkan API Key AI ke Aplikasi dengan cURL, Python, dan Node.js

API AI panel kompatibel dengan SDK OpenAI. Anda cukup mengganti dua hal di aplikasi: base URL menjadi https://ai.serverhost.store/v1 dan API key menjadi key yang Anda buat di menu Pay As You Go. Setelah itu endpoint seperti /chat/completions dan /models bekerja seperti biasa.

Yang perlu disiapkan

• API key dari menu Pay As You Go, tab API key. Panduannya ada di cara membuat API key.
• Base URL: https://ai.serverhost.store/v1.
• ID model persis seperti yang tampil di katalog model pada menu Pay As You Go. Salin apa adanya, termasuk huruf besar kecil dan tanda hubung.
• Kredit AI yang cukup. Bila kredit habis, request ditolak sampai kredit ditambah.

Uji cepat dengan cURL

Ganti KEY_ANDA dengan API key Anda dan NAMA_MODEL dengan ID model dari katalog.

curl https://ai.serverhost.store/v1/chat/completions \
  -H "Authorization: Bearer KEY_ANDA" \
  -H "Content-Type: application/json" \
  -d '{"model":"NAMA_MODEL","messages":[{"role":"user","content":"Halo"}]}'

Balasan berupa JSON berisi jawaban model. Bila muncul galat, lihat bagian menangani galat di bawah.

Python dengan SDK OpenAI

Pasang pustaka lebih dulu: pip install openai. Simpan API key di variabel lingkungan, jangan ditulis langsung di kode yang dibagikan.

from openai import OpenAI

client = OpenAI(
    base_url="https://ai.serverhost.store/v1",
    api_key="KEY_ANDA",
)

resp = client.chat.completions.create(
    model="NAMA_MODEL",
    messages=[{"role": "user", "content": "Halo"}],
)
print(resp.choices[0].message.content)

Node.js dengan SDK OpenAI

Pasang pustaka lebih dulu: npm install openai.

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://ai.serverhost.store/v1",
  apiKey: "KEY_ANDA",
});

const resp = await client.chat.completions.create({
  model: "NAMA_MODEL",
  messages: [{ role: "user", content: "Halo" }],
});
console.log(resp.choices[0].message.content);

Memakai di tool lain

Aplikasi apa pun yang menerima base URL dan API key OpenAI bisa diarahkan ke panel. Isi kolom Base URL atau API Base dengan https://ai.serverhost.store/v1, isi API Key dengan key Anda, lalu pilih model dari katalog. Pola ini berlaku untuk library, ekstensi editor, maupun alat otomasi.

Menangani galat umum

• 401 Unauthorized: key salah, kosong, atau sudah dicabut. Salin ulang key dari tab API key, dan pastikan formatnya Authorization: Bearer KEY_ANDA.
• Request ditolak karena kredit: kredit AI habis. Tambah kredit dari menu Dompet, lalu coba lagi.
• 404 model tidak ditemukan: ID model salah ketik atau tidak ada di katalog, atau key dibatasi ke model tertentu. Periksa Model yang diizinkan pada key tersebut.
• 429 Too Many Requests: permintaan terlalu rapat. Beri jeda dan ulangi secara bertahap.

Menjaga key tetap aman

Perlakukan API key seperti kata sandi. Simpan di sisi server atau variabel lingkungan, jangan di kode frontend yang bisa dibuka pengunjung. Bila key bocor, tekan Cabut di tab API key dan buat key baru. Untuk memantau biaya, buka tab Pemakaian dan Transaksi.