Obsah · Kapitola 7 · Nastavení Gemini

Nastavení Gemini

← Kapitola 7: Administrace a konfigurace

Pro většinu instalací stačí vložit API klíč a nechat výchozí hodnoty. Exponát sám zkusí nejnovější free model a při nedostupnosti přepne na stabilní zálohu (gemini-2.5-flash). Podrobný ceník: Gemini API pricing.

Aktuální konfigurace tohoto exponátu: chat gemini-3.5-flash (free) / gemini-2.5-pro (placený) · aktivní gemini-3.5-flash · TTS gemini-2.5-flash-preview-tts · hlas Kore · tarif free

Postup – první zprovoznění (cca 10 minut)

  1. Získejte API klíč – přihlaste se do Google AI Studio → Create API key. Podporovaný formát: AIzaSy… nebo nový AQ.….
  2. Administrace – otevřete webové rozhraní administrace (výchozí heslo admin123, hned změňte v sekci Bezpečnost).
  3. AI & API → Gemini – vložte klíč do pole Gemini API klíč. Poskytovatel nechte Google Gemini.
  4. Modely – ponechte výchozí: free chat gemini-3.5-flash, placený chat gemini-2.5-pro, tarif Free. Nemusíte nic měnit, dokud nechcete jinou kvalitu nebo billing.
  5. Hlas (sekce Hlas v administraci) – TTS: Gemini TTS, model gemini-2.5-flash-preview-tts, hlas např. Kore, jazyk cs-CZ. Zapněte: automatické čtení odpovědi, nepřetržité poslouchání, barge-in.
  6. Exponát – doplňte název, uvítání, system prompt (kdo jste, co umíte odpovědět). Pro veřejný provoz vypněte testovací režim.
  7. Barvy & motiv – zvolte motiv podle místa provozu (např. Měď pro průmyslový areál) – viz přehled motivů.
  8. Uložit nastavení → otevřete variantu exponátu (doporučeno Rive) → klepněte Start → krátce promluvte.
  9. Kontrola – v administraci sekce Využití API & kredity: klíč „OK“, v tabulce posledních požadavků úspěšný chat. Případně spusťte vestavěnou diagnostiku.

Doporučené profily nastavení

Rychlý start – test / škola

Profil A: Free, minimum práce

  • Poskytovatel: Gemini
  • Tarif: Free
  • Chat: gemini-3.5-flash (výchozí)
  • TTS: Gemini → gemini-2.5-flash-preview-tts
  • Při limitu TTS: automaticky hlas prohlížeče

Proč: Nulové náklady, klíč funguje hned. Vhodné na první test a menší provoz.

Standardní kiosk

Profil B: Free + Rive + teen styl

  • Stejné jako A + varianta Rive (animovaný avatar)
  • Rychlý režim odpovědi, teen omluvy při chybě
  • Idle režim (volitelně) pro mrtvé chvíle – prezentace stránek z administrace
  • Motiv barev podle stanoviště

Proč: Nejlepší poměr vzhled / funkce / cena pro veřejný exponát s mládeží.

Firma / dlouhý provoz

Profil C: Placený tarif

  • V AI Studio zapněte billing
  • Tarif v adminu: Placený
  • Chat: gemini-2.5-pro nebo gemini-3.1-pro-preview
  • TTS: gemini-2.5-pro-preview-tts (kvalitnější hlas)

Proč: Vyšší limity, data se nepoužívají k tréninku, stabilní TTS bez fallbacku prohlížeče.

Výchozí hodnoty v projektu – co znamenají

Nastavení Výchozí hodnota Proč právě tak
ai_provider gemini Nejjednodušší start – free klíč z AI Studio bez OpenAI účtu
tier free Chat na free často stačí; placený zapnete až pro produkci
model_free gemini-3.5-flash Nejnovější free Flash – nejlepší kvalita bez platby
model_paid gemini-2.5-pro Ověřený Pro model po přepnutí na placený tarif
tts_engine + tts_model Gemini + gemini-2.5-flash-preview-tts Stabilní TTS na free; při výpadku záložní hlas Windows/Chrome
response_mode fast Kratší odpovědi = rychlejší reakce u kiosku a nižší spotřeba tokenů
test_mode true (vývoj) Pro návštěvníky vždy vypnout – uvidí jen přátelskou omluvu, ne technickou chybu

Automatický fallback chat modelů

Když zvolený model na vašem klíči není dostupný, exponát v tomto pořadí zkusí další (free tarif):

  1. gemini-3.5-flash – výchozí volba
  2. gemini-2.5-flash – stabilní záloha
  3. gemini-3-flash-preview
  4. gemini-2.5-flash-lite

Aktuálně aktivní model v konfiguraci: gemini-3.5-flash. Řetězec pro tento exponát: gemini-3.5-flash → gemini-2.5-flash → gemini-3-flash-preview → gemini-2.5-flash-lite.

Dostupné modely v administraci

Kompletní tabulka s cenami je v adminu pod výběrem modelu (rozbalit „Přehled modelů“).

Chat model Free Placený Kdy zvolit
gemini-2.5-flash-lite ✓ ✓ Nejlevnější chat – vysoký provoz, jednoduché odpovědi, firemní kiosky s návštěvností.
gemini-2.5-flash-lite-preview-09-2025 ✓ ✓ Preview varianta Flash-Lite – stejné použití jako Lite.
gemini-2.5-flash ✓ ✓ Stabilní záloha – použije se automaticky, pokud novější model na klíči není dostupný.
gemini-2.5-pro ✓ ✓ Složitější dotazy, odborné expozice, firemní prezentace s vyšší přesností.
gemini-3-flash-preview ✓ ✓ Novější Flash – rychlost + grounding (preview, může se měnit).
gemini-3.1-flash-lite ✓ ✓ Úsporný model 3.1 – vhodný pro velký objem dotazů na placeném tarifu.
gemini-3.5-flash ✓ ✓ Nejnovější free model – výchozí po vložení API klíče. Při nedostupnosti se zkusí 2.5 Flash.
gemini-3.1-pro-preview — ✓ Nejvyšší kvalita odpovědí – firmy, náročné expozice (vyžaduje paid billing).
TTS model Free Placený Kdy zvolit
gemini-2.5-flash-preview-tts ✓ ✓ Výchozí hlas exponátu – přirozená řeč, nízká latence.
gemini-2.5-pro-preview-tts — ✓ Kvalitnější hlas pro reprezentativní firemní provoz.
gemini-3.1-flash-tts-preview ✓ ✓ Novější TTS – preview, může mít přísnější rate limity.

Časté problémy a řešení

  • Exponát nemluví / chybí klíč – doplňte klíč v adminu, obnovte stránku (F5).
  • Špatný formát klíče – Gemini klíč do pole Gemini, OpenAI sk-… jen pokud máte aktivní ChatGPT.
  • TTS nefunguje na free – normální; exponát přepne na hlas prohlížeče nebo zapněte placený tarif.
  • Vyčerpán limit – počkejte 1–2 minuty nebo přejděte na placený billing.
  • Prepaid credits depleted – dobijte kredit v AI Studio → Projects → Billing.

Výběr AI poskytovatele (Gemini vs OpenAI)

  • Gemini – pole api_key, modely v adminu (viz výše)
  • ChatGPT (OpenAI) – pole openai_api_key, varianty modelu v adminu – vhodné pokud máte firemní OpenAI smlouvu
  • Oba klíče můžete mít uložené; aktivní je jen ten podle ai_provider
  • Chat i TTS směruje podle zvoleného poskytovatele (u D-ID včetně video vrstvy)