Einrichtung einer benutzerdefinierten Immersive-Translate-API

Öffnen Sie die OpenAI-Serviceeinstellungen

Die offizielle OpenAI-Service-Seite von Immersive Translate dokumentiert eine benutzerdefinierte API-Adresse unter More Settings. Beginnen Sie dort, wenn Sie einen OpenAI-kompatiblen Endpunkt bewerten. Erfassen Sie Erweiterungsversion und Browser, damit sich eine spätere Einrichtungsprüfung auf eine reproduzierbare Umgebung bezieht.

Wählen Sie für den ersten Test eine Konfiguration und halten Sie Standardeinstellungen zur Wiederherstellung verfügbar. Geben Sie Zugangsdaten nur in den privaten Erweiterungseinstellungen ein. Bestätigen Sie, dass der Endpunkt der vorgesehene Empfänger ist, bevor Sie Seiteninhalte senden, besonders wenn der Browser auch Zugriff auf Händlerverwaltungsseiten hat.

Prüfen Sie, ob die Adresse eine Basis oder vollständige Route ist

Nehmen Sie nicht an, dass jedes Feld für eine benutzerdefinierte Adresse wie eine SDK-baseURL funktioniert. Die offizielle Seite enthält in ihrem Azure-Beispiel eine vollständige Chat-Completions-URL. Prüfen Sie Hilfetext Ihrer installierten Erweiterung und den bereinigten ausgehenden Anfragepfad, um festzustellen, wie die Adresse verwendet wird.

Für einen APIsRouter-Kandidaten mit Chat Completions lautet die vollständige Route https://api.apisrouter.com/v1/chat/completions. Wenn Ihre installierte Version ausdrücklich eine Basis-URL erwartet und die Route anhängt, verwenden Sie stattdessen https://api.apisrouter.com/v1. Vermeiden Sie ein doppeltes chat/completions-Suffix. Das folgende Arbeitsblatt beschreibt mögliche Einstellungen und keine getestete Erweiterungskonfiguration.

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

Halten Sie den Übersetzungsanfragepfad sichtbar

Die Erweiterung sendet Übersetzungsanfragen an die ausgewählte Serviceadresse. Behandeln Sie diese Adresse als Entscheidung zur Datenweitergabe und nicht nur als Verbindungsfeld. Verwenden Sie Inhalte, die Sie besitzen oder über den ausgewählten Endpunkt verarbeiten dürfen, und prüfen Sie, wie viel einer Seite die ausgewählte Übersetzungsaktion umfasst.

Der folgende Ablauf illustriert den vorgeschlagenen Gateway-Pfad über den dokumentierten Mechanismus für benutzerdefinierte Adressen. Das ausgewählte Modelllabel ist eine Konfigurationsentscheidung und keine Liste verifizierter Modelle. Shop-Authentifizierung, Produktbearbeitung und Importfreigaben liegen außerhalb dieses Anfragepfads.

Überprüfen Sie zuerst eine kontrollierte Seite

Verwenden Sie eine kurze Seite mit synthetischer Produktbeschreibung, geschütztem Markenbegriff, einer Menge mit Einheit und einem Link. Übersetzen Sie nur diese Seite. Vergleichen Sie sichtbares Ergebnis mit der Quelle und prüfen Sie bereinigtes Netzwerkziel, ausgewähltes Modell und Antwortstatus.

Prüfen Sie, ob Inhalte ausgelassen, dupliziert oder mit der Quellsprache vermischt werden. Testen Sie anschließend einen längeren Absatz und ein Layout mit Überschriften oder Listen. Speichern Sie Quelle und beobachtete Ausgabe, damit eine spätere Konfigurationsänderung mit demselben Material verglichen werden kann. So erhalten Sie eine nützliche Diagnosebasis, bevor Sie ein großes Dokument verarbeiten.

Verwenden Sie zweisprachiges Lesen für redaktionelle Fragen

