הגדרת API מותאם אישית ל-Immersive Translate

Updated 2026-09-05

השתמשו בהגדרת הכתובת המותאמת המתועדת כדי להעריך endpoint תרגום. התחילו בדף מבוקר ואז השתמשו בקריאה דו-לשונית לתמיכה בבדיקה עריכתית.

פתחו את הגדרות שירות OpenAI

דף שירות OpenAI הרשמי של Immersive Translate מתעד כתובת API מותאמת תחת More Settings. התחילו שם בעת הערכת endpoint תואם OpenAI. תעדו את גרסת התוסף ואת הדפדפן כדי שבדיקת הגדרה מאוחרת תתייחס לסביבה שניתנת לשחזור.

בחרו תצורה אחת לבדיקה הראשונה והשאירו את הגדרות ברירת המחדל זמינות להתאוששות. הזינו את פרטי הגישה רק בהגדרות הפרטיות של התוסף. אשרו שה-endpoint הוא הנמען המיועד לפני שליחת תוכן דף, במיוחד כאשר לדפדפן יש גם גישה למסכי ניהול סוחר.

בדקו אם הכתובת היא בסיס או נתיב מלא

אל תניחו שכל שדה כתובת מותאמת מתנהג כמו baseURL של SDK. הדף הרשמי כולל URL מלא של chat-completions בדוגמת Azure שלו. בדקו את טקסט העזרה בתוסף המותקן ואת נתיב הבקשה היוצאת שעבר sanitization כדי לקבוע כיצד הכתובת משמשת.

עבור מועמד chat-completions של APIsRouter, הנתיב המלא הוא https://api.apisrouter.com/v1/chat/completions. אם הגרסה המותקנת שלכם מצפה במפורש ל-URL בסיס ומוסיפה את הנתיב, השתמשו ב-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

שמרו על נראות נתיב בקשת התרגום

התוסף שולח בקשות תרגום לכתובת השירות שנבחרה. התייחסו לכתובת הזו כהחלטה של שיתוף נתונים, לא רק כשדה קישוריות. השתמשו בתוכן שבבעלותכם או שמותר לכם לעבד דרך ה-endpoint שנבחר, ובדקו כמה מהדף פעולת התרגום שנבחרה כוללת.

הזרימה שלהלן ממחישה את נתיב ה-gateway המוצע באמצעות מנגנון הכתובת המותאמת המתועד. תווית המודל שנבחר היא בחירת תצורה, לא רשימת מודלים מאומתים. אימות חנות, עריכת מוצר ואישורי ייבוא נמצאים מחוץ לנתיב הבקשה הזה.

נתיב מותאם מוצע של 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
עקיפת כתובת מתועדת; תצורת gateway מוצעת שממתינה לבדיקת תוסף. תרגום דפדפן אינו כותב שדות קטלוג.

אמתו תחילה דף מבוקר אחד

השתמשו בדף קצר עם תיאור מוצר סינתטי, מונח מותג מוגן, כמות עם יחידה וקישור. תרגמו רק את הדף הזה. השוו את התוצאה הנראית למקור ובדקו את יעד הרשת שעבר sanitization, את המודל שנבחר ואת status התגובה.

בדקו אם תוכן הושמט, שוכפל או עורבב עם שפת המקור. לאחר מכן נסו פסקה ארוכה יותר ופריסה עם כותרות או רשימות. שמרו את המקור ואת הפלט שנצפה כדי שאפשר יהיה להשוות שינוי תצורה מאוחר לאותו חומר. כך מתקבל בסיס אבחון שימושי לפני עיבוד מסמך גדול.

השתמשו בקריאה דו-לשונית לשאלות עריכה

תרגום דפדפן יכול לעזור לבודק לבדוק חומר מקור לא מוכר או לזהות ביטוי שדורש תשומת לב. השאירו את המקור גלוי והשוו ישירות טענות, כמויות ומינוח. אם הבודק אינו יכול להעריך את שפת היעד, העבירו את המועמד למי שיכול במקום לקבל מראה שוטפת כהוכחה.

שמרו החלטות מילון בתהליך הקטלוג. אל תניחו ש-endpoint מותאם מספק גם אכיפת מילון או אימות ברמת שדה בתוך התוסף. תיאורי מוצר שמיועדים לייבוא עדיין צריכים מועמד משלהם המקושר למקור, תוצאת בדיקה ומיפוי יעד.

אבחנו שגיאות לפני תרגום תוכן נוסף

