Immersive Translate का custom API setup
Updated 2026-09-05
Custom-address behavior को installed extension में verify करें, page translation को सुरक्षित रखें और store content delivery को अलग workflow मानें।
Official custom address setting से शुरू करें
Immersive Translate का official OpenAI service page More Settings के अंतर्गत custom API address document करता है। OpenAI-compatible endpoint evaluate करते समय वहीं से शुरुआत करें। Extension version और browser record करें, ताकि बाद की setup check reproducible environment से जुड़ी रहे।
पहले test के लिए एक configuration चुनें और recovery के लिए default settings उपलब्ध रखें। Credential केवल private extension settings में डालें। Page content भेजने से पहले confirm करें कि endpoint intended recipient है, खासकर तब जब browser merchant administration screens तक भी पहुँच सकता हो।
Custom address को SDK baseURL न समझें
हर custom-address field SDK baseURL की तरह behave करती है, यह न मानें। Official page अपने Azure example में पूरा chat-completions URL दिखाता है। Installed extension का help text और sanitized outgoing request path inspect करें, ताकि पता चले address का उपयोग कैसे होता है।
APIsRouter chat-completions candidate के लिए full route https://api.apisrouter.com/v1/chat/completions है। यदि installed version स्पष्ट रूप से base URL माँगती है और route स्वयं जोड़ती है, तो https://api.apisrouter.com/v1 इस्तेमाल करें। Duplicated chat/completions suffix से बचें। नीचे की worksheet candidate settings बताती है, 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 behaviorEndpoint को data-sharing decision समझें
Extension translation requests selected service address पर भेजती है। उस address को केवल connectivity field नहीं, data-sharing decision मानें। चुने हुए endpoint से process करने की अनुमति वाला content उपयोग करें और review करें कि selected translation action page का कितना भाग भेजती है।
नीचे का flow documented custom-address mechanism से proposed gateway path दिखाता है। Selected-model label configuration choice है, verified models की list नहीं। Store authentication, product editing और import approvals इस request path से बाहर हैं।
छोटे synthetic page से request जाँचें
Synthetic product description, protected brand term, unit वाली quantity और एक link वाला short page चुनें। केवल उसी page का translation करें। Visible result को source से compare करें और sanitized network destination, selected model तथा response status inspect करें।
जाँचें कि content omitted, duplicated या source language के साथ mixed तो नहीं है। फिर headings या lists वाले longer paragraph और layout पर test करें। Source और observed output बचाएँ, ताकि configuration बदलने पर उसी material से तुलना की जा सके। बड़े document पर जाने से पहले यह उपयोगी diagnostic baseline देता है।
Browser result को catalog approval न मानें
Browser translation unfamiliar source material inspect करने या ध्यान देने योग्य phrase खोजने में reviewer की मदद कर सकती है। Original visible रखें और claims, quantities तथा terminology सीधे compare करें। Reviewer target language evaluate न कर सके तो candidate को सक्षम व्यक्ति के पास भेजें; fluent appearance proof नहीं है।
Glossary decisions catalog workflow में रखें। Custom endpoint extension के भीतर glossary enforcement या field-level validation भी देता है, यह न मानें। Import के लिए intended product descriptions को अपना source-linked candidate, review result और destination mapping चाहिए।
Error, rate और retry behavior अलग जाँचें
Request path, credential और exact model ID से शुरुआत करें। उपलब्ध structured errors record करें और evidence share करने से पहले headers redact करें। Requests limited हों तो workload घटाएँ और service की retry guidance मानें; full-page translation को जल्दी-जल्दी repeat न करें।
छोटे selected passage से connection failure को content या response-handling problem से अलग करें। एक समय में एक setting बदलें। Official page में historical price और request-rate examples हैं; उन्हें setup में copy करने के बजाय current endpoint documentation और account limits देखें।
| संकेत | संभावित अर्थ | अगला कदम |
|---|---|---|
| response नहीं मिला | Address या connection problem | Outgoing path जाँचें |
| अनधिकृत | Credential या account problem | Endpoint credential जाँचें |
| rate limit लागू | Service limit या तेज़ retries | Pace घटाएँ |
| अधूरा output | Response पूरा नहीं हुआ | Input और response logs inspect करें |
| गलत language | Locale या page handling समस्या | Same source से फिर compare करें |
Browser inspection और store delivery अलग रखें
Translated browser view inspection surface है। Product text publish करने के लिए catalog review package में candidate बनाएँ, identifiers और source revisions बचाएँ और approved fields को store के actual import या translation API से भेजें।
Delivery verify करने के लिए stored fields पढ़ें और intended storefront locale खोलें। Editor की browser extension से ordinary visitor को दिखने वाली चीज़ सिद्ध नहीं होती। Translation request usage को store operations से अलग record करें और workload evaluate करते समय retries भी गिनें। Page या character की fixed cost मानने के बजाय current pricing देखें।
Configuration evidence की सीमा स्पष्ट रखें
Official documentation custom-address setting स्थापित करता है। इस article के लिए APIsRouter के माध्यम से installed-extension request test नहीं की गई है, इसलिए precise address behavior, model compatibility और rendered result अभी setup checks हैं। Diagram illustrative configuration flow है।
Complete compatibility record में extension और browser versions, sanitized settings, request destination, exact model, controlled source page और observed translation शामिल हों। Protected-field review को transport check से अलग रखें। सफल short passage हर document format या store publishing workflow को automatically validate नहीं करता।
अक्सर पूछे जाने वाले प्रश्न
API address कहाँ बदलना है?
Official OpenAI service documentation More Settings की ओर निर्देश देती है। Final address format चुनते समय installed extension version और field help जाँचें।
Copied /v1 URL कभी-कभी fail क्यों होती है?
Tools अलग-अलग तरह से route append कर सकते हैं या पूरा request URL माँग सकते हैं। Actual outgoing path inspect करें और missing या duplicated chat-completions segment से बचें।
Custom configuration में कौन-सा credential रखना चाहिए?
Configured endpoint के लिए जारी credential private रूप से enter करें। दूसरे provider का credential या store administration token इसका विकल्प नहीं है।
क्या translated product page store update कर देती है?
Browser translation catalog storage नहीं है। Store translation या import path उपयोग करें और approved product text deliver करने के लिए stored fields verify करें।
Product terminology कैसे बचाएँ?
Content workflow में reviewed glossary रखें और browser result से compare करें। Extension-specific glossary feature को अलग verify करें; custom address terms enforce करती है, यह न मानें।