Wprowadzenie do konfiguracji modeli
W tym samouczku wyjaśniono, jak skonfigurować różne duże modele językowe w SelectTranslate rozszerzenie, w tym API keys, adresy URL punktów końcowych, wybór modelu, parametry wydajności i ustawienia podpowiedzi. Właściwa konfiguracja modelu może poprawić stabilność usługi i zwiększyć dokładność tłumaczenia, szybkość reakcji i ogólne wrażenia użytkownika w różnych scenariuszach tłumaczeń.
1. Skonfiguruj API Key
An API key to oficjalne dane uwierzytelniające udostępniane przez dostawcę usług modelowych, używane do bezpiecznego wywoływania AI modele i powiązane usługi.
Powszechne API Key Problemy z konfiguracją
- Niepoprawne API Key Format: The API key może zawierać brakujące znaki, dodatkowe spacje lub być nieprawidłowo obcięte. Pamiętaj, aby skopiować pełny klucz dostarczony przez usługę i unikać dodawania spacji, podziałów wierszy lub innych nieprawidłowych znaków.
- API Key Niezgodność z Usługodawcą: API keys od różnych dostawców modeli nie są zamienne. Na przykład: OpenAI API key nie można używać z DeepSeek modele.
- API Key Wygasłe lub wyłączone: Twoje API key mogła zostać unieważniona z powodu wygaśnięcia, ręcznej dezaktywacji, problemów z kontem, limitów użytkowania lub ze względów bezpieczeństwa. Odwiedź konsolę swojego dostawcy, aby sprawdzić bieżący stan swojego API key.
- Błąd adresu URL punktu końcowego: Nawet przy prawidłowym API Key, testy połączenia mogą zakończyć się niepowodzeniem, jeśli adres URL punktu końcowego jest nieprawidłowy, brakuje ścieżek wersji lub nie odpowiada konkretnym wymaganiom dostawcy.
- Niezgodność nazwy modelu: Upewnij się, że nazwa modelu została wpisana poprawnie i jest oficjalnie obsługiwana przez Twojego dostawcę. Błędy typograficzne są tu często błędnie identyfikowane jako API Key problemy.
- Problemy z siecią lub serwerem proxy: Stabilność sieci lokalnej, konfiguracje proxy lub ograniczenia zapory sieciowej mogą blokować żądania, powodując błędy uwierzytelniania lub przekroczenia limitu czasu żądań.
2. Wybór modelu tłumaczenia
Podczas konfigurowania rozszerzenia nazwa modelu musi być zgodna z usługodawcą powiązanym z API key; w przeciwnym razie nie będzie można pomyślnie wywołać modelu.
Obsługiwani dostawcy i mapowanie modeli
| Dostawca | Nazwa modelu |
|---|---|
| OpenAI | gpt-5、gpt-5-mini、gpt-5-nano |
| Gemini | gemini-2.5-flash、gemini-2.0-flash-lite |
3. Niestandardowe API Adres URL
Rozszerzenie korzysta z oficjalnego API Domyślny adres URL, więc zazwyczaj nie są potrzebne żadne dostosowania. Ręczne wprowadzenie adresu URL jest wymagane tylko w następujących przypadkach:
- Wywołanie modelu poprzez usługę odwrotnego proxy lub przekaźnika,
- Korzystając z prywatnie wdrożonej usługi dużego modelu,
- Łączenie się z osobą trzecią API usług, które nie korzystają w pełni z oficjalnego domyślnego adresu URL.
Wytyczne wejściowe:
- Adres URL musi być kompletnym punktem końcowym HTTPS, na przykład:
https://api.your-company.com/v1/chat/completions - Ścieżka punktu końcowego musi być zgodna z dokumentacją techniczną dostawcy usług, a API musi poprawnie odbierać i obsługiwać żądania zgodne z określonym formatem.
4. Strojenie parametrów modelu
Poniższe parametry służą do dostosowywania jakości tłumaczenia, stabilności modelu i szybkości odpowiedzi. Ustawienia domyślne obejmują większość przypadków użycia; dostosować je w zależności od potrzeb do konkretnych wymagań.
| Parametry | Opis | Zalecane ustawienia |
|---|---|---|
| Maksymalna długość tekstu na żądanie | Używane do ograniczenia maksymalnej liczby znaków, które można przesłać w jednym zamówieniu na tłumaczenie. Ustawienie zbyt dużej wartości może spowodować spowolnienie API odpowiedzi; utrzymywanie go w rozsądnym zakresie pomaga poprawić stabilność i szybkość reakcji. | - Zalecane 1000–1500 postacie- Unikaj przekraczania 2000 znaków, aby zapobiec opóźnieniom w odpowiedzi lub utracie treści. |
| Maksymalna liczba akapitów na żądanie | Liczba akapitów, które można przesłać jednocześnie w jednym zamówieniu na tłumaczenie. Przesłanie zbyt wielu akapitów na raz może zwiększyć obciążenie przetwarzania, prowadząc do wolniejszych odpowiedzi lub zmniejszonej stabilności. Odpowiednie ustawienie tej wartości pomaga poprawić ogólną wydajność i niezawodność tłumaczenia. | - Teksty techniczne lub prawne:1(przetwarzaj akapit po akapicie, aby zapewnić dokładność terminologii)- Powieści, dialogi lub blogi: 3–5(poprawia płynność) |
| Maksymalna liczba żądań na sekundę | Liczba próśb o tłumaczenie wysłanych na sekundę. Jeśli liczba żądań jest zbyt wysoka, dodatkowe żądania zostaną umieszczone w kolejce, aby uniknąć trafienia API limitów szybkości transmisji i utrzymania ogólnej stabilności systemu. | - Ogólne zastosowanie:25- Usługi o ściśle określonych stawkach (np. Gemini): 8–10 |
| Temperatura | Kontroluje losowość i zmienność wyników modelu. Wyższe wartości temperatury dają bardziej zróżnicowane i kreatywne odpowiedzi, podczas gdy niższe wartości dają bardziej stabilne wyniki, co jest preferowane w przypadku spójnych i dokładnych tłumaczeń. | - Zalecenia dotyczące zadań tłumaczeniowych: Oficjalne zalecane temperatury różnią się w zależności od modelu. Sugeruje się użycie podanej wartości domyślnej i dostosowanie w razie potrzeby. |
5. Podpowiedzi niestandardowe (podpowiedź systemowa/podpowiedź użytkownika)
Rozszerzenie zawiera wbudowane, zoptymalizowane ogólne podpowiedzi do tłumaczenia, które obejmują najczęstsze scenariusze tłumaczeń. Jeśli istnieją określone wymagania — takie jak styl tłumaczenia, spójność terminologii, wiedza dziedzinowa lub preferencje tonu — można zastosować niestandardowe podpowiedzi w celu dostrojenia wyników modelu.
Podczas tworzenia niestandardowych podpowiedzi do tłumaczenia zaleca się przestrzeganie następujących wskazówek:
- Jasne i szczegółowe instrukcje: Jasno określ język docelowy, styl tłumaczenia, domenę oraz wszelkie wyrażenia i słowa, których należy unikać.
- Instrukcje, które można zastosować: Używaj konkretnych i precyzyjnych opisów, unikając niejasnych lub abstrakcyjnych stwierdzeń, aby mieć pewność, że model dokładnie zrozumie instrukcje i będzie ich przestrzegał.
- Zachowuj zwięzłe podpowiedzi: Upewnij się, że podpowiedź zawiera wystarczające informacje, a jednocześnie jest krótka i pozwala uniknąć zbędnych szczegółów, które mogłyby zakłócać zrozumienie modelu.
6. Zastrzeżenie
🔔 Aby uniknąć nieoczekiwanych kosztów, należy pamiętać o poziomie bezpłatnym i wszelkich opłatach pobieranych przez usługodawcę.