Jak skonfigurować OpenRouter (tłumaczenie AI) w module PrestaShop Translator (PShowTranslate)?

OpenRouter to platforma (agregator) dająca dostęp do wielu modeli AI różnych dostawców (OpenAI ChatGPT/GPT, Google Gemini, Anthropic Claude, DeepSeek i innych) przez jeden klucz API. Sam w sobie nie jest silnikiem tłumaczenia - właściwe tłumaczenie wykonuje model AI, który wybierzesz. Dzięki temu można dobrać model pod jakość i budżet. Funkcja dostępna w licencji Pro modułu.

Koszt tłumaczenia zależy od wybranego modelu - rozliczenie jest kredytowe (pay-as-you-go) z konta OpenRouter, według cennika danego modelu (płatność za tzw. tokeny, czyli fragmenty tekstu wejściowego i wyjściowego). Nie ma darmowego limitu znaków jak w DeepL.

Różnice względem DeepL:
- Płatność za realne zużycie z konta OpenRouter (doładowujesz kredyty).
- OpenRouter (AI) nie obsługuje glosariuszy - glosariusze działają tylko z DeepL.
- Można ustawić własny system prompt (kontekst, słownictwo, ton tłumaczenia).

Krok 1 - Konto i klucz API OpenRouter
1. Załóż konto na https://openrouter.ai
2. Doładuj konto kredytami (zakładka Credits).
3. Utwórz klucz API na https://openrouter.ai/keys - klucz zaczyna się od sk-or-.... Skopiuj go.

Krok 2 - Wybór silnika w module
1. Wejdź do modułu, zakładka Translator (menu boczne modułu).
2. W panelu Translator provider zaznacz OpenRouter (AI).
3. Jeśli opcja jest wyszarzona z dopiskiem „(Pro only)" - posiadana licencja to Lite; OpenRouter wymaga licencji Pro.

Krok 3 - Konfiguracja
W panelu OpenRouter translator uzupełnij:
- OpenRouter API key - wklej klucz sk-or-....
- Model - identyfikator modelu z OpenRouter (patrz rekomendacje niżej). Pełna, aktualna lista i ceny: https://openrouter.ai/models
- System prompt (opcjonalnie) - opis kontekstu, słownictwa i tonu (np. „sklep z elektroniką, ton formalny, nazwy marek i kody produktów zostaw nieprzetłumaczone"). Reguł technicznych (zachowanie tagów HTML, placeholderów, format JSON) nie trzeba wpisywać - są wymuszane automatycznie.

Kliknij Save. Moduł zweryfikuje klucz i pokaże saldo konta oraz zużycie. Status zmienia się wtedy na „Translator is ready to use!".

Krok 4 - Tłumaczenie
Wybierz język źródłowy i docelowy oraz zakres („What to translate") i uruchom tłumaczenie tak samo jak przy DeepL.

Jaki model wybrać (ceny orientacyjne za 1 mln tokenów wejścia/wyjścia, stan 07.2026 - aktualne sprawdź na https://openrouter.ai/models):
- Tanio i dobre jakościowo (polecane do dużych wolumenów, np. kart produktów): openai/gpt-4o-mini - ~$0.15 / ~$0.60. Model OpenAI (ChatGPT) o bardzo dobrym stosunku jakości do ceny.
- Drożej, wyższa jakość (teksty wrażliwe na ton: regulaminy, strony informacyjne, treści marketingowe): openai/gpt-4.1 - ~$2.00 / ~$8.00.
- Alternatywnie do najlepszej jakości niuansów językowych: anthropic/claude-sonnet-4.5 - ~$3.00 / ~$15.00.

Wskazówka: karty produktów tłumacz tańszym modelem, a teksty ważne wizerunkowo (regulaminy, strony informacyjne) - droższym. Przed uruchomieniem całości przetłumacz kilka pozycji i oceń jakość.

Uwagi:
- Przed tłumaczeniem wykonaj kopię bazy danych i plików - proces wprowadza nieodwracalne zmiany.
- Przy dużej ilości danych i błędach zwiększ max_execution_time w konfiguracji PHP, np. do 120.
- Gdy skończą się kredyty na koncie OpenRouter, tłumaczenie zatrzyma się z komunikatem o ich wyczerpaniu - doładuj konto.