Browserübersetzung kann einem Prüfer helfen, unbekanntes Quellenmaterial zu untersuchen oder eine prüfbedürftige Formulierung zu erkennen. Lassen Sie das Original sichtbar und vergleichen Sie Aussagen, Mengen und Terminologie direkt. Wenn der Prüfer die Zielsprache nicht beurteilen kann, geben Sie den Kandidaten an eine dazu fähige Person weiter, statt flüssiges Aussehen als Beleg zu akzeptieren.

Halten Sie Glossarentscheidungen im Katalog-Workflow. Nehmen Sie nicht an, ein benutzerdefinierter Endpunkt liefere innerhalb der Erweiterung auch Glossarregeln oder Feldvalidierung. Für den Import bestimmte Produktbeschreibungen benötigen weiterhin eigenen quellenverknüpften Kandidaten, eigenes Prüfergebnis und eigene Zielzuordnung.

Diagnostizieren Sie Fehler, bevor Sie weitere Inhalte übersetzen

Beginnen Sie mit Anfragepfad, Zugangsdaten und exakter Modell-ID. Erfassen Sie strukturierte Fehler, sofern verfügbar, und bereinigen Sie Header vor dem Teilen von Belegen. Wenn Anfragen begrenzt sind, reduzieren Sie die Arbeit und beachten Sie die Wiederholungshinweise des Dienstes, statt eine vollständige Seitenübersetzung schnell mehrfach zu senden.

Verwenden Sie eine kleinere ausgewählte Passage, um Verbindungsfehler von Problemen bei Inhalt oder Antwortverarbeitung zu unterscheiden. Ändern Sie jeweils nur eine Einstellung. Die offizielle Seite enthält historische Preis- und Anfrageratenbeispiele; verwenden Sie stattdessen Dokumentation und Kontolimits Ihres aktuellen Endpunkts und übertragen Sie diese Zahlen nicht in eine neue Einrichtung.

Trennen Sie Browserausgabe von Katalogauslieferung

Eine übersetzte Browseransicht ist eine Prüfoberfläche. Erstellen Sie für die Veröffentlichung von Produkttext einen Kandidaten im Katalog-Prüfpaket, bewahren Sie IDs und Quellenrevisionen auf und geben Sie anschließend freigegebene Felder über die tatsächliche Import- oder Übersetzungs-API des Shops weiter.

Prüfen Sie die Auslieferung, indem Sie gespeicherte Felder lesen und das vorgesehene Shop-Locale öffnen. Verlassen Sie sich nicht auf eine Browsererweiterung des Redakteurs als Beleg dafür, was ein gewöhnlicher Besucher sieht. Erfassen Sie Übersetzungsanfragen getrennt von Shop-Vorgängen und berücksichtigen Sie Wiederholungen bei der Arbeitsbewertung. Verwenden Sie aktuelle Preise und nehmen Sie keinen festen Preis pro Seite oder Zeichen an.

Belege und Integrationsgrenzen

Die offizielle Dokumentation belegt eine Einstellung für benutzerdefinierte Adressen. Eine Anfrage der installierten Erweiterung über APIsRouter wurde für diesen Artikel nicht getestet. Das genaue Adressverhalten, die Modellkompatibilität und das dargestellte Ergebnis bleiben daher Einrichtungsprüfungen. Das Diagramm ist ein beispielhafter Konfigurationsfluss.

Ein abgeschlossener Kompatibilitätsdatensatz sollte Erweiterungs- und Browserversionen, bereinigte Einstellungen, Anfrageziel, exaktes Modell, eine kontrollierte Quellseite und beobachtete Übersetzung enthalten. Halten Sie Prüfung geschützter Felder getrennt von dieser Transportprüfung. Eine erfolgreiche kurze Passage validiert nicht automatisch jedes Dokumentformat oder einen Shop-Veröffentlichungsworkflow.

Häufige Fragen