راه‌اندازی API سفارشی Immersive Translate

تنظیمات سرویس OpenAI را باز کنید

صفحه رسمی سرویس OpenAI در Immersive Translate، نشانی API سفارشی را زیر More Settings مستند می‌کند. هنگام ارزیابی endpoint سازگار با OpenAI از همان‌جا شروع کنید. نسخه افزونه و مرورگر را ثبت کنید تا کنترل setup بعدی به محیطی قابل‌بازتولید اشاره کند.

برای نخستین آزمون یک پیکربندی انتخاب و تنظیمات پیش‌فرض را برای بازیابی در دسترس نگه دارید. اعتبارنامه را فقط در تنظیمات خصوصی افزونه وارد کنید. پیش از ارسال محتوای صفحه، به‌خصوص وقتی مرورگر به صفحه‌های مدیریت تاجر هم دسترسی دارد، تأیید کنید endpoint گیرنده موردنظر است.

بررسی کنید نشانی base است یا مسیر کامل

فرض نکنید هر فیلد custom-address مانند SDK baseURL رفتار می‌کند. صفحه رسمی در نمونه Azure خود URL کامل chat-completions دارد. متن راهنمای افزونه نصب‌شده و مسیر خروجی پاک‌سازی‌شده درخواست را بررسی کنید تا معلوم شود نشانی چگونه استفاده می‌شود.

برای نامزد chat-completions APIsRouter، مسیر کامل https://api.apisrouter.com/v1/chat/completions است. اگر نسخه نصب‌شده صریحاً base URL می‌خواهد و مسیر را اضافه می‌کند، به‌جای آن https://api.apisrouter.com/v1 را استفاده کنید. از پسوند تکراری chat/completions پرهیز کنید. worksheet زیر تنظیمات نامزد را توصیف می‌کند، نه پیکربندی آزموده‌شده افزونه.

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

مسیر درخواست ترجمه را آشکار نگه دارید

افزونه درخواست‌های ترجمه را به نشانی سرویس انتخاب‌شده می‌فرستد. نشانی را تصمیم اشتراک داده بدانید، نه فقط فیلد اتصال. از محتوایی استفاده کنید که مالک آن هستید یا اجازه پردازشش از مسیر endpoint انتخاب‌شده را دارید و بررسی کنید action ترجمه انتخاب‌شده چه مقدار از صفحه را می‌فرستد.

جریان زیر مسیر پیشنهادی gateway را با سازوکار custom-address مستند نشان می‌دهد. برچسب مدل انتخاب‌شده یک انتخاب پیکربندی است، نه فهرست مدل‌های تأییدشده. احراز هویت فروشگاه، ویرایش محصول و تأیید import بیرون از این مسیرند.

ابتدا یک صفحه کنترل‌شده را تأیید کنید

از صفحه کوتاهی با توضیح محصول مصنوعی، اصطلاح برند محافظت‌شده، مقدار همراه واحد و یک پیوند استفاده کنید. فقط همان صفحه را ترجمه کنید. نتیجه دیداری را با منبع مقایسه و مقصد شبکه پاک‌سازی‌شده، مدل انتخاب‌شده و status پاسخ را بررسی کنید.

بررسی کنید محتوا حذف، تکرار یا با زبان منبع مخلوط نشده باشد. سپس پاراگراف بلندتر و layout دارای heading یا list را امتحان کنید. منبع و خروجی مشاهده‌شده را ذخیره کنید تا تغییر پیکربندی بعدی با همان ماده مقایسه شود. این کار پیش از پردازش سند بزرگ baseline تشخیصی مفیدی می‌سازد.

برای پرسش‌های ویراستاری از خواندن دوزبانه استفاده کنید

ترجمه مرورگر می‌تواند به بازبین برای بررسی منبع ناآشنا یا پیدا کردن عبارت نیازمند توجه کمک کند. اصل متن را آشکار نگه دارید و ادعاها، مقدارها و اصطلاحات را مستقیم مقایسه کنید. اگر بازبین نمی‌تواند زبان مقصد را ارزیابی کند، نامزد را به فردی که می‌تواند ارجاع دهید و ظاهر روان را دلیل ندانید.

تصمیم واژه‌نامه را در گردش‌کار کاتالوگ نگه دارید. فرض نکنید endpoint سفارشی در افزونه enforcement واژه‌نامه یا اعتبارسنجی سطح فیلد هم فراهم می‌کند. توضیح محصول برای import همچنان به نامزد متصل به منبع، نتیجه بازبینی و نگاشت مقصد خودش نیاز دارد.

پیش از ترجمه محتوای بیشتر خطاها را تشخیص دهید

با مسیر درخواست، اعتبارنامه و ID دقیق مدل شروع کنید. هرجا موجود است خطاهای ساختاریافته را ثبت و headerها را پیش از اشتراک‌گذاری پاک کنید. اگر درخواست‌ها محدودند، workload را کم و راهنمای تلاش دوباره سرویس را رعایت کنید، نه اینکه ترجمه کامل صفحه را سریع تکرار کنید.

از قطعه انتخاب‌شده کوچک‌تری برای تفکیک شکست اتصال از مشکل محتوا یا مدیریت پاسخ استفاده کنید. هر بار یک تنظیم را تغییر دهید. صفحه رسمی مثال‌های تاریخی قیمت و نرخ درخواست دارد؛ به‌جای کپی‌کردن آن اعداد در setup تازه، مستندات و limitهای حساب endpoint جاری خود را استفاده کنید.

خروجی مرورگر را از تحویل کاتالوگ جدا کنید

نمای ترجمه‌شده مرورگر سطح بازرسی است. برای انتشار متن محصول، نامزد را در بسته بازبینی کاتالوگ بسازید، شناسه و نسخه منبع را حفظ کنید و فیلدهای تأییدشده را از مسیر import یا API ترجمه واقعی فروشگاه بفرستید.

تحویل را با خواندن فیلدهای ذخیره‌شده و بازکردن locale storefront موردنظر تأیید کنید. برای اثبات چیزی که بازدیدکننده عادی می‌بیند به افزونه مرورگر ویرایشگر اتکا نکنید. مصرف درخواست ترجمه را از عملیات فروشگاه جدا و تلاش‌های مجدد را در ارزیابی workload حساب کنید. به‌جای فرض هزینه ثابت هر صفحه یا کاراکتر به قیمت جاری ارجاع دهید.

شواهد و محدودیت‌های یکپارچه‌سازی

مستندات رسمی تنظیم custom-address را تثبیت می‌کند. درخواست افزونه نصب‌شده از مسیر APIsRouter برای این مقاله آزمایش نشده است؛ بنابراین رفتار دقیق نشانی، سازگاری مدل و نتیجه renderشده هنوز کنترل setup هستند. نمودار جریان پیکربندی نمونه است.

رکورد سازگاری کامل باید نسخه افزونه و مرورگر، تنظیمات پاک‌سازی‌شده، مقصد درخواست، مدل دقیق، صفحه منبع کنترل‌شده و ترجمه مشاهده‌شده را داشته باشد. بازبینی فیلد محافظت‌شده را از کنترل انتقال جدا نگه دارید. قطعه کوتاه موفق خودکار همه قالب‌های سند یا گردش‌کار انتشار فروشگاه را اعتبارسنجی نمی‌کند.

پرسش‌های پرتکرار