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