Gemini API: avaimen hankkiminen, mallin soittaminen ja mitä rahakkeet maksavat
The Gemini API is how you call Gemini models from your own code instead of a chat window: a support bot on your site, a script that triages tickets, code completion in an editor, a CRM integration. Klassinen reitti vaatii Google-tilin, pilvilaskutusasetukset ja ulkomaisen kortin. On NeuralSpace the path is shorter: a key is created in your dashboard in about a minute, the model is called with an OpenAI-compatible request, and you pay from a token balance — no subscription. Alla on vaiheittaiset ohjeet: kuinka saat avaimen, miltä ensimmäinen puhelusi Gemini 3.8 Flashiin näyttää ja mitä rahakkeet maksavat.
- Rekisteröidy NeuralSpaceen sähköpostilla – se kestää alle minuutin. Uusille käyttäjille hyvitetään aloitustunnukset heti, mikä riittää ensimmäisiin API-kutsuihin ilman lisäystä.
- AvaaAPI-avaimet -sivuin your dashboard and create a key. Avain näyttää tältä
nsk-…ja näkyy kerran – tallenna se välittömästi salasanan hallintaan tai ympäristömuuttujaan, älä arkistoon. - Tarkista saldosi: tekstimallit edellyttävät vähintään 50 tiliä. Lisäykset tapahtuvat kojelaudassa – ei ulkomaisia kortteja, ei tilausmaksuja.

Vastaus tulee takaisin OpenAI-muodossa: luotu teksti on muodossa choices[0].message.content, todellinen käyttö on usage. Jos sinulla on jo OpenAI SDK -koodi, täsmälleen kaksi arvoa muuttuvat - base_url ja avain:
Billing is metered: input tokens (your prompt) and output tokens (the model's reply) are counted separately, each with its own per-million price. Gemini 3.8 Flashissa se on kirjoitushetkellä 33,5 merkkiä miljoonaa syöttöä kohden ja 168 merkkiä miljoonaa lähtöä kohti. Tyypillinen pyyntö "2 000 kontekstitunnusta + 500 tulostetunnusta" maksaa noin 0,15 merkkiä. Hinta on valuuttakurssisidonnainen ja kelluu, joten tarkista live-taulukko ennen laskemista: se julkaistaanja palautti koneellisesti luettavassa muodossa GET /v1/models. Vertailun vuoksi: DeepSeek V4 Flash samassa luettelossa on 21/42 tokenia miljoonaa kohti, Claude-mallit ovat huomattavasti kalliimpia; Gemini 3.8 Flash on keskihintainen ja vastaa nopeasti.
Kaksi palvelurajoitusta: 60 pyyntöä minuutissa per avainta ja 50 merkin vähimmäissaldo tekstimalleille. Nykyinen saldo on saatavilla osoitteessa GET /v1/balance, veloitukset näkyvät profiilisi tapahtumahistoriassa.
Gemini sivustolla - koodia ei tarvita
Jos et vielä tarvitse API:ta, samat mallit elävät käyttöliittymässä: valitse Gemini 3.8 Flashkeskustella— Web-haku on käytössä siellä — ja kuvillekuvan luominen-osio tarjoaa Nano Banana -mallin, joka perustuu Gemini 2.5 Flashiin. Saldo jaetaan: chat ja API nostavat samalta tililtä.
Yleisiä ensimmäisen pyynnön virheitä
- 401 Luvaton— avain välitettiin väärin: ylimääräinen välilyönti, katkaistu arvo, väärä etuliite. Täysi avain kulkee
Bearer:n jälkeen taix-api-key-otsikossa. - 429 Liian monta pyyntöä- saavutit 60 pyynnön minuutissa rajan. Lisää tauko tai jono puolellesi.
- Tasapainovirhe— alle 50 tokenia tilillä: lisää kojelaudassa ja yritä uudelleen.
- Avain vuotanut gitiin— säilytä se ympäristömuuttujissa (.env) äläkä koskaan sitoudu siihen; Jos se vuotaa, anna avain uudelleen samalla API-avaimet-sivulla.
FAQ
Tarvitsenko Google-tilin vai ulkomaisen kortin?
Ei. Avain myönnetään NeuralSpace-hallintapaneelissasi ja maksat token-saldosta: tunnuspohjainen laskutus, ei tilausta, ei pilvilaskutusta.
Kuinka paljon Gemini API -puhelu maksaa?
Vain varsinaiset tunnukset: kirjoitushetkellä 33,5 merkkiä miljoonaa syöttöä kohden ja 168 merkkiä miljoonaa lähtöä kohden Gemini 3.8 Flashissa; parin tuhannen tokenin pyyntö on noin 0,15 merkkiä. Nykyiset hinnat ovat julkaisussa GET /v1/models ja dokumentaatiotaulukossa.
Onko olemassa ilmaista tasoa?
Alustalla ei ole vapaita sukupolvia. Uudet käyttäjät saavat aloitustunnuksia – riittää ensimmäisiin kokeiluihin – sen jälkeen maksat tunnuksesta ilman tilausmaksua.
Mitä muuta API voi tehdä tekstin lisäksi?
Samalla avaimella saat kuvan, videon ja musiikin luomisen, puhesynteesin ja -tunnistuksen sekä MCP-palvelimen osoitteessa https://neuralspace.pro/mcp tekoälyagenteille. Täydellinen päätepisteluettelo on dokumentaatiossa.