Aangepaste API instellen in Immersive Translate

Open de instellingen voor de OpenAI-service

De officiële OpenAI-servicepagina van Immersive Translate documenteert een aangepast API-adres onder More Settings. Begin daar wanneer je een OpenAI-compatibel endpoint evalueert. Leg extensieversie en browser vast zodat een latere setupcontrole naar een reproduceerbare omgeving verwijst.

Kies voor de eerste test één configuratie en houd de standaardinstellingen beschikbaar voor herstel. Voer de credential alleen in de private extensie-instellingen in. Bevestig dat het endpoint de bedoelde ontvanger is voordat je pagina-inhoud verstuurt, vooral wanneer de browser ook merchantbeheerschermen kan bereiken.

Controleer of het adres een base of volledige route is

Neem niet aan dat elk custom-addressveld zich gedraagt als een SDK-baseURL. De officiële pagina bevat in het Azure-voorbeeld een volledige chat-completions-URL. Inspecteer de helptekst in je geïnstalleerde extensie en het geschoonde uitgaande requestpad om te bepalen hoe het adres wordt gebruikt.

Voor een APIsRouter-kandidaat voor chat completions is de volledige route https://api.apisrouter.com/v1/chat/completions. Als je geïnstalleerde versie expliciet een base URL verwacht en de route toevoegt, gebruik dan https://api.apisrouter.com/v1. Vermijd een dubbele chat/completions-suffix. Het werkblad hieronder beschrijft kandidaatinstellingen en geen geteste extensieconfiguratie.

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

Houd het vertaalrequestpad zichtbaar

De extensie stuurt vertaalrequests naar het geselecteerde serviceadres. Behandel dat adres als een beslissing over datadeling en niet alleen als een connectiviteitsveld. Gebruik content die je bezit of via het gekozen endpoint mag verwerken en review hoeveel van een pagina de geselecteerde vertaalactie bevat.

De flow hieronder illustreert het voorgestelde gatewaypad via het gedocumenteerde custom-addressmechanisme. Het label van het geselecteerde model is een configuratiekeuze en geen lijst met geverifieerde modellen. Store-authenticatie, productbewerking en importgoedkeuringen vallen buiten dit requestpad.

Verifieer eerst één gecontroleerde pagina

Gebruik een korte pagina met een synthetische productbeschrijving, een beschermde merkterm, een hoeveelheid met eenheid en een link. Vertaal alleen die pagina. Vergelijk het zichtbare resultaat met de bron en inspecteer geschoonde netwerkbestemming, geselecteerd model en responsstatus.

Controleer of content ontbreekt, dubbel voorkomt of met de brontaal wordt vermengd. Probeer daarna een langere paragraaf en een layout met koppen of lijsten. Bewaar bron en waargenomen output zodat een latere configuratiewijziging met hetzelfde materiaal kan worden vergeleken. Zo krijg je een nuttige diagnostische baseline vóór verwerking van een groot document.

Gebruik bilinguale lezing voor redactionele vragen

Browservertaling kan een reviewer helpen onbekend bronmateriaal te inspecteren of een zin te vinden die aandacht nodig heeft. Houd het origineel zichtbaar en vergelijk claims, hoeveelheden en terminologie rechtstreeks. Als de reviewer de doeltaal niet kan beoordelen, stuur de kandidaat naar iemand die dat wel kan in plaats van een vloeiende indruk als bewijs te accepteren.

Houd glossarybeslissingen in de catalogusworkflow. Neem niet aan dat een aangepast endpoint ook glossaryhandhaving of veldvalidatie in de extensie levert. Productbeschrijvingen die voor import bedoeld zijn, hebben nog steeds een eigen brongekoppelde kandidaat, reviewresultaat en bestemmingsmapping nodig.

Diagnosticeer fouten voordat je meer content vertaalt

Begin met requestpad, credential en exacte model-ID. Registreer gestructureerde fouten wanneer die beschikbaar zijn en redigeer headers vóór je bewijs deelt. Verlaag bij beperkte requests de werklast en respecteer retryadvies van de service in plaats van snel een volledige paginavertaling te herhalen.

Gebruik een kleiner geselecteerd fragment om verbindingsproblemen te onderscheiden van content- of responseafhandeling. Wijzig één instelling per keer. De officiële pagina bevat historische prijs- en requestfrequentievoorbeelden; gebruik documentatie en accountlimieten van je actuele endpoint in plaats van die getallen naar een nieuwe setup te kopiëren.

Scheid browseroutput van cataloguslevering

Een vertaalde browserweergave is een inspectieoppervlak. Maak voor publicatie van producttekst een kandidaat in het catalogusreviewpakket, behoud identifiers en bronrevisies en geef goedgekeurde velden daarna via de echte store-import of translation API door.

Verifieer levering door opgeslagen velden terug te lezen en de bedoelde storefrontlocale te openen. Vertrouw niet op de browserextensie van een editor als bewijs van wat een gewone bezoeker ziet. Registreer vertaalrequestgebruik afzonderlijk van storebewerkingen en neem retries mee bij beoordeling van de workload. Gebruik actuele prijzen in plaats van vaste kosten per pagina of teken aan te nemen.

Bewijs en integratiegrenzen

De officiële documentatie stelt een instelling voor een aangepast adres vast. Voor dit artikel is geen request via een geïnstalleerde extensie door APIsRouter getest; precies adresgedrag, modelcompatibiliteit en gerenderd resultaat blijven dus setupcontroles. Het diagram is een illustratieve configuratiestroom.

Een voltooid compatibiliteitsrecord moet extensie- en browserversies, geschoonde instellingen, requestbestemming, exact model, een gecontroleerde bronpagina en waargenomen vertaling bevatten. Houd review van beschermde velden gescheiden van die transportcontrole. Een geslaagd kort fragment valideert niet automatisch elk documentformaat of een storepublicatieworkflow.

Veelgestelde vragen