← Все статьи

Gemini API: jak získat klíč, zavolat model a kolik tokenů stojí

Gemini API: jak získat klíč, zavolat model a kolik tokenů stojí

Gemini API je způsob, jakým voláte modely Gemini z vašeho vlastního kódu místo z chatovacího okna: podpůrný bot na vašem webu, skript, který třídí vstupenky, dokončování kódu v editoru, integrace CRM. Klasická cesta vyžaduje účet Google, nastavení cloudové fakturace a zahraniční kartu. Na NeuralSpace je cesta kratší: klíč se na vašem řídicím panelu vytvoří přibližně za minutu, model se zavolá s požadavkem kompatibilním s OpenAI a platíte ze zůstatku tokenů – žádné předplatné. Níže je krok za krokem průvodce: jak získat klíč, jak vypadá vaše první volání do Gemini 3.8 Flash a kolik stojí tokeny.

Co je Gemini API a kdo ho potřebuje

Gemini je rodina jazykových modelů Google. Prostřednictvím API je otevřena vývojářům: odešlete řadu zpráv, získáte vygenerovanou odpověď a použijete ji ve svém produktu — ukážete ji uživateli, uložíte, dále zpracujete. Typické případy použití: podpora chatbotů, sumarizace e-mailů a dokumentů, extrahování strukturovaných dat z textu, navrhování obsahu, automatizace rutiny ve skriptech. Gemini 3.8 Flash v katalogu NeuralSpace je rychlá větev rodiny: rovnováha rychlosti a ceny, která se hodí pro dialogy a hromadné zpracování textu.

Krok 1. Získejte klíč

  1. Zaregistrujte se na NeuralSpace pomocí svého e-mailu – zabere to méně než minutu. Novým uživatelům jsou okamžitě připsány startovací tokeny, které stačí na první volání API bez dobíjení.
  2. Otevřetestránka API klíčena palubní desce a vytvořte klíč. Klíč vypadá jako nsk-… a je zobrazen jednou – okamžitě jej uložte do správce hesel nebo proměnné prostředí, nikoli do svého úložiště.
  3. Zkontrolujte svůj zůstatek: textové modely vyžadují na účtu minimálně 50 tokenů. Dobíjení probíhá na řídicím panelu – žádné zahraniční karty, žádné poplatky za předplatné.
The NeuralSpace API keys page: creating a key for the Gemini API

Krok 2. Zavolejte modelu

Gemini ve veřejném rozhraní API funguje prostřednictvím koncového bodu kompatibilního s OpenAI POST /v1/chat/completions: tělo nese model, pole messages s rolemi systém / uživatel / asistent a limit max_tokens. Minimální požadavek na zvlnění:

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

Odpověď se vrací ve formátu OpenAI: vygenerovaný text je ve formátu choices[0].message.content, skutečné využití je ve formátu usage. Pokud již máte kód OpenAI SDK, změní se přesně dvě hodnoty — base_url a klíč:

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)

Rozhraní chatu těží ze streamování: přidejte "stream": true a odpověď dorazí po částech prostřednictvím událostí odeslaných serverem, takže uživatel uvidí první slova před dokončením generování.

Krok 3. Vědět, co to stojí

Fakturace je měřena: vstupní tokeny (vaše výzva) a výstupní tokeny (odpověď modelu) se počítají samostatně, každý s vlastní cenou za milion. Pro Gemini 3.8 Flash je to v době psaní tohoto článku 33,5 tokenů na milion vstupu a 168 tokenů na milion výstupu. Typický požadavek „2 000 kontextových tokenů + 500 výstupních tokenů“ stojí asi 0,15 tokenů. Cena je závislá na směnném kurzu a je pohyblivá, proto před provedením výpočtu zkontrolujte aktuální tabulku: je zveřejněna nastránka dokumentace APIa GET /v1/models vrátil ve strojově čitelné podobě. Pro srovnání: DeepSeek V4 Flash ve stejném katalogu je 21/42 tokenů na milion, modely Claude jsou znatelně dražší; Gemini 3.8 Flash stojí uprostřed ceny a zároveň rychle odpovídá.

Dva limity služeb: 60 požadavků za minutu na klíč a minimální zůstatek 50 tokenů pro textové modely. Aktuální zůstatek je k dispozici prostřednictvím GET /v1/balance, poplatky se zobrazují v historii transakcí vašeho profilu.

Blíženci na webu – není potřeba žádný kód

Pokud API ještě nepotřebujete, stejné modely žijí v rozhraní: vyberte Gemini 3.8 Flash vpovídání— tam je povoleno vyhledávání na webu — a pro obrázkygenerování obrazusekce nabízí Nano Banana, model založený na Gemini 2.5 Flash. Zůstatek je sdílen: chat a API čerpají ze stejného účtu.

Běžné chyby prvního požadavku

  • 401 Neoprávněně— klíč byl předán nesprávně: mezera navíc, zkrácená hodnota, nesprávná předpona. Úplný klíč se nachází za Bearer nebo v záhlaví x-api-key.
  • 429 Příliš mnoho požadavků— dosáhli jste limitu 60 požadavků za minutu. Přidejte pauzu nebo frontu na vaší straně.
  • Chyba vyvážení— méně než 50 tokenů na účtu: doplňte na řídicím panelu a zkuste to znovu.
  • Klíč unikl do git— ponechat jej v proměnných prostředí (.env) a nikdy jej nepotvrdit; pokud unikne, znovu zadejte klíč na stejné stránce klíčů API.

FAQ

Potřebuji účet Google nebo zahraniční kartu?

Ne. Klíč je vydán na vašem řídicím panelu NeuralSpace a platíte ze zůstatku tokenů: fakturace na základě tokenů, žádné předplatné, žádná cloudová fakturace.

Kolik stojí volání Gemini API?

Pouze skutečné tokeny: v době psaní článku 33,5 tokenů na milion vstupu a 168 na milion výstupu pro Gemini 3.8 Flash; požadavek na několik tisíc tokenů je zhruba 0,15 tokenů. Aktuální ceny jsou v GET /v1/models a v tabulce dokumentace.

Existuje volná úroveň?

Na platformě nejsou žádné volné generace. Noví uživatelé dostanou startovací tokeny – dostačující pro první experimenty – poté platíte za token bez poplatku za předplatné.

Co jiného umí API kromě textu?

Se stejným klíčem získáte generování obrazu, videa a hudby, syntézu a rozpoznávání řeči a server MCP na https://neuralspace.pro/mcp pro agenty AI. Úplný seznam koncových bodů je v dokumentaci.