הבנת כתובת הבסיס
כתובת הבסיס מגדירה לאן הלקוח שלך שולף בקשות. אי-התאמה כאן גורמת לכשל חיבור מיידי או לתגובות מודל בלתי צפויות. הרבה מפתחים מניחים שכתובת ה-OpenAI הסטנדרטית עובדת באופן אוניברסלי, אך ספקים ללא צנזורה משתמשים לעיתים קרובות בנקודות קצה שונות כדי להפנות תעבורה לאגפי מודלים ספציפיים.
ודאו שהתצורה שלכם מצביעה על https://api.openrouterabliteratedmodels.com/v1 לשירות שלנו. אם אתה משתמש באגרגטור צד שלישי, ודא שהכתובת הבסיסית תואמת בדיוק לתיעוד שלהם. כתובות שגויות מובילות לעיתים קרובות לשגיאות 404 או לתגובות ממודלים ברירת מחדל במקום הגרסה ללא הצנזורה המיועדת.
- בדקו את משתני הסביבה שלכם עבור
BASE_URLאוAPI_HOST. - ודאו שהנתיב כולל
/v1לתאימות סטנדרטית. - בדוק חיבור עם בקשת רשימת מודלים פשוטה לפני שימוש כבד.
טיפול בסיכוני קצב בקשות
מגבלות קצב מגבילות את מספר הבקשות שאתה יכול לשלוח בטווח זמן מסוים. ה-API שלנו מחיל מגבלה של 300 בקשות לדקה לכל מפתח. חריגה מהסף הזה גורמת לשגיאות HTTP 429, החוסמות זמנית בקשות נוספות עד לתום המסגרת הזמנית.
בנוסף, יש מגבלה של בקשות מקבילות של 8 בקשות בו זמנית לכל מפתח. אם אתה שולח יותר מ-8 בקשות סימולטניות, העודף יעמוד בתור או ייכשל בהתאם לספריית הלקוח שלך. עקוב אחר הקונקרנטיות של היישום שלך כדי להימנע מהגעה למגבלות קשות אלו. השתמש באסטרטגיות החזרה מעריכית בקוד שלך כדי לטפל בשגיאות 429 בצורה חלקה מבלי להציף את השרת.
זכור שכל מפתח הוא ייחודי לחשבון שלך. שיתוף מפתחות בין שירותים מרובים יכול להאיץ את הגעה למגבלות אלו. צור מפתח חדש אם אתה צריך מאגרי מגבלות קצב נפרדים לחלקים שונים של האפליקציה שלך.
תגובות בזרימה לעומת לא בזרימה
תגובות בזרם מחזירות נתונים בהדרגה כפי שנוצרות מילים אחרונות, בעוד שזרימה ללא זרימה מחכה לתגובה המלאה. זרימה חיונית לחוויות משתמש בזמן אמת אך דורשת טיפול קפדני באירועים מרוחקים מוגדרים (SSE).
בעת זרימה, הבלוק הסופי מכיל סטטיסטיקות שימוש בטוקנים. אם תפסיקו לעבד מוקדם מדי, ייתכן שתפספסו נתונים אלו. ודאו שהלקלינט שלכם מנתח את ההודעה האחרונה של SSE כדי לקבל את מנייני הטוקנים של הקלט והפלט במדויק. תגובות ללא זרימה פשוטות יותר אך עלולות לגרום לזמן המתנה גבוה עבור פלט ארוך.
בחרו בזרימה לממשקי צ'אט שבהם המשתמשים רואים טקסט מופיע תו אחר תו. השתמשו בזרימה לא-זורמת לעיבוד אצווה או כאשר אתם זקוקים לתגובה המלאה לפני המשך. ממשק ה-API שלנו תומך בשני המצבים דרך ה- stream פרמטר בגוף הבקשה.
שגיאות במצב JSON
מצב JSON מבטיח שהמודל מפיק JSON תקף, מה שקריטי לשילוב תכנותי. שגיאות כאן נובעות לעיתים קרובות מכותרות שגויות או אי-התאמות סכמה. ה-API דורש response_format: {"type": "json_object"} כדי לאכוף פלט JSON קפדני.
אם אתה מקבל JSON לא תקין, בדוק את הגדרת הסכמה שלך. המודל עשוי לכלול בלוקי קוד Markdown או הסברים מחוץ למבנה ה-JSON. השתמש במנתח חזק שיכול להסיר מסגרות Markdown או לאמת את הפלט מול הסכמה הצפויה שלך. הימנע מסכמות מורכבות מדי שעלולות לבלבל את המודל.
בדקו עם מבנים פשוטים תחילה. הוסיפו הדרגתית מורכבות כדי לזהות היכן המודל מתקשה. ודאו שהטמפרטורה שלכם מוגדרת כראוי, שכן טמפרטורות גבוהות יותר יכולות להגביר אקראיות ולהפחית את תקפות ה-JSON.
חישובים שגויים של ספירת טוקנים
ספירות טוקנים קובעות את החיוב שלך ואת שימוש חלון ההקשר. חישובים שגויים יכולים להוביל לחיובים לא צפויים או לתגובות מקוטעות. ה-API שלנו גובה $0.15 על כל 1M טוקני קלט ו-$0.50 על כל 1M טוקני פלט.
השתמשו בספריית טוקניזציה אמינה התואמת את שיטת הטוקניזציה של המודל. מודלים שונים עשויים לטוקניזר רווחים או פיסוק בצורה שונה, מה שיוביל לשינויים בין הספירה המקומית שלכם לספירת ה-API. תמיד הסתמכו על שימוש הטוקנים המוחזר בתגובה לחיוב מדויק.
שימו לב לחלון ההקשר שלכם, המכיל 100,000 טוקנים בסך הכל. חריגה מגבול זה תגרום לשגיאות. חתכו הודעות או סיכומים ישנים כדי להישאר בטווח. מעקב אחר צריכת הטוקנים לאורך זמן יעזור לכם לייעל את מבנה הפקודה ולהפחית עלויות.
עיכובים בתשלום קריפטו
הטענות בקריפטו באמצעות USDT (TRC20) או USDC (Base) מעובדות מיידית אצלנו. עם זאת, עומס ברשת עשוי לעיתים לגרום לעיכובים קלים באישור. ודא שאתה שולח את הסכום והרשת הנכונים כדי להימנע מאובדן.
העלאות נעות בין $20 ל-$500 בסכומים שלמים. קרדיטים בונוס חלים אוטומטית: +5% מ-$50, +10% מ-$100, ו+15% מ-$200. אשר את hash העסקה כדי לאשר תשלום. אם קרדיטים לא מופיעים תוך כמה דקות, בדוק את משתנה הבלוקים למצב העסקה.
הקרדיט אינו פג תוקף, כך שאין דחיפות להשתמש בו מיד. טעויות כמו חיובים כפולים נפתרות דרך דף התמיכה. שמור את רשומות העסקה שלך לקבלת הפניה קלה אם יתעוררו בעיות.
תצורת מזהה מודל
מזהה המודל מזהה איזו גרסה של מודל ה-uncensored שאתה משתמש. עבור השירות שלנו, מזהה המודל הוא uncensored. שימוש ב-ID שגוי עלול לגרום לשגיאות או להתנהגות בלתי צפויה.
ודאו שהבקשות שלכם מציינות model: "uncensored" בגוף הבקשה. מזהה זה מצביע על המודל בעל המשקל הפתוח הספציפי שלנו המותאם לתגובות ללא הגבלה. זה לא מזהה כללי אלא מצביע ספציפי לאינסטנס המאוחסן שלנו.
בדקו את התיעוד של ספריית הלקוח שלכם לראות כיצד להגדיר את זיהוי המודל. חלק מהספריות משתמשות ב- model שדה, בעוד אחרים עשויים להשתמש בפרמטר אחר. עקביות בשימוש ב-MID (מזהה המודל) ברחבי האפליקציה שלכם מונעת בלבול ומבטיחה שאתם תמיד קוראים למודל ללא צנזורה המיועד.
חריגות חלון ההקשר
חלון ההקשר מגביל את מספר הטוקנים הכולל שניתן לשלוח בבקשה בודדת. ה-API שלנו תומך בחלון של 100,000 טוקנים, כולל פלט והשלמה. חריגה ממגבלה זו תגרום לשגיאה.
כדי לנהל הקשר, יישם אסטרטגיית חלון גולש. הסר הודעות ישנות יותר או סיכום אותן כדי לשחרר מקום. מעקב אחר ספירת הטוקנים של הקלט שלך כדי לוודא שהוא נשאר בתוך מגבלת ה-100,000 טוקנים. אם תעבור את המגבלה, ה-API ידחה את הבקשה.
השתמשו ב max_tokens פרמטר לשליטה באורך הפלט. מקסימום הפלט לכל בקשה הוא 16,000 טוקנים. הגדרת פרמטר זה עוזרת למנוע שימוש מוגזם בטוקנים ושומרת על התגובות במסגרת סבירה לאפליקציה שלך.
מדיניות תמיכה והחזרים
קרדיט אינו מוחזר לאחר שימוש בו, אך הוא לא פג תוקף. אם תתקל בבעיות עם תשלומים או שירות, צור קשר עם התמיכה דרך הדף המיועד. טעויות כמו חיובים כפולים נפתרות על ידי צוות התמיכה.
לבעיות טכניות, בדוק תחילה את התיעוד. ה-API שלנו פשוט, אך עשויים להופיע מקרי קצה. ספק את מפתח ה-API ופרטי הבקשה בעת פנייה לעזרה. זמני התגובה משתנים, אך אנו שואפים לפתור בעיות במהירות.
זכור שהאשראי הוא בתשלום מראש. אתה משלם על מה שצרכת, כאשר שגיאות ודחיות הן בחינם. מודל זה מבטיח שקיפות בחיובים. השתמש בדף התמיכה לכל חוסר התאמה או שאלות לגבי החשבון שלך.
