← Все статьи

API Gemini: cara mendapatkan kunci, hubungi model dan kos token

API Gemini: cara mendapatkan kunci, hubungi model dan kos token

API Gemini ialah cara anda memanggil model Gemini daripada kod anda sendiri dan bukannya tetingkap sembang: bot sokongan di tapak anda, skrip yang mencuba tiket, penyiapan kod dalam editor, penyepaduan CRM. Laluan klasik memerlukan akaun Google, persediaan pengebilan awan dan kad asing. Pada NeuralSpace laluannya lebih pendek: kunci dibuat dalam papan pemuka anda dalam masa kira-kira seminit, model dipanggil dengan permintaan serasi OpenAI dan anda membayar daripada baki token — tiada langganan. Di bawah ialah panduan langkah demi langkah: cara mendapatkan kunci, rupa panggilan pertama anda ke Gemini 3.8 Flash, dan kos token.

Apakah API Gemini dan siapa yang memerlukannya

Gemini ialah keluarga model bahasa Google. Melalui API ia terbuka kepada pembangun: anda menghantar pelbagai mesej, mendapatkan jawapan yang dijana dan menggunakannya dalam produk anda — tunjukkan kepada pengguna, simpannya, proseskannya dengan lebih lanjut. Kes penggunaan biasa: menyokong chatbots, meringkaskan e-mel dan dokumen, mengekstrak data berstruktur daripada teks, mendraf kandungan, mengautomasikan rutin dalam skrip. Gemini 3.8 Flash dalam katalog NeuralSpace ialah cawangan pantas keluarga: keseimbangan kelajuan dan harga yang sesuai dengan dialog dan pemprosesan teks pukal.

Langkah 1. Dapatkan kunci

  1. Daftar di NeuralSpace dengan e-mel anda — ia mengambil masa kurang dari seminit. Pengguna baharu dikreditkan token pemula serta-merta, cukup untuk panggilan API pertama tanpa tambah nilai.
  2. Bukahalaman kunci APIdalam papan pemuka anda dan buat kunci. Kuncinya kelihatan seperti nsk-… dan ditunjukkan sekali — simpannya dengan segera dalam pengurus kata laluan atau pembolehubah persekitaran, bukan dalam repositori anda.
  3. Semak baki anda: model teks memerlukan sekurang-kurangnya 50 token pada akaun. Tambah nilai berlaku di papan pemuka — tiada kad asing, tiada yuran langganan.
The NeuralSpace API keys page: creating a key for the Gemini API

Langkah 2. Panggil model

Gemini dalam API awam berfungsi melalui titik akhir serasi OpenAI POST /v1/chat/completions: badan membawa model, tatasusunan messages dengan peranan sistem / pengguna / pembantu dan had max_tokens. Permintaan curl minimum:

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
  }'

Respons datang kembali dalam format OpenAI: teks yang dijana adalah dalam choices[0].message.content, penggunaan sebenar dalam usage. Jika anda sudah mempunyai kod SDK OpenAI, betul-betul dua nilai berubah — base_url dan kunci:

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)

Antara muka sembang mendapat manfaat daripada penstriman: tambahkan "stream": true dan jawapannya tiba dalam beberapa bahagian melalui Acara Dihantar Pelayan, jadi pengguna melihat perkataan pertama sebelum penjanaan selesai.

Langkah 3. Ketahui kosnya

Pengebilan adalah bermeter: token input (gesaan anda) dan token output (balasan model) dikira secara berasingan, setiap satu dengan harga per jutanya sendiri. Untuk Gemini 3.8 Flash, pada masa penulisan, ia adalah 33.5 token setiap juta input dan 168 token setiap juta output. Permintaan biasa "2,000 token konteks + 500 token output" berharga kira-kira 0.15 token. Harga adalah berkaitan kadar pertukaran dan terapung, jadi semak jadual langsung sebelum melakukan matematik: ia diterbitkan padahalaman dokumentasi APIdan dikembalikan dalam bentuk yang boleh dibaca mesin oleh GET /v1/models. Sebagai perbandingan: DeepSeek V4 Flash dalam katalog yang sama ialah 21/42 token setiap juta, model Claude nyata lebih mahal; Gemini 3.8 Flash berada di tengah-tengah pada harga sambil menjawab dengan pantas.

Dua had perkhidmatan: 60 permintaan seminit setiap kunci, dan baki minimum 50 token untuk model teks. Baki semasa tersedia melalui GET /v1/balance, caj dipaparkan dalam sejarah transaksi profil anda.

Gemini di tapak — tiada kod diperlukan

Jika anda belum memerlukan API lagi, model yang sama hidup dalam antara muka: pilih Gemini 3.8 Flash dalamberbual— carian web didayakan di sana — dan untuk imej yangpenjanaan imejbahagian menawarkan Nano Banana, model berdasarkan Gemini 2.5 Flash. Baki dikongsi: sembang dan cabutan API daripada akaun yang sama.

Ralat permintaan pertama yang biasa

  • 401 Tanpa kebenaran— kunci telah dilalui secara salah: ruang tambahan, nilai terpotong, awalan yang salah. Kekunci penuh pergi selepas Bearer atau dalam pengepala x-api-key.
  • 429 Terlalu Banyak Permintaan— anda mencapai had 60 permintaan setiap minit. Tambahkan jeda atau baris gilir di sebelah anda.
  • Ralat imbangan— kurang daripada 50 token pada akaun: tambah nilai dalam papan pemuka dan cuba semula.
  • Kunci bocor ke git— simpan dalam pembolehubah persekitaran (.env) dan jangan sekali-kali melakukannya; jika ia bocor, keluarkan semula kunci pada halaman kunci API yang sama.

Soalan Lazim

Adakah saya memerlukan akaun Google atau kad asing?

Tidak. Kunci dikeluarkan dalam papan pemuka NeuralSpace anda dan anda membayar daripada baki token: pengebilan berasaskan token, tiada langganan, tiada pengebilan awan.

Berapakah kos panggilan API Gemini?

Hanya token sebenar: pada masa penulisan, 33.5 token setiap juta input dan 168 setiap juta output untuk Gemini 3.8 Flash; permintaan beberapa ribu token adalah kira-kira 0.15 token. Harga semasa adalah dalam GET /v1/models dan jadual dokumentasi.

Adakah terdapat peringkat percuma?

Tiada generasi percuma di platform. Pengguna baharu mendapat token permulaan — cukup untuk percubaan pertama — selepas itu anda membayar setiap token tanpa yuran langganan.

Apa lagi yang boleh dilakukan oleh API selain teks?

Dengan kunci yang sama, anda mendapat penjanaan imej, video dan muzik, sintesis dan pengecaman pertuturan serta pelayan MCP di https://neuralspace.pro/mcp untuk ejen AI. Senarai titik akhir penuh ada dalam dokumentasi.