Gemini API: ako získať kľúč, zavolať model a koľko tokenov stojí

Gemini API je spôsob, akým voláte modely Gemini z vlastného kódu namiesto okna chatu: podporný robot na vašej stránke, skript, ktorý triedi vstupenky, dokončenie kódu v editore, integrácia CRM. Klasická cesta vyžaduje Google účet, nastavenie cloudovej fakturácie a zahraničnú kartu. Na NeuralSpace je cesta kratšia: kľúč sa vytvorí na vašom informačnom paneli približne za minútu, model sa zavolá s požiadavkou kompatibilnou s OpenAI a platíte zo zostatku tokenov – žiadne predplatné. Nižšie je podrobný návod: ako získať kľúč, ako vyzerá váš prvý hovor do Gemini 3.8 Flash a koľko tokenov stojí.

Čo je Gemini API a kto ho potrebuje

Gemini je rodina jazykových modelov Google. Prostredníctvom API je otvorený pre vývojárov: pošlete množstvo správ, získate vygenerovanú odpoveď a použijete ju vo svojom produkte – ukážete ju používateľovi, uložíte, ďalej spracujete. Typické prípady použitia: podpora chatbotov, sumarizácia e-mailov a dokumentov, extrahovanie štruktúrovaných údajov z textu, tvorba obsahu, automatizácia rutiny v skriptoch. Gemini 3.8 Flash v katalógu NeuralSpace je rýchla vetva rodiny: rovnováha medzi rýchlosťou a cenou, ktorá vyhovuje dialógom a hromadnému spracovaniu textu.

Krok 1. Získajte kľúč

1. Zaregistrujte sa na NeuralSpace pomocou svojho e-mailu – trvá to menej ako minútu. Novým používateľom sa okamžite pripíšu štartovacie tokeny, ktoré postačujú na prvé volania rozhrania API bez dobíjania.
2. OtvorteStránka kľúčov APIna palubnej doske a vytvorte kľúč. Kľúč vyzerá ako nsk-… a je zobrazený raz – okamžite ho uložte do správcu hesiel alebo premennej prostredia, nie do svojho úložiska.
3. Skontrolujte si zostatok: textové modely vyžadujú minimálne 50 tokenov na účte. Dobíjanie prebieha na informačnom paneli – žiadne zahraničné karty, žiadne poplatky za predplatné.

Krok 2. Zavolajte model

Gemini vo verejnom API funguje cez koncový bod kompatibilný s OpenAI POST /v1/chat/completions: telo nesie model, pole messages s rolami systém / používateľ / asistent a limit max_tokens. Minimálna požiadavka na zvlnenie:

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

Odpoveď sa vráti vo formáte OpenAI: vygenerovaný text je vo formáte choices[0].message.content, skutočné využitie je vo formáte usage. Ak už máte kód OpenAI SDK, zmenia sa presne dve hodnoty — base_url a kľúč:

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)

Rozhrania chatu ťažia zo streamovania: pridajte "stream": true a odpoveď príde po častiach prostredníctvom udalostí odoslaných serverom, takže používateľ uvidí prvé slová ešte pred dokončením generovania.

Krok 3. Zistite, čo to stojí

Účtovanie sa meria: vstupné tokeny (vaša výzva) a výstupné tokeny (odpoveď modelu) sa počítajú oddelene, každý s vlastnou cenou za milión. Pre Gemini 3.8 Flash je to v čase písania tohto článku 33,5 tokenov na milión vstupov a 168 tokenov na milión výstupov. Typická požiadavka „2 000 kontextových tokenov + 500 výstupných tokenov“ stojí približne 0,15 tokenov. Cena je viazaná na výmenný kurz a pohybuje sa, preto si pred vykonaním výpočtu skontrolujte aktuálnu tabuľku: je zverejnená naStránka dokumentácie APIa GET /v1/models ich vrátil v strojovo čitateľnej forme. Pre porovnanie: DeepSeek V4 Flash v rovnakom katalógu je 21/42 tokenov na milión, modely Claude sú výrazne drahšie; Gemini 3.8 Flash stojí uprostred ceny a zároveň rýchlo odpovedá.

Dva limity služieb: 60 požiadaviek za minútu na kľúč a minimálny zostatok 50 tokenov pre textové modely. Aktuálny zostatok je k dispozícii prostredníctvom GET /v1/balance, poplatky sa zobrazia v histórii transakcií vášho profilu.

Blíženci na stránke – nie je potrebný žiadny kód

Ak ešte nepotrebujete API, rovnaké modely žijú v rozhraní: vyberte Gemini 3.8 Flash vchatovať— tam je povolené vyhľadávanie na webe — a pre obrázkygenerovanie obrazusekcia ponúka Nano Banana, model založený na Gemini 2.5 Flash. Zostatok je zdieľaný: chat a API čerpajú z rovnakého účtu.

Bežné chyby prvej požiadavky

• 401 Neoprávnené— kľúč bol odovzdaný nesprávne: medzera navyše, skrátená hodnota, nesprávna predpona. Úplný kľúč sa nachádza za Bearer alebo v hlavičke x-api-key.
• 429 Príliš veľa žiadostí— dosiahli ste limit 60 žiadostí za minútu. Pridajte pauzu alebo rad na vašej strane.
• Chyba vyváženia— menej ako 50 tokenov na účte: doplňte na informačnom paneli a skúste to znova.
• Kľúč unikol do git— uchovávajte ho v premenných prostredia (.env) a nikdy ho nepotvrdzujte; ak unikne, znova zadajte kľúč na tej istej stránke kľúčov API.

FAQ

Potrebujem účet Google alebo zahraničnú kartu?

Nie. Kľúč sa vydáva na vašom informačnom paneli NeuralSpace a platíte zo zostatku tokenov: fakturácia založená na tokenoch, žiadne predplatné, žiadna cloudová fakturácia.

Koľko stojí hovor Gemini API?

Iba skutočné tokeny: v čase písania 33,5 tokenov na milión vstupov a 168 na milión výstupov pre Gemini 3.8 Flash; požiadavka niekoľkých tisíc tokenov je zhruba 0,15 tokenov. Aktuálne ceny sú v GET /v1/models a v tabuľke dokumentácie.

Existuje voľná úroveň?

Na platforme nie sú žiadne voľné generácie. Noví používatelia získajú štartovacie tokeny – dosť na prvé experimenty – potom platíte za token bez poplatku za predplatné.

Čo ešte môže API robiť okrem textu?

S rovnakým kľúčom získate generovanie obrazu, videa a hudby, syntézu a rozpoznávanie reči a server MCP na https://neuralspace.pro/mcp pre agentov AI. Úplný zoznam koncových bodov je v dokumentácii.