Immersive Translate custom API setup

Updated 2026-09-05

Documented custom-address setting کے ذریعے translation endpoint evaluate کریں۔ Controlled page سے شروع کریں، پھر bilingual reading کو editorial review کے لیے استعمال کریں۔

OpenAI service settings کھولیں

Immersive Translate کی official OpenAI service page More Settings کے تحت custom API address document کرتی ہے۔ OpenAI-compatible endpoint evaluate کرتے وقت وہیں سے شروع کریں۔ Extension version اور browser record کریں تاکہ بعد کی setup check reproducible environment سے متعلق ہو۔

First test کے لیے ایک configuration چنیں اور recovery کے لیے default settings available رکھیں۔ Credential صرف private extension settings میں داخل کریں۔ Page content بھیجنے سے پہلے confirm کریں endpoint intended recipient ہے، خاص طور پر جب browser merchant administration screens تک بھی پہنچ سکتا ہو۔

Address base ہے یا full route، یہ چیک کریں

ہر custom-address field SDK baseURL کی طرح behave نہیں کرتی۔ Official page کے Azure example میں full 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 expect کر کے route append کرتی ہے تو 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 behavior

Translation request path visible رکھیں

Extension selected service address کو translation requests بھیجتی ہے۔ Address کو صرف connectivity field نہیں بلکہ data-sharing decision سمجھیں۔ ایسا content استعمال کریں جس کے processing rights آپ کے پاس ہوں اور selected translation action page کا کتنا حصہ بھیجتی ہے، review کریں۔

Flow documented custom-address mechanism سے proposed gateway path دکھاتا ہے۔ Selected-model label configuration choice ہے، verified models کی list نہیں۔ Store authentication، product editing اور import approvals اس request path سے باہر ہیں۔

Proposed Immersive Translate custom-address path APIsRouter کے ذریعے selected catalog model تک، browser translation کے لیے نہ کہ store updates کے لیے۔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؛ proposed gateway configuration، extension test pending۔ Browser translation catalog fields نہیں لکھتی۔

پہلے ایک controlled page verify کریں

Synthetic product description، protected brand term، unit والی quantity اور link پر مشتمل short page استعمال کریں۔ صرف اسی page کو translate کریں۔ Visible result کو source سے compare کریں اور sanitized network destination، selected model اور response status inspect کریں۔

دیکھیں content omitted، duplicated یا source language کے ساتھ mixed تو نہیں۔ پھر longer paragraph اور headings یا lists والی layout آزمائیں۔ Source اور observed output save کریں تاکہ configuration change اسی material سے compare ہو۔ بڑے document سے پہلے یہ useful diagnostic baseline ہے۔

Editorial سوالات کے لیے bilingual reading استعمال کریں

Browser translation unfamiliar source material inspect کرنے یا attention-worthy phrase ڈھونڈنے میں مدد دے سکتی ہے۔ Original visible رکھیں اور claims، quantities اور terminology direct compare کریں۔ Reviewer target language evaluate نہ کر سکے تو fluent appearance کو proof سمجھنے کے بجائے candidate competent reviewer کو دیں۔

Glossary decisions catalog workflow میں رکھیں۔ Custom endpoint extension میں glossary enforcement یا field-level validation بھی دیتی ہے، یہ فرض نہ کریں۔ Import کے لیے product descriptions کو اپنے source-linked candidate، review result اور destination mapping پھر بھی چاہییں۔

مزید content translate کرنے سے پہلے errors diagnose کریں

Request path، credential اور exact model ID سے شروع کریں۔ Available ہوں تو structured errors record کریں اور share کرنے سے پہلے headers redact کریں۔ Requests limited ہوں تو workload کم کریں اور full-page translation تیزی سے repeat کرنے کے بجائے service retry guidance مانیں۔

Connection failure کو content یا response-handling problem سے الگ کرنے کے لیے چھوٹا passage استعمال کریں۔ ایک وقت میں ایک setting بدلیں۔ Official page کے historical price اور request-rate examples کو نئی setup میں copy نہ کریں؛ current endpoint documentation اور account limits استعمال کریں۔

SymptomInspectNext check
Route errorActual final URLBase versus full-path handling
Authentication errorCredential issuer اور destinationPrivate settings اور key scope
Model rejectedExact request model fieldCatalog اور account eligibility
Rate limitResponse metadata اور workloadSmaller batch اور bounded retry
Partial translationReturned content اور page segmentationControlled passage comparison

Browser output کو catalog delivery سے الگ کریں

Translated browser view inspection surface ہے۔ Product text publish کرنے کے لیے catalog review package میں candidate بنائیں، identifiers اور source revisions محفوظ کریں، پھر approved fields کو store کے actual import یا translation API سے بھیجیں۔

Stored fields پڑھ کر اور intended storefront locale کھول کر delivery verify کریں۔ Editor کی browser extension ordinary visitor کا view ثابت نہیں کرتی۔ Translation request usage کو store operations سے الگ record کریں اور workload evaluate کرتے وقت retries account کریں۔ Fixed cost per page یا character فرض کرنے کے بجائے current pricing دیکھیں۔

Evidence اور integration limits

Official documentation custom-address setting establish کرتی ہے۔ اس article کے لیے APIsRouter کے ذریعے installed-extension request test نہیں ہوئی، اس لیے precise address behavior، model compatibility اور rendered result setup checks ہیں۔ Diagram illustrative configuration flow ہے۔

Completed compatibility record میں extension اور browser versions، sanitized settings، request destination، exact model، controlled source page اور observed translation شامل ہوں۔ Protected-field review کو transport check سے الگ رکھیں۔ Short passage successful ہو تو بھی ہر 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 کرنے یا complete request URL expect کرنے میں مختلف ہیں۔ Actual outgoing path inspect کریں اور missing یا duplicated chat-completions segments سے بچیں۔

Custom configuration میں کون سی credential دوں؟

Configured endpoint کے لیے issued credential private طور پر داخل کریں۔ دوسرے provider کی credential یا store administration token اس کا بدل نہیں۔

Translated product page کیا store update کرتی ہے؟

Browser translation catalog storage نہیں۔ Approved product text deliver کرنے کے لیے store translation یا import path استعمال کریں اور stored fields verify کریں۔

Product terminology محفوظ کیسے رکھوں؟

Content workflow میں reviewed glossary رکھیں اور browser result سے compare کریں۔ Extension-specific glossary feature کو الگ verify کریں؛ custom address سے terms enforce ہونے کا فرض نہ کریں۔