Konfiguracja własnego API Immersive Translate

Otwórz ustawienia usługi OpenAI

Oficjalna strona usługi OpenAI w Immersive Translate dokumentuje własny adres API w More Settings. Zacznij od niej przy ocenie endpointu zgodnego z OpenAI. Zapisz wersję rozszerzenia i przeglądarkę, aby późniejsza kontrola konfiguracji odnosiła się do powtarzalnego środowiska.

Na pierwszy test wybierz jedną konfigurację i zachowaj ustawienia domyślne jako ścieżkę odzyskiwania. Dane uwierzytelniające wpisuj wyłącznie w prywatnych ustawieniach rozszerzenia. Potwierdź, że endpoint jest zamierzonym odbiorcą, zanim wyślesz treść strony, szczególnie gdy przeglądarka ma także dostęp do ekranów administracyjnych sprzedawcy.

Sprawdź, czy adres jest bazą czy pełną trasą

Nie zakładaj, że każde pole własnego adresu działa jak baseURL SDK. Oficjalna strona zawiera pełny URL chat-completions w przykładzie Azure. Przeanalizuj tekst pomocy zainstalowanego rozszerzenia i oczyszczoną ścieżkę wychodzącego żądania, aby ustalić, jak używany jest adres.

Dla kandydata czatu APIsRouter pełna trasa to https://api.apisrouter.com/v1/chat/completions. Jeśli zainstalowana wersja wyraźnie oczekuje bazowego URL i dołącza trasę, użyj https://api.apisrouter.com/v1 zamiast pełnej trasy. Unikaj podwójnego sufiksu chat/completions. Poniższy arkusz opisuje ustawienia kandydackie, a nie przetestowaną konfigurację rozszerzenia.

Service: OpenAI
Settings area: More Settings > custom API address
Full request URL candidate: https://api.apisrouter.com/v1/chat/completions
Base-only candidate, if required by installed version: https://api.apisrouter.com/v1
Credential: gateway key entered privately
Model: exact current catalog ID with verified chat behavior

Zachowaj widoczność ścieżki żądania tłumaczenia

Rozszerzenie wysyła żądania tłumaczenia na wybrany adres usługi. Traktuj ten adres jako decyzję o udostępnianiu danych, a nie tylko pole łączności. Używaj treści, którą posiadasz lub którą możesz przetwarzać przez wybrany endpoint, i przejrzyj, jak dużą część strony obejmuje wybrana akcja tłumaczenia.

Poniższy przepływ ilustruje proponowaną trasę gatewaya z użyciem udokumentowanego mechanizmu własnego adresu. Etykieta wybranego modelu jest wyborem konfiguracji, a nie listą zweryfikowanych modeli. Uwierzytelnianie sklepu, edycja produktów i akceptacja importów są poza tą ścieżką żądania.

Najpierw zweryfikuj jedną kontrolowaną stronę

Użyj krótkiej strony z syntetycznym opisem produktu, chronionym terminem marki, ilością z jednostką i linkiem. Przetłumacz tylko tę stronę. Porównaj widoczny wynik ze źródłem i sprawdź oczyszczone miejsce docelowe sieci, wybrany model oraz status odpowiedzi.

Sprawdź, czy treść nie została pominięta, zduplikowana lub zmieszana z językiem źródłowym. Następnie spróbuj dłuższego akapitu i układu z nagłówkami lub listami. Zachowaj źródło i zaobserwowany wynik, aby późniejszą zmianę konfiguracji można było porównać z tym samym materiałem. Daje to użyteczną bazę diagnostyczną przed przetwarzaniem dużego dokumentu.

Użyj czytania dwujęzycznego do pytań redakcyjnych

Tłumaczenie w przeglądarce może pomóc recenzentowi przejrzeć nieznany materiał źródłowy lub znaleźć frazę wymagającą uwagi. Oryginał pozostaw widoczny i bezpośrednio porównuj twierdzenia, ilości oraz terminologię. Jeśli recenzent nie potrafi ocenić języka docelowego, przekaż kandydata osobie, która potrafi, zamiast uznawać płynny wygląd za dowód.

Decyzje dotyczące glosariusza utrzymuj w procesie katalogu. Nie zakładaj, że własny endpoint zapewnia także egzekwowanie glosariusza lub walidację na poziomie pól w rozszerzeniu. Opisy produktów przeznaczone do importu nadal wymagają własnego kandydata powiązanego ze źródłem, wyniku przeglądu i mapowania celu.

Diagnozuj błędy przed tłumaczeniem większej ilości treści

Zacznij od ścieżki żądania, danych uwierzytelniających i dokładnego identyfikatora modelu. Dostępne błędy ustrukturyzowane zapisuj, a przed udostępnieniem dowodów redaguj nagłówki. Jeśli żądania są ograniczane, zmniejsz obciążenie i respektuj wskazówki dotyczące ponowień usługi, zamiast szybko powtarzać tłumaczenie całej strony.

Użyj mniejszego wybranego fragmentu, aby odróżnić awarię połączenia od problemu treści lub obsługi odpowiedzi. Zmieniaj jedno ustawienie naraz. Oficjalna strona zawiera historyczne przykłady cen i limitów żądań; używaj dokumentacji oraz limitów konta aktualnego endpointu, zamiast kopiować te liczby do nowej konfiguracji.

Oddziel wynik przeglądarki od dostarczania do katalogu

Przetłumaczony widok przeglądarki jest powierzchnią inspekcji. Aby opublikować tekst produktu, utwórz kandydata w pakiecie przeglądu katalogu, zachowaj identyfikatory i rewizje źródeł, a następnie przekaż zaakceptowane pola przez rzeczywisty import sklepu lub API tłumaczeń.

Dostarczanie zweryfikuj, odczytując zapisane pola i otwierając zamierzone locale sklepu. Nie polegaj na rozszerzeniu przeglądarki edytora jako dowodzie tego, co zobaczy zwykły odwiedzający. Użycie żądań tłumaczenia zapisuj osobno od operacji sklepu, a przy ocenie obciążenia uwzględniaj ponowienia. Odwołuj się do aktualnych cen, zamiast zakładać stały koszt strony lub znaku.

Dowody i granice integracji

Oficjalna dokumentacja ustanawia ustawienie własnego adresu. Żądanie z zainstalowanego rozszerzenia przez APIsRouter nie zostało przetestowane na potrzeby tego artykułu, więc dokładne zachowanie adresu, zgodność modelu i renderowany wynik pozostają kontrolami konfiguracji. Diagram jest przykładowym przepływem konfiguracji.

Kompletny rekord zgodności powinien zawierać wersje rozszerzenia i przeglądarki, oczyszczone ustawienia, cel żądania, dokładny model, kontrolowaną stronę źródłową i zaobserwowane tłumaczenie. Przegląd chronionych pól utrzymuj osobno od kontroli transportu. Udany krótki fragment nie waliduje automatycznie każdego formatu dokumentu ani procesu publikacji w sklepie.

Częste pytania