← Svi članci

Gemini API: kako dobiti ključ, nazvati model i koliko koštaju tokeni

Gemini API: kako dobiti ključ, nazvati model i koliko koštaju tokeni

Gemini API je način na koji pozivate Gemini modele iz vlastitog koda umjesto iz prozora za chat: bot za podršku na vašoj web-lokaciji, skripta koja triira tikete, dovršavanje koda u editoru, CRM integracija. Klasična ruta zahtijeva Google račun, postavku naplate u oblaku i stranu karticu. Na NeuralSpaceu put je kraći: ključ se kreira na vašoj nadzornoj ploči za otprilike minutu, model se poziva zahtjevom koji je kompatibilan s OpenAI-jem, a vi plaćate iz tokena - bez pretplate. Ispod je vodič korak po korak: kako dobiti ključ, kako izgleda vaš prvi poziv na Gemini 3.8 Flash i koliko koštaju tokeni.

Što je Gemini API i kome treba

Gemini je Googleova obitelj jezičnih modela. Putem API-ja otvoren je za programere: šaljete niz poruka, dobivate generirani odgovor i koristite ga u svom proizvodu — pokažite ga korisniku, pohranite, dalje obradite. Tipični slučajevi upotrebe: podrška za chatbotove, sažimanje e-pošte i dokumenata, izdvajanje strukturiranih podataka iz teksta, izrada sadržaja, automatizacija rutine u skriptama. Gemini 3.8 Flash u katalogu NeuralSpace brza je grana obitelji: ravnoteža brzine i cijene koja odgovara dijalozima i masovnoj obradi teksta.

Korak 1. Nabavite ključ

  1. Prijavite se na NeuralSpace svojom e-poštom — potrebno je manje od minute. Novim korisnicima odmah se pripisuju početni tokeni, dovoljni za prve API pozive bez nadoplate.
  2. OtvoriteStranica API ključevana nadzornoj ploči i izradite ključ. Ključ izgleda kao nsk-… i prikazuje se jednom — odmah ga spremite u upravitelj lozinki ili varijablu okruženja, a ne u svoje spremište.
  3. Provjerite stanje: tekstualni modeli zahtijevaju najmanje 50 tokena na računu. Dopune se događaju na nadzornoj ploči — nema stranih kartica, nema pretplatničkih naknada.
The NeuralSpace API keys page: creating a key for the Gemini API

Korak 2. Nazovite model

Gemini u javnom API-ju radi preko OpenAI-kompatibilne krajnje točke POST /v1/chat/completions: tijelo nosi model, polje messages s ulogama sustava/korisnika/pomoćnika i ograničenje max_tokens. Minimalni zahtjev za kovrče:

__NS1054_BLOK_4__

Odgovor se vraća u formatu OpenAI: generirani tekst je u choices[0].message.content, stvarna upotreba je u usage. Ako već imate OpenAI SDK kod, mijenjaju se točno dvije vrijednosti — base_url i ključ:

__NS1054_BLOK_7__

Sučelja za chat imaju koristi od strujanja: dodajte "stream": true i odgovor stiže u dijelovima putem događaja poslanih s poslužitelja, tako da korisnik vidi prve riječi prije nego što se generiranje završi.

Korak 3. Saznajte koliko košta

Naplata se mjeri: ulazni tokeni (vaš upit) i izlazni tokeni (odgovor modela) broje se odvojeno, svaki sa svojom vlastitom cijenom za milijun. Za Gemini 3.8 Flash, u vrijeme pisanja, to je 33,5 tokena po milijunu ulaza i 168 tokena po milijunu izlaza. Tipičan zahtjev od "2000 kontekstnih tokena + 500 izlaznih tokena" košta oko 0,15 tokena. Cijena je povezana s tečajem i varira, stoga prije izračunavanja provjerite tablicu uživo: objavljena je naStranica s dokumentacijom API-jai vraćen u strojno čitljivom obliku od strane GET /v1/models. Za usporedbu: DeepSeek V4 Flash u istom katalogu je 21/42 tokena na milijun, Claude modeli su osjetno skuplji; Gemini 3.8 Flash nalazi se u sredini po cijeni dok brzo odgovara.

Dva ograničenja usluge: 60 zahtjeva u minuti po ključu i minimalni saldo od 50 tokena za tekstualne modele. Trenutačni saldo dostupan je putem GET /v1/balance, troškovi se pojavljuju u povijesti transakcija vašeg profila.

Gemini na mjestu — kod nije potreban

Ako još ne trebate API, isti modeli žive u sučelju: odaberite Gemini 3.8 Flash urazgovor— tamo je omogućeno web pretraživanje — a za slikegeneriranje slikedio nudi Nano Bananu, model temeljen na Gemini 2.5 Flashu. Stanje se dijeli: chat i API povlače s istog računa.

Uobičajene pogreške prvog zahtjeva

  • 401 Neovlašteno— ključ je neispravno proslijeđen: dodatni razmak, skraćena vrijednost, pogrešan prefiks. Puni ključ ide nakon Bearer ili u zaglavlju x-api-key.
  • 429 Previše zahtjeva— dosegli ste ograničenje od 60 zahtjeva po minuti. Dodajte pauzu ili red čekanja sa svoje strane.
  • Greška ravnoteže— manje od 50 tokena na računu: nadopunite na nadzornoj ploči i pokušajte ponovno.
  • Ključ je procurio u git— čuvajte ga u varijablama okruženja (.env) i nikada ga ne predajte; ako procuri, ponovno izdajte ključ na istoj stranici API ključeva.

FAQ

Trebam li Google račun ili stranu karticu?

Ne. Ključ se izdaje na vašoj nadzornoj ploči NeuralSpace i plaćate saldom tokena: naplata temeljena na tokenu, bez pretplate, bez naplate u oblaku.

Koliko košta Gemini API poziv?

Samo stvarni tokeni: u vrijeme pisanja, 33,5 tokena po milijunu ulaza i 168 po milijunu izlaza za Gemini 3.8 Flash; zahtjev od nekoliko tisuća tokena je otprilike 0,15 tokena. Aktualne cijene su u GET /v1/models i tablici dokumentacije.

Postoji li besplatna razina?

Na platformi nema besplatnih generacija. Novi korisnici dobivaju početne tokene — dovoljno za prve eksperimente — nakon toga plaćate po tokenu bez naknade za pretplatu.

Što još API može učiniti osim teksta?

S istim ključem dobivate generiranje slike, videa i glazbe, sintezu i prepoznavanje govora te MCP poslužitelj na https://neuralspace.pro/mcp za AI agente. Potpuni popis krajnjih točaka nalazi se u dokumentaciji.