# Gapli AI Hub

> Moduł WordPress/WooCommerce GAPLI (`gapli-ai-hub`) · kategoria: AI · aktualna wersja 1.6.4 · WordPress 6.0+ · WooCommerce 10.0+ · PHP 8.0+  
> Wersja HTML: https://gapli.com/docs/ai-hub

Jedno miejsce na klucze API dostawców AI (Anthropic, OpenAI, Google, OpenRouter) oraz kontrolę kosztów i budżetu. Korzystają z niego Google Merchant, Cart Recovery i Product Image Studio.

## Gdzie go znajdziesz

Gapli → 🤖 AI Hub, zakładki: Dostawcy AI, Modele, Domyślne, Koszty, Limity, Diagnostyka.

## Pierwsze uruchomienie

1. Na zakładce Dostawcy AI wpisz „Klucz API” co najmniej jednego dostawcy i włącz przełącznik „Aktywny”. Link „Pobierz klucz z …” prowadzi do strony dostawcy.
2. Kliknij „Testuj połączenie”, żeby sprawdzić klucz.
3. Na zakładce Limity ustaw budżet. Domyślnie: 10 USD dziennie, 200 USD miesięcznie, alert przy 80% wykorzystania. W polu „E-mail powiadomień” wpisz adres, na który ma przyjść alert (domyślnie e-mail administratora WordPressa; puste pole wyłącza e-maile).
4. Na zakładce Domyślne wybierz modele dla Google Merchant, Cart Recovery i Product Image Studio.

## Co dzieje się automatycznie

- Co 6 godzin zlicza zużycie i sprawdza budżet; raz dziennie testuje klucze API.
- Po przekroczeniu progu alertu pokazuje komunikat w kokpicie WordPressa i wysyła e-mail na „E-mail powiadomień” — najwyżej raz na dobę dla budżetu dziennego i raz na miesiąc dla miesięcznego.
- Po przekroczeniu budżetu przełącza na tańszy model (auto-fallback, domyślnie włączony) albo odmawia kolejnych zapytań.

## Wymagania i powiązane moduły

- Gapli Full Dropshipping — bez niej ekran modułu nie pojawi się w menu.
- Własny klucz API u wybranego dostawcy AI — koszty zapytań rozlicza dostawca.

## Gdy coś nie działa

- **„Dzienny/Miesięczny budżet AI wykorzystany w X%”** — Podnieś limit na zakładce Limity albo poczekaj na nowy dzień lub miesiąc.
- **„🚨 Wykryto problem z kluczami API dostawców AI”** — Popraw klucz wskazanego dostawcy i kliknij „Testuj połączenie”. Sprawdź też, czy konto u dostawcy ma środki.
- **„Brak aktywnych dostawców AI!”** — Włącz przełącznik „Aktywny” przy co najmniej jednym dostawcy z poprawnym kluczem.