← Összes cikk

Gemini API: hogyan szerezzünk kulcsot, hívjuk fel a modellt, és mennyibe kerülnek a tokenek

Gemini API: hogyan szerezzünk kulcsot, hívjuk fel a modellt, és mennyibe kerülnek a tokenek

A Gemini API segítségével a saját kódodból hívhatod meg a Gemini modelleket csevegőablak helyett: egy támogató bot a webhelyen, egy szkript, amely jegyeket próbál ki, kódkiegészítés szerkesztőben, CRM-integráció. A klasszikus útvonalhoz Google-fiók, felhőalapú számlázási beállítások és külföldi kártya szükséges. A NeuralSpace-en az út rövidebb: körülbelül egy perc alatt létrejön egy kulcs az irányítópulton, a modell OpenAI-kompatibilis kéréssel hívódik meg, és Ön tokenegyenlegből fizet – előfizetés nélkül. Az alábbiakban egy lépésről lépésre bemutatjuk a kulcsot, hogyan néz ki a Gemini 3.8 Flash első hívása, és mennyibe kerülnek a tokenek.

Mi a Gemini API, és kinek van rá szüksége

A Gemini a Google nyelvi modellcsaládja. Az API-n keresztül nyitva áll a fejlesztők előtt: üzenettömböt küld, generált választ kap, és felhasználja a termékében – megmutatja a felhasználónak, tárolja, feldolgozza tovább. Tipikus használati esetek: chatbotok támogatása, e-mailek és dokumentumok összegzése, strukturált adatok kinyerése szövegből, tartalom készítése, rutinok automatizálása szkriptekben. A Gemini 3.8 Flash a NeuralSpace katalógusban a család gyors ága: a sebesség és az ár egyensúlya, amely illeszkedik a párbeszédekhez és a tömeges szövegfeldolgozáshoz.

1. lépés: Szerezzen kulcsot

  1. Regisztráljon a NeuralSpace-re e-mail címével – ez kevesebb, mint egy percet vesz igénybe. Az új felhasználók azonnal jóváírják a kezdő tokeneket, amelyek elegendőek az első API-hívásokhoz, feltöltés nélkül.
  2. Nyissa meg aAPI kulcsok oldalaz irányítópulton, és hozzon létre egy kulcsot. A kulcs így néz ki: nsk-…, és egyszer jelenik meg – azonnal mentse el egy jelszókezelőbe vagy egy környezeti változóba, ne a tárhelyébe.
  3. Ellenőrizze egyenlegét: a szöveges modellekhez legalább 50 token szükséges a számlán. A feltöltés az irányítópulton történik – nincs külföldi kártya, nincs előfizetési díj.
The NeuralSpace API keys page: creating a key for the Gemini API

2. lépés Hívja fel a modellt

A nyilvános API-ban a Gemini az OpenAI-kompatibilis POST /v1/chat/completions végponton keresztül működik: a törzs hordozza a modellt, egy messages tömböt rendszer-/felhasználói/asszisztens szerepekkel és a max_tokens korláttal. Minimális göndörítési kérés:

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

A válasz OpenAI formátumban érkezik vissza: a generált szöveg choices[0].message.content, a tényleges használat pedig usage. Ha már rendelkezik OpenAI SDK-kóddal, pontosan két érték változik: a base_url és a kulcs:

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)

A csevegési felületek hasznot húznak a streamelésből: adja hozzá az "stream": true karakterláncot, és a válasz a szerver által küldött eseményeken keresztül darabokban érkezik, így a felhasználó a generálás befejezése előtt látja az első szavakat.

3. lépés: Tudja meg, mennyibe kerül

A számlázás mért: a bemeneti tokenek (az Ön promptja) és a kimeneti tokenek (a modell válasza) külön számítanak, mindegyiknek saját milliós ára van. A Gemini 3.8 Flash esetében a cikk írásakor ez 33,5 token millió bemenetenként és 168 token millió kimenetenként. A „2000 kontextusjogkivonat + 500 kimeneti token” tipikus kérése körülbelül 0,15 tokenbe kerül. Az ár árfolyamhoz kötött és lebeg, ezért a számolás előtt ellenőrizze az élő táblázatot: az aAPI dokumentációs oldalés géppel olvasható formában visszaküldte a GET /v1/models. Összehasonlításképpen: ugyanabban a katalógusban a DeepSeek V4 Flash 21/42 token/millió, a Claude modellek észrevehetően drágábbak; A Gemini 3.8 Flash az árban a középmezőnyben van, miközben gyorsan válaszol.

Két szolgáltatási korlát: 60 kérés percenként kulcsonként, és 50 token minimális egyenleg szöveges modelleknél. Az aktuális egyenleg a következőn keresztül érhető el: GET /v1/balance, a költségek megjelennek a profilod tranzakciós előzményeiben.

Gemini az oldalon – nincs szükség kódra

Ha még nincs szüksége az API-ra, ugyanazok a modellek élnek a felületen: válassza ki a Gemini 3.8 Flash-tcsevegés— a webes keresés engedélyezve van ott — a képeknél pedig aképalkotásszekció kínálja a Nano Bananát, a Gemini 2.5 Flash-re épülő modellt. Az egyenleg megoszlik: a chat és az API ugyanabból a számlából húz.

Gyakori első kérésre vonatkozó hibák

  • 401 Jogosulatlan— a kulcsot hibásan adták át: extra szóköz, csonka érték, rossz előtag. A teljes kulcs az Bearer után vagy az x-api-key fejlécben található.
  • 429 Túl sok kérés- elérte a 60 kérés percenkénti határát. Adjon hozzá egy szünetet vagy egy sort az Ön oldalán.
  • Egyenleg hiba— kevesebb mint 50 token a számlán: töltse fel az irányítópulton, és próbálkozzon újra.
  • A kulcs kiszivárgott a git-be— tartsa a környezeti változókban (.env), és soha ne hagyja abba; ha kiszivárog, adja ki újra a kulcsot ugyanazon az API-kulcsok oldalon.

GYIK

Google fiókra vagy külföldi kártyára van szükségem?

Nem. A kulcsot a NeuralSpace irányítópultján adják ki, és Ön token egyenlegről fizet: token alapú számlázás, előfizetés nélkül, felhőalapú számlázás nélkül.

Mennyibe kerül egy Gemini API hívás?

Csak a tényleges tokenek: az írás idején 33,5 token millió bemenetenként és 168 millió kimenet a Gemini 3.8 Flash esetében; egy párezer token kérése nagyjából 0,15 token. Az aktuális árak a GET /v1/models-ban és a dokumentációs táblázatban találhatók.

Van ingyenes szint?

Nincsenek szabad generációk a platformon. Az új felhasználók kezdő tokeneket kapnak – ez elegendő az első kísérletekhez – ezt követően előfizetési díj nélkül kell tokenenként fizetni.

Mi másra képes az API a szövegen kívül?

Ugyanazzal a kulccsal kép-, videó- ​​és zenegenerálást, beszédszintézist és -felismerést, valamint egy MCP-kiszolgálót kap a https://neuralspace.pro/mcp oldalon az AI-ügynökök számára. A teljes végpontlista a dokumentációban található.