← Все статьи

Gemini API: cum să obțineți o cheie, să apelați modelul și cât costă jetoanele

O tastă de acces digital strălucitoare plutând deasupra unei tastaturi întunecate, înconjurată de linii de cod

Gemini API este modul în care apelați modelele Gemini din propriul cod în loc de o fereastră de chat: un bot de asistență pe site-ul dvs., un script care triajează biletele, completarea codului într-un editor, o integrare CRM. Ruta clasică necesită un cont Google, configurarea facturării în cloud și un card străin. Pe NeuralSpace calea este mai scurtă: o cheie este creată în tabloul de bord în aproximativ un minut, modelul este apelat cu o solicitare compatibilă cu OpenAI și plătiți dintr-un sold simbol - fără abonament. Mai jos este un ghid pas cu pas: cum să obțineți o cheie, cum arată primul dvs. apel la Gemini 3.8 Flash și cât costă jetoanele.

Ce este Gemini API și cine are nevoie de el

Gemini este familia de modele de limbaj a lui Google. Prin API este deschis dezvoltatorilor: trimiteți o serie de mesaje, obțineți un răspuns generat și îl utilizați în produsul dvs. - îl arătați utilizatorului, îl stocați, îl procesați în continuare. Cazuri de utilizare tipice: suport chatbot, rezumarea e-mail-urilor și documentelor, extragerea datelor structurate din text, redactarea conținutului, automatizarea rutinei în scripturi. Gemini 3.8 Flash din catalogul NeuralSpace este ramura rapidă a familiei: un echilibru între viteză și preț care se potrivește dialogurilor și procesării de text în bloc.

Pasul 1. Obțineți o cheie

  1. Înscrieți-vă pe NeuralSpace cu e-mailul dvs. - durează mai puțin de un minut. Utilizatorii noi primesc imediat jetoane de pornire, suficiente pentru primele API apeluri fără reîncărcare.
  2. Deschideți API pagina de taste în tabloul de bord și creați o cheie. Cheia arată ca BLK0 și este afișată o dată - salvați-o imediat într-un manager de parole sau într-o variabilă de mediu, nu în depozitul dvs.
  3. Verificați-vă soldul: modelele text necesită un minim de 50 de jetoane în cont. Încărcările au loc în tabloul de bord — fără carduri străine, fără taxe de abonament.
Pagina taste NeuralSpace API: crearea unei chei pentru Gemini API

Pasul 2. Apelați modelul

Gemini în public API funcționează prin punctul final compatibil OpenAI BLK1: corpul transportă modelul, o matrice BLK2 cu roluri de sistem/utilizator/asistent și limita BLK3. O cerere minimă de bucle:

BLK4

Răspunsul revine în format OpenAI: textul generat este în BLK5, utilizarea reală este în BLK6. Dacă aveți deja codul OpenAI SDK, exact două valori se schimbă - base_url și cheia:

BLK7

Interfețele de chat beneficiază de streaming: adăugați BLK8 și răspunsul ajunge în bucăți prin Evenimente trimise de server, astfel încât utilizatorul să vadă primele cuvinte înainte de finalizarea generației.

Pasul 3. Aflați cât costă

Facturarea este măsurată: jetoanele de intrare (promptul dvs.) și jetoanele de ieșire (răspunsul modelului) sunt numărate separat, fiecare cu propriul preț per milion. Pentru Gemini 3.8 Flash, la momentul scrierii, este de 33,5 jetoane per milion de intrare și 168 de jetoane pe milion de ieșire. O solicitare tipică de „2.000 de jetoane de context + 500 de jetoane de ieșire” costă aproximativ 0,15 jetoane. Prețul este legat de cursul de schimb și plutește, așa că verificați tabelul live înainte de a face calculul: este publicat pe API pagina de documentație și returnat în formă care poate fi citită de mașină de către BLK9. Pentru comparație: DeepSeek V4 Flash din același catalog este de 21/42 de jetoane per milion, modelele Claude sunt vizibil mai scumpe; Gemini 3.8 Flash se află în mijlocul prețului în timp ce răspunde rapid.

Două limite de servicii: 60 de solicitări pe minut per cheie și un sold minim de 50 de jetoane pentru modelele text. Soldul actual este disponibil prin BLK10 , taxele apar în istoricul tranzacțiilor din profilul dvs.

Gemini pe site — nu este nevoie de cod

Dacă încă nu aveți nevoie de API, aceleași modele trăiesc în interfață: alegeți Gemini 3.8 Flash în chat — căutarea pe web este activată acolo — iar pentru imagini generare de imagini secțiunea oferă Nano Banana, un model bazat pe Gemini 2.5 Flash. Soldul este împărțit: chat și API trag din același cont.

Erori frecvente la prima solicitare

  • 401 Neautorizat — cheia a fost transmisă incorect: un spațiu suplimentar, o valoare trunchiată, un prefix greșit. Tasta completă merge după BLK11 sau în antetul BLK12.
  • 429 Prea multe cereri — ați atins limita de 60 de solicitări pe minut. Adăugați o pauză sau o coadă de partea dvs.
  • Eroare de echilibru — mai puțin de 50 de jetoane în cont: încărcați în tabloul de bord și încercați din nou.
  • Cheia s-a scurs în git — păstrați-l în variabilele de mediu (.env) și nu îl comiteți niciodată; dacă se scurge, reemite cheia pe aceeași pagină de chei API.

FAQ

Am nevoie de un cont de Google sau de un card străin?

Nu. Cheia este emisă în tabloul de bord NeuralSpace și plătiți dintr-un sold de simboluri: facturare pe bază de simboluri, fără abonament, fără facturare în cloud.

Cât costă un apel Gemini API?

Doar jetoanele reale: la momentul scrierii, 33,5 jetoane pe milion de intrare și 168 pe milion de ieșire pentru Gemini 3,8 Flash; o cerere de câteva mii de jetoane este de aproximativ 0,15 jetoane. Prețurile actuale sunt în BLK13 și în tabelul de documentație.

Există un nivel gratuit?

Nu există generații libere pe platformă. Utilizatorii noi primesc jetoane de pornire – suficiente pentru primele experimente – după aceea plătiți pe token fără taxă de abonament.

Ce altceva poate face API în afară de text?

Cu aceeași cheie obțineți generarea de imagini, videoclipuri și muzică, sinteză și recunoaștere a vorbirii și un server MCP la https://neuralspace.pro/mcp pentru agenții AI. Lista completă a punctelor finale se află în documentație.