Configurazione dell'API personalizzata di Immersive Translate

Apri le impostazioni del servizio OpenAI

La pagina ufficiale del servizio OpenAI di Immersive Translate documenta un indirizzo API personalizzato in More Settings. Parti da lì quando valuti un endpoint compatibile con OpenAI. Registra la versione dell'estensione e il browser, così un controllo successivo della configurazione farà riferimento a un ambiente riproducibile.

Scegli una configurazione per il primo test e mantieni disponibili le impostazioni predefinite per il recupero. Inserisci la credenziale solo nelle impostazioni private dell'estensione. Conferma che l'endpoint sia il destinatario previsto prima di inviare contenuti di una pagina, soprattutto quando il browser può accedere anche alle schermate di amministrazione del merchant.

Controlla se l'indirizzo è una base o un percorso completo

Non presumere che ogni campo per un indirizzo personalizzato si comporti come una baseURL di SDK. La pagina ufficiale include un URL completo di chat completions nell'esempio Azure. Ispeziona il testo di aiuto dell'estensione installata e il percorso in uscita sanitizzato per capire come viene usato l'indirizzo.

Per un candidato APIsRouter di chat completions, il percorso completo è https://api.apisrouter.com/v1/chat/completions. Se la versione installata richiede esplicitamente un URL di base e aggiunge il percorso, usa invece https://api.apisrouter.com/v1. Evita un suffisso chat/completions duplicato. Il foglio di lavoro seguente descrive impostazioni candidate, non una configurazione dell'estensione testata.

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

Mantieni visibile il percorso della richiesta di traduzione

L'estensione invia le richieste di traduzione all'indirizzo del servizio selezionato. Tratta quell'indirizzo come una decisione di condivisione dei dati, non solo come un campo di connettività. Usa contenuti che possiedi o che puoi elaborare attraverso l'endpoint scelto e verifica quanta parte della pagina include l'azione di traduzione selezionata.

Il flusso qui sotto illustra il percorso gateway proposto usando il meccanismo dell'indirizzo personalizzato documentato. L'etichetta del modello selezionato è una scelta di configurazione, non un elenco di modelli verificati. Autenticazione dello store, modifica dei prodotti e approvazioni dell'import sono fuori da questo percorso di richiesta.

Verifica prima una pagina controllata

Usa una pagina breve con una descrizione prodotto sintetica, un termine di brand protetto, una quantità con la sua unità e un link. Traduci solo quella pagina. Confronta il risultato visibile con la fonte e ispeziona destinazione di rete sanitizzata, modello selezionato e stato della risposta.

Controlla se il contenuto viene omesso, duplicato o mescolato con la lingua fonte. Prova poi un paragrafo più lungo e un layout con titoli o liste. Salva fonte e output osservato, così una modifica successiva della configurazione potrà essere confrontata con lo stesso materiale. Questo fornisce una baseline diagnostica utile prima di elaborare un documento grande.

Usa la lettura bilingue per le domande editoriali

La traduzione nel browser può aiutare un revisore a esaminare materiale fonte non familiare o individuare una frase che richiede attenzione. Mantieni visibile l'originale e confronta direttamente dichiarazioni, quantità e terminologia. Se il revisore non può valutare la lingua target, passa il candidato a qualcuno che possa farlo invece di considerare l'aspetto fluente come prova.

Mantieni le decisioni del glossario nel flusso del catalogo. Non presumere che un endpoint personalizzato fornisca anche applicazione del glossario o validazione a livello di campo all'interno dell'estensione. Le descrizioni prodotto destinate all'import richiedono comunque un candidato collegato alla fonte, un risultato di revisione e un mapping di destinazione propri.

Diagnostica gli errori prima di tradurre altro contenuto

Inizia dal percorso della richiesta, dalla credenziale e dall'ID esatto del modello. Registra gli errori strutturati quando disponibili e oscura gli header prima di condividere le evidenze. Se le richieste sono limitate, riduci il carico e rispetta le indicazioni di retry del servizio invece di ripetere rapidamente una traduzione di pagina intera.

Usa un passaggio selezionato più piccolo per distinguere un errore di connessione da problemi di contenuto o gestione della risposta. Modifica una sola impostazione alla volta. La pagina ufficiale contiene esempi storici di prezzo e frequenza delle richieste; usa documentazione e limiti dell'account dell'endpoint corrente invece di copiare quei numeri in una nuova configurazione.

Separa l'output del browser dalla consegna al catalogo

Una vista tradotta nel browser è una superficie d'ispezione. Per pubblicare testo prodotto, crea un candidato nel pacchetto di revisione del catalogo, preserva identificativi e revisioni della fonte, poi passa i campi approvati attraverso l'effettivo import dello store o l'API di traduzione.

Verifica la consegna rileggendo i campi memorizzati e aprendo il locale previsto dello storefront. Non fare affidamento sull'estensione browser dell'editor per dimostrare ciò che vedrà un visitatore ordinario. Registra l'utilizzo delle richieste di traduzione separatamente dalle operazioni sullo store e considera i retry nella valutazione del carico. Consulta prezzi correnti invece di presumere un costo fisso per pagina o carattere.

Evidenze e limiti dell'integrazione

La documentazione ufficiale stabilisce un'impostazione per l'indirizzo personalizzato. Per questo articolo non è stata testata una richiesta dell'estensione installata attraverso APIsRouter, quindi comportamento preciso dell'indirizzo, compatibilità del modello e risultato renderizzato restano controlli di configurazione. Il diagramma è un flusso di configurazione illustrativo.

Un record di compatibilità completato dovrebbe includere versioni di estensione e browser, impostazioni sanitizzate, destinazione della richiesta, modello esatto, pagina fonte controllata e traduzione osservata. Mantieni separata la revisione dei campi protetti dal controllo di trasporto. Un passaggio breve riuscito non convalida automaticamente ogni formato di documento o un flusso di pubblicazione nello store.

Domande frequenti