Custom API setup ng Immersive Translate

Updated 2026-09-05

Gamitin ang documented custom-address setting para suriin ang translation endpoint. Magsimula sa kontroladong page, saka gumamit ng bilingual reading bilang suporta sa editorial review.

Buksan ang OpenAI service setting

Dinudokumento ng opisyal na OpenAI service page ng Immersive Translate ang custom API address sa ilalim ng More Settings. Magsimula roon kapag nagsusuri ng OpenAI-compatible endpoint. Itala ang extension version at browser upang tumukoy sa reproducible environment ang susunod na setup check.

Pumili ng isang configuration para sa unang test at panatilihing available ang default setting para sa recovery. Ilagay lamang ang credential sa pribadong extension setting. Kumpirmahing ang endpoint ang nilalayong tatanggap bago magpadala ng page content, lalo na kapag may access din ang browser sa merchant administration screen.

Suriin kung base o buong route ang address

Huwag ipagpalagay na lahat ng custom-address field ay kumikilos gaya ng SDK baseURL. May buong chat-completions URL ang opisyal na page sa Azure example nito. Siyasatin ang help text sa naka-install na extension at sanitized outgoing request path upang matukoy kung paano ginagamit ang address.

Para sa APIsRouter chat-completions candidate, ang buong route ay https://api.apisrouter.com/v1/chat/completions. Kung tahasang base URL ang inaasahan ng naka-install mong version at idinadagdag nito ang route, gamitin ang https://api.apisrouter.com/v1. Iwasan ang nadobleng chat/completions suffix. Inilalarawan ng worksheet sa ibaba ang candidate setting, hindi tested extension configuration.

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

Panatilihing nakikita ang translation request path

Nagpapadala ang extension ng translation request sa napiling service address. Ituring ang address na desisyon sa data sharing, hindi connectivity field lamang. Gumamit ng content na pag-aari mo o maaaring iproseso sa napiling endpoint, at suriin kung gaano karaming bahagi ng page ang isinasama ng napiling translation action.

Ipinapakita ng flow sa ibaba ang iminungkahing gateway path gamit ang documented custom-address mechanism. Configuration choice ang selected-model label, hindi listahan ng mga na-verify na model. Nasa labas ng request path na ito ang store authentication, product editing, at import approval.

Iminungkahing Immersive Translate custom-address path sa APIsRouter patungo sa napiling catalog model, para sa browser translation at hindi store update.Immersive Translate routes through More Settings + custom address to the APIsRouter gateway (api.apisrouter.com/v1), which fans out to: Selected catalog ID.Immersive TranslateviaMore Settings + customaddressAPIsRouterapi.apisrouter.com/v1Selected catalog ID
Documented address override; iminungkahing gateway configuration na naghihintay ng extension test. Hindi nagsusulat ng catalog field ang browser translation.

I-verify muna ang isang kontroladong page

Gumamit ng maikling page na may synthetic product description, protektadong brand term, quantity kasama ang unit nito, at link. Isalin lamang ang page na iyon. Ihambing ang nakikitang resulta sa source at siyasatin ang sanitized network destination, napiling model, at response status.

Suriin kung may content na inalis, nadoble, o nahalo sa source language. Saka subukan ang mas mahabang paragraph at layout na may heading o list. I-save ang source at naobserbahang output upang maihambing ang susunod na configuration change sa parehong material. Nagbibigay ito ng kapaki-pakinabang na diagnostic baseline bago iproseso ang malaking dokumento.

Gamitin ang bilingual reading para sa editorial question

Makakatulong ang browser translation sa reviewer na siyasatin ang hindi pamilyar na source material o tukuyin ang pariralang nangangailangan ng pansin. Panatilihing nakikita ang orihinal at direktang ihambing ang claim, quantity, at terminology. Kung hindi kayang suriin ng reviewer ang target language, i-route ang candidate sa taong kayang gumawa nito sa halip na ituring na patunay ang fluent na anyo.

Panatilihin ang glossary decision sa catalog workflow. Huwag ipagpalagay na nagbibigay rin ang custom endpoint ng glossary enforcement o field-level validation sa loob ng extension. Kailangan pa rin ng sariling source-linked candidate, review result, at destination mapping ang product description na balak i-import.

I-diagnose ang error bago magsalin ng mas maraming content

Magsimula sa request path, credential, at eksaktong model ID. Itala ang structured error kung available at i-redact ang header bago magbahagi ng evidence. Kung may limitasyon ang request, bawasan ang workload at igalang ang retry guidance ng service sa halip na mabilis na ulitin ang full-page translation.

Gumamit ng mas maliit na napiling passage upang ihiwalay ang connection failure sa content o response-handling problem. Baguhin ang isang setting bawat pagkakataon. May historical price at request-rate example ang opisyal na page; gamitin ang documentation at account limit ng kasalukuyang endpoint sa halip na kopyahin ang mga numerong iyon sa bagong setup.

SintomasSiyasatinSusunod na check
Error sa rutaAktuwal na final URLBase laban sa full-path handling
Error sa authenticationCredential issuer at destinationPribadong setting at key scope
Tinanggihan ang modelEksaktong request model fieldCatalog at account eligibility
Limit ng rateResponse metadata at workloadMas maliit na batch at limitadong retry
Bahagyang translationIbinalik na content at page segmentationPaghahambing sa kontroladong passage

Ihiwalay ang browser output sa catalog delivery

Inspection surface ang isinaling browser view. Para mag-publish ng product text, gumawa ng candidate sa catalog review package, panatilihin ang identifier at source revision, saka ipasa ang aprubadong field sa aktuwal na import o translation API ng store.

I-verify ang delivery sa pamamagitan ng pagbasa ng stored field at pagbukas ng nilalayong storefront locale. Huwag umasa sa browser extension ng editor bilang patunay ng makikita ng ordinaryong visitor. Itala nang hiwalay ang translation request usage sa store operation at i-account ang retry sa pagsusuri ng workload. Sumangguni sa kasalukuyang pricing sa halip na ipagpalagay ang fixed cost bawat page o character.

Ebidensya at mga limitasyon ng integration

Itinatatag ng opisyal na documentation ang custom-address setting. Hindi pa nasusubukan para sa article na ito ang installed-extension request sa APIsRouter, kaya nananatiling setup check ang eksaktong address behavior, model compatibility, at rendered result. Halimbawang configuration flow ang diagram.

Dapat kasama sa kumpletong compatibility record ang extension at browser version, sanitized setting, request destination, eksaktong model, kontroladong source page, at naobserbahang translation. Panatilihing hiwalay ang protected-field review sa transport check na iyon. Hindi awtomatikong nagva-validate sa bawat document format o store publishing workflow ang matagumpay na maikling passage.

Mga madalas itanong

Saan ko babaguhin ang API address?

Tinuturo ng opisyal na OpenAI service documentation ang More Settings. Suriin ang naka-install na extension version at field help nito sa pagpili ng final address format.

Bakit minsan nabibigo ang kinopyang /v1 URL?

Magkakaiba ang tool kung nagdaragdag ito ng route o umaasang kumpletong request URL ang ibinigay. Siyasatin ang aktuwal na outgoing path at iwasan ang nawawala o nadobleng chat-completions segment.

Aling credential ang dapat ilagay sa custom configuration?

Gumamit ng credential na ibinigay para sa configured endpoint at ilagay ito nang pribado. Hindi kapalit nito ang credential ng ibang provider o store administration token.

Ina-update ba ng translated product page ang store ko?

Hindi storage ng catalog ang browser translation. Gamitin ang translation o import path ng store at i-verify ang stored field upang maihatid ang aprubadong product text.

Paano ko mapapanatili ang product terminology?

Panatilihin ang nasuring glossary sa content workflow at ihambing dito ang browser result. Hiwalay na i-verify ang anumang extension-specific glossary feature sa halip na ipagpalagay na ipinapatupad ng custom address ang mga termino.