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 behaviorTranslation 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 سے باہر ہیں۔
پہلے ایک 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 استعمال کریں۔
| Symptom | Inspect | Next check |
|---|---|---|
| Route error | Actual final URL | Base versus full-path handling |
| Authentication error | Credential issuer اور destination | Private settings اور key scope |
| Model rejected | Exact request model field | Catalog اور account eligibility |
| Rate limit | Response metadata اور workload | Smaller batch اور bounded retry |
| Partial translation | Returned content اور page segmentation | Controlled 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 ہونے کا فرض نہ کریں۔