התחילו בנתיב הבקשה, בפרטי הגישה וב-ID המודל המדויק. תעדו שגיאות מובנות כאשר הן זמינות והשחירו כותרות לפני שיתוף ראיות. אם יש הגבלות על בקשות, צמצמו את העבודה וכבדו את הנחיות הניסיונות של השירות במקום לחזור במהירות על תרגום של עמוד מלא.

השתמשו בקטע נבחר קטן יותר כדי להבחין בין כשל חיבור לבעיות תוכן או טיפול בתגובה. שנו הגדרה אחת בכל פעם. הדף הרשמי כולל דוגמאות היסטוריות למחיר וקצב בקשות; השתמשו בתיעוד ובמגבלות החשבון של ה-endpoint הנוכחי במקום להעתיק את המספרים האלה להגדרה חדשה.

תסמיןמה לבדוקבדיקה הבאה
שגיאת נתיבURL סופי בפועלטיפול בבסיס לעומת נתיב מלא
שגיאת אימותמנפיק פרטי גישה ויעדהגדרות פרטיות והיקף המפתח
מודל נדחהשדה model מדויק בבקשהזכאות קטלוג וחשבון
מגבלת קצבmetadata של תגובה ועומס עבודהאצווה קטנה יותר וניסיון חוזר מוגבל
תרגום חלקיתוכן מוחזר ופילוח דףהשוואת קטע מבוקר

הפרידו פלט דפדפן ממסירת קטלוג

תצוגת דפדפן מתורגמת היא משטח בדיקה. כדי לפרסם טקסט מוצר, צרו מועמד בחבילת בדיקת הקטלוג, שמרו מזהים ו-revisions מקור, ואז העבירו שדות מאושרים דרך נתיב הייבוא או API התרגום האמיתי של החנות.

אמתו מסירה באמצעות קריאת שדות שנשמרו ופתיחת ה-locale המיועד בחנות. אל תסתמכו על תוסף דפדפן של עורך כדי להוכיח מה מבקר רגיל יראה. תעדו usage של בקשות תרגום בנפרד מפעולות חנות והתחשבו בניסיונות חוזרים בעת הערכת עומס העבודה. עיינו במחירים הנוכחיים במקום להניח עלות קבועה לדף או לתו.

ראיות ומגבלות אינטגרציה

התיעוד הרשמי מבסס הגדרת כתובת מותאמת. בקשה של תוסף מותקן דרך APIsRouter לא נבדקה עבור מאמר זה, לכן התנהגות הכתובת המדויקת, תאימות המודל והתוצאה המרונדרת עדיין הן בדיקות הגדרה. התרשים הוא תהליך תצורה להמחשה.

רשומת תאימות שהושלמה צריכה לכלול גרסאות תוסף ודפדפן, הגדרות שעברו sanitization, יעד בקשה, מודל מדויק, דף מקור מבוקר ותרגום שנצפה. שמרו בדיקת שדות מוגנים נפרדת מבדיקת התעבורה. קטע קצר שהצליח אינו מאמת אוטומטית כל פורמט מסמך או תהליך פרסום חנות.

שאלות נפוצות

היכן משנים את כתובת ה-API?

תיעוד שירות OpenAI הרשמי מצביע על More Settings. בדקו את גרסת התוסף המותקנת ואת עזרת השדה שלו בעת בחירת פורמט הכתובת הסופי.

מדוע URL מועתק עם /v1 נכשל לפעמים?

כלים שונים בשאלה אם הם מוסיפים נתיב או מצפים ל-URL מלא של בקשה. בדקו את הנתיב היוצא בפועל והימנעו ממקטעי chat-completions חסרים או כפולים.

איזה פרטי גישה שייכים לתצורה המותאמת?

השתמשו בפרטי גישה שהונפקו ל-endpoint שהוגדר והזינו אותם באופן פרטי. פרטי גישה של ספק אחר או token ניהול חנות אינם תחליף.

האם דף מוצר מתורגם מעדכן את החנות?

תרגום דפדפן אינו אחסון קטלוג. השתמשו בנתיב תרגום או ייבוא חנות ואמתו שדות שנשמרו כדי למסור טקסט מוצר מאושר.

כיצד לשמר מינוח מוצר?

נהלו מילון שנבדק בתהליך התוכן והשוו את תוצאת הדפדפן אליו. אמתו בנפרד כל תכונת מילון ספציפית לתוסף במקום להניח שהכתובת המותאמת אוכפת מונחים.