إعداد API مخصص لـ Immersive Translate

Updated 2026-09-05

استخدم إعداد العنوان المخصص الموثق لتقييم نقطة نهاية ترجمة. ابدأ بصفحة مضبوطة ثم استخدم القراءة الثنائية لدعم المراجعة التحريرية.

افتح إعدادات خدمة OpenAI

توثق صفحة خدمة OpenAI الرسمية في Immersive Translate عنوان API مخصصًا تحت More Settings. ابدأ من هناك عند تقييم نقطة نهاية متوافقة مع OpenAI. سجّل إصدار الإضافة والمتصفح حتى تشير مراجعة الإعداد اللاحقة إلى بيئة قابلة لإعادة الإنتاج.

اختر تهيئة واحدة للاختبار الأول وأبقِ الإعدادات الافتراضية متاحة للاستعادة. أدخل بيانات الاعتماد في إعدادات الإضافة الخاصة فقط. أكد أن نقطة النهاية هي المستلم المقصود قبل إرسال أي محتوى صفحة، خاصة عندما يمتلك المتصفح أيضًا وصولًا إلى شاشات إدارة التاجر.

تحقق مما إذا كان العنوان أساسًا أو مسارًا كاملًا

لا تفترض أن كل حقل عنوان مخصص يتصرف مثل baseURL في SDK. تتضمن الصفحة الرسمية عنوان chat-completions كاملًا في مثال Azure. افحص نص المساعدة في الإضافة المثبتة ومسار الطلب الصادر المنقح لتحديد طريقة استخدام العنوان.

بالنسبة إلى مرشح APIsRouter لـ chat-completions، المسار الكامل هو https://api.apisrouter.com/v1/chat/completions. إذا كان إصدارك المثبت يتوقع صراحةً عنوان أساس ويُلحق المسار، فاستخدم https://api.apisrouter.com/v1 بدلًا منه. تجنب لاحقة chat/completions مكررة. تصف ورقة العمل أدناه إعدادات مرشحة وليست تهيئة إضافة مختبرة.

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

أبقِ مسار طلب الترجمة ظاهرًا

ترسل الإضافة طلبات الترجمة إلى عنوان الخدمة المختار. تعامل مع العنوان كقرار لمشاركة البيانات لا كحقل اتصال فقط. استخدم محتوى تملكه أو يسمح لك بمعالجته عبر نقطة النهاية المختارة، وراجع مقدار الصفحة الذي تتضمنه عملية الترجمة المختارة.

يوضح التدفق أدناه مسار البوابة المقترح باستخدام آلية العنوان المخصص الموثقة. تسمية النموذج المختار خيار تهيئة وليست قائمة نماذج متحققًا منها. تقع مصادقة المتجر وتحرير المنتج واعتماد الاستيراد خارج مسار الطلب هذا.

مسار عنوان Immersive Translate المخصص المقترح عبر APIsRouter إلى نموذج كتالوج مختار لترجمة المتصفح لا تحديثات المتجر.Immersive Translate routes through More Settings + عنوان مخصص to the APIsRouter gateway (api.apisrouter.com/v1), which fans out to: Selected catalog ID.Immersive TranslateviaMore Settings + عنوانمخصصAPIsRouterapi.apisrouter.com/v1Selected catalog ID
تجاوز عنوان موثق؛ تهيئة البوابة المقترحة معلقة على اختبار الإضافة. ترجمة المتصفح لا تكتب حقول الكتالوج.

تحقق من صفحة واحدة مضبوطة أولًا

استخدم صفحة قصيرة بوصف منتج اصطناعي ومصطلح علامة محمي وكمية مع وحدتها ورابط. ترجم الصفحة وحدها. قارن النتيجة الظاهرة بالمصدر وافحص وجهة الشبكة المنقحة والنموذج المختار وحالة الاستجابة.

تحقق مما إذا كان المحتوى محذوفًا أو مكررًا أو مختلطًا بلغة المصدر. ثم جرّب فقرة أطول وتخطيطًا يحوي عناوين أو قوائم. احفظ المصدر والمخرج المرصود حتى تقارن تغيير التهيئة اللاحق بالمادة نفسها. يمنحك ذلك خط أساس تشخيصيًا قبل معالجة وثيقة كبيرة.

استخدم القراءة الثنائية للأسئلة التحريرية

يمكن لترجمة المتصفح مساعدة المراجع في فحص مادة مصدر غير مألوفة أو تحديد عبارة تحتاج إلى اهتمام. أبقِ الأصل ظاهرًا وقارن الادعاءات والكميات والمصطلحات مباشرة. إذا لم يستطع المراجع تقييم اللغة المستهدفة، فوجه المرشح إلى شخص يستطيع ذلك بدل قبول المظهر السلس دليلًا.

احتفظ بقرارات المسرد في سير عمل الكتالوج. لا تفترض أن نقطة النهاية المخصصة توفر أيضًا فرض المصطلحات أو التحقق على مستوى الحقل داخل الإضافة. لا تزال أوصاف المنتج المعدة للاستيراد تحتاج إلى مرشح مرتبط بالمصدر ونتيجة مراجعة وتعيين وجهة خاص بها.

شخّص الأخطاء قبل ترجمة مزيد من المحتوى

ابدأ بمسار الطلب وبيانات الاعتماد ومعرّف النموذج الدقيق. سجّل الأخطاء المنظمة عند توفرها ونقّح الرؤوس قبل مشاركة الدليل. إذا كانت الطلبات محدودة، فقلل العمل واحترم إرشادات إعادة المحاولة للخدمة بدل تكرار ترجمة صفحة كاملة بسرعة.

استخدم مقطعًا أصغر للتمييز بين فشل الاتصال ومشكلات المحتوى أو معالجة الاستجابة. غيّر إعدادًا واحدًا في كل مرة. تتضمن الصفحة الرسمية أمثلة تاريخية للسعر ومعدل الطلب؛ استخدم وثائق نقطة النهاية الحالية وحدود حسابك بدل نسخ هذه الأرقام إلى إعداد جديد.

العرضافحصالفحص التالي
خطأ مسارعنوان URL النهائي الفعليمعالجة المسار الأساسي مقابل الكامل
خطأ مصادقةمُصدر بيانات الاعتماد والوجهةالإعدادات الخاصة ونطاق المفتاح
رُفض النموذجحقل نموذج الطلب الدقيقأهلية الكتالوج والحساب
حد المعدلبيانات الاستجابة الوصفية وحجم العملدفعة أصغر وإعادة محدودة
ترجمة جزئيةالمحتوى المعاد وتقسيم الصفحةمقارنة مقطع مضبوط

افصل مخرج المتصفح عن تسليم الكتالوج

عرض المتصفح المترجم سطح فحص. لنشر نص منتج، أنشئ مرشحًا في حزمة مراجعة الكتالوج واحفظ المعرّفات ومراجعات المصدر ثم مرّر الحقول المعتمدة عبر API الاستيراد أو الترجمة الفعلية للمتجر.

تحقق من التسليم بقراءة الحقول المخزنة وفتح لغة المتجر المقصودة. لا تعتمد على إضافة متصفح المحرر لإثبات ما سيراه الزائر العادي. سجّل استخدام طلب الترجمة منفصلًا عن عمليات المتجر واحتسب الإعادات عند تقييم العمل. ارجع إلى الأسعار الحالية ولا تفترض تكلفة ثابتة لكل صفحة أو حرف.

الأدلة وحدود التكامل

تثبت الوثائق الرسمية إعداد عنوان مخصص. لم يُختبر طلب من إضافة مثبتة عبر APIsRouter لهذا المقال، لذلك تظل طريقة العنوان الدقيقة وتوافق النموذج والنتيجة المعروضة فحوص إعداد. الرسم تدفق تهيئة توضيحي.

ينبغي لسجل توافق مكتمل أن يتضمن إصدارات الإضافة والمتصفح وإعدادات منقحة ووجهة الطلب والنموذج الدقيق وصفحة مصدر مضبوطة وترجمة مرصودة. أبقِ مراجعة الحقول المحمية منفصلة عن فحص النقل. لا يتحقق مقطع قصير ناجح تلقائيًا من كل صيغة وثيقة أو سير نشر للمتجر.

الأسئلة الشائعة

أين أغير عنوان API؟

تشير وثائق خدمة OpenAI الرسمية إلى More Settings. افحص إصدار الإضافة المثبت ومساعدة الحقل عند اختيار صيغة العنوان النهائية.

لماذا يفشل عنوان /v1 المنسوخ أحيانًا؟

تختلف الأدوات في إلحاق مسار أو توقع عنوان طلب كامل. افحص المسار الصادر الفعلي وتجنب مقاطع chat-completions المفقودة أو المكررة.

أي بيانات اعتماد تنتمي إلى التهيئة المخصصة؟

استخدم بيانات اعتماد صادرة لنقطة النهاية المضبوطة وأدخلها بصورة خاصة. لا تحل بيانات اعتماد مزود آخر أو رمز إدارة المتجر محلها.

هل تحدث صفحة منتج مترجمة متجري؟

ترجمة المتصفح ليست تخزينًا للكتالوج. استخدم مسار ترجمة أو استيراد المتجر وتحقق من الحقول المخزنة لتسليم نص منتج معتمد.

كيف أحافظ على مصطلحات المنتج؟

احتفظ بمسرد راجعه البشر في سير المحتوى وقارن نتيجة المتصفح به. تحقق من ميزة مسرد خاصة بالإضافة بصورة منفصلة بدل افتراض أن العنوان المخصص يفرض المصطلحات.