← Все статьи

Gemini API: cara mendapatkan kunci, memanggil model, dan berapa harga token

Gemini API: cara mendapatkan kunci, memanggil model, dan berapa harga token

Gemini API adalah cara Anda memanggil model Gemini dari kode Anda sendiri, bukan dari jendela obrolan: bot dukungan di situs Anda, skrip yang melakukan triase tiket, penyelesaian kode di editor, integrasi CRM. Rute klasik memerlukan akun Google, penyiapan penagihan cloud, dan kartu asing. Di NeuralSpace, jalurnya lebih pendek: kunci dibuat di dasbor Anda dalam waktu sekitar satu menit, model dipanggil dengan permintaan yang kompatibel dengan OpenAI, dan Anda membayar dari saldo token — tanpa berlangganan. Di bawah ini adalah panduan langkah demi langkah: cara mendapatkan kunci, seperti apa panggilan pertama Anda ke Gemini 3.8 Flash, dan berapa harga tokennya.

Apa itu Gemini API dan siapa yang membutuhkannya

Gemini adalah keluarga model bahasa Google. Melalui API, ini terbuka untuk pengembang: Anda mengirim serangkaian pesan, mendapatkan jawaban yang dihasilkan dan menggunakannya dalam produk Anda — menunjukkannya kepada pengguna, menyimpannya, memprosesnya lebih lanjut. Kasus penggunaan yang umum: mendukung chatbot, meringkas email dan dokumen, mengekstraksi data terstruktur dari teks, menyusun konten, mengotomatiskan rutinitas dalam skrip. Gemini 3.8 Flash dalam katalog NeuralSpace adalah cabang cepat dari keluarga ini: keseimbangan kecepatan dan harga yang sesuai dengan dialog dan pemrosesan teks massal.

Langkah 1. Dapatkan kunci

  1. Daftar di NeuralSpace dengan email Anda — hanya membutuhkan waktu kurang dari satu menit. Pengguna baru langsung diberi kredit token awal, cukup untuk panggilan API pertama tanpa isi ulang.
  2. BukaHalaman kunci APIdi dasbor Anda dan buat kunci. Kuncinya terlihat seperti nsk-… dan ditampilkan satu kali — segera simpan di pengelola kata sandi atau variabel lingkungan, bukan di repositori Anda.
  3. Periksa saldo Anda: model teks memerlukan minimal 50 token di akun. Isi ulang dilakukan di dasbor — tanpa kartu asing, tanpa biaya berlangganan.
The NeuralSpace API keys page: creating a key for the Gemini API

Langkah 2. Hubungi modelnya

Gemini di API publik bekerja melalui titik akhir yang kompatibel dengan OpenAI POST /v1/chat/completions: isi membawa model, larik messages dengan peran sistem/pengguna/asisten, dan batas max_tokens. Permintaan ikal minimal:

curl https://neuralspace.pro/v1/chat/completions \
  -H "Authorization: Bearer nsk-your_key" \
  -H "content-type: application/json" \
  -d '{
    "model": "gemini-3-8-flash",
    "messages": [{"role": "user", "content": "Suggest three names for a neural network channel"}],
    "max_tokens": 500
  }'

Responsnya muncul dalam format OpenAI: teks yang dihasilkan dalam choices[0].message.content, penggunaan sebenarnya dalam usage. Jika Anda sudah memiliki kode OpenAI SDK, ada dua nilai yang berubah — base_url dan kuncinya:

from openai import OpenAI

client = OpenAI(
    base_url="https://neuralspace.pro/v1",
    api_key="nsk-your_key",
)

resp = client.chat.completions.create(
    model="gemini-3-8-flash",
    messages=[
        {"role": "system", "content": "You answer technical questions briefly."},
        {"role": "user", "content": "How is streaming different from a regular response?"},
    ],
)
print(resp.choices[0].message.content)

Antarmuka obrolan mendapat manfaat dari streaming: tambahkan "stream": true dan jawabannya datang dalam beberapa bagian melalui Acara Terkirim Server, sehingga pengguna melihat kata-kata pertama sebelum pembuatan selesai.

Langkah 3. Ketahui berapa biayanya

Penagihan diukur: token masukan (perintah Anda) dan token keluaran (balasan model) dihitung secara terpisah, masing-masing memiliki harga per jutanya sendiri. Untuk Gemini 3.8 Flash, pada saat penulisan, terdapat 33,5 token per juta masukan dan 168 token per juta keluaran. Permintaan umum "2.000 token konteks + 500 token keluaran" berharga sekitar 0,15 token. Harganya terkait dengan nilai tukar dan mengambang, jadi periksa tabel langsung sebelum melakukan perhitungan: ini dipublikasikan diHalaman dokumentasi APIdan dikembalikan dalam bentuk yang dapat dibaca mesin oleh GET /v1/models. Sebagai perbandingan: DeepSeek V4 Flash dalam katalog yang sama adalah 21/42 token per juta, model Claude jauh lebih mahal; Gemini 3.8 Flash berada di tengah-tengah harga sambil menjawab dengan cepat.

Dua batas layanan: 60 permintaan per menit per kunci, dan saldo minimum 50 token untuk model teks. Saldo saat ini tersedia melalui GET /v1/balance, tagihan muncul di riwayat transaksi profil Anda.

Gemini di situs — tidak perlu kode

Jika Anda belum memerlukan API, model yang sama ada di antarmuka: pilih Gemini 3.8 Flash dimengobrol— pencarian web diaktifkan di sana — dan untuk gambargenerasi gambarbagian menawarkan Nano Banana, model berdasarkan Gemini 2.5 Flash. Saldo dibagikan: chat dan penarikan API dari akun yang sama.

Kesalahan permintaan pertama yang umum

  • 401 Tidak Sah— kunci yang diberikan salah: spasi tambahan, nilai terpotong, awalan salah. Kunci lengkapnya berada setelah Bearer atau di header x-api-key.
  • 429 Terlalu Banyak Permintaan— Anda mencapai batas 60 permintaan per menit. Tambahkan jeda atau antrean di sisi Anda.
  • Kesalahan keseimbangan— kurang dari 50 token di akun: isi ulang di dasbor dan coba lagi.
  • Kunci bocor ke git— simpan dalam variabel lingkungan (.env) dan jangan pernah melakukan itu; jika bocor, terbitkan ulang kunci di halaman kunci API yang sama.

Pertanyaan Umum

Apakah saya memerlukan akun Google atau kartu asing?

Tidak. Kuncinya dikeluarkan di dasbor NeuralSpace Anda dan Anda membayar dari saldo token: penagihan berbasis token, tanpa langganan, tanpa penagihan cloud.

Berapa biaya panggilan API Gemini?

Hanya token sebenarnya: pada saat penulisan, 33,5 token per juta masukan dan 168 per juta keluaran untuk Gemini 3.8 Flash; permintaan beberapa ribu token kira-kira 0,15 token. Harga saat ini ada di GET /v1/models dan tabel dokumentasi.

Apakah ada tingkat gratis?

Tidak ada generasi gratis di platform ini. Pengguna baru mendapatkan token awal — cukup untuk percobaan pertama — setelah itu Anda membayar per token tanpa biaya berlangganan.

Apa lagi yang bisa dilakukan API selain teks?

Dengan kunci yang sama Anda mendapatkan pembuatan gambar, video dan musik, sintesis dan pengenalan ucapan, dan server MCP di https://neuralspace.pro/mcp untuk agen AI. Daftar titik akhir selengkapnya ada di dokumentasi.