באמצעות base_url שגוי
שימוש בכתובת הבסיס הסטנדרטית של OpenAI גורם לבקשות שלך להיכשל או להפנות למודל אחר לחלוטין. ה-API שלנו דורש ממך לשנות את base_url אל https://api.whatisopenrouterai.com/v1. שורת תצורה אחת מבטיחה שה-SDK שלך מתחבר לשרתים שלנו במקום לתשתית הגלובלית של OpenAI.
מפתחים רבים מעתיקים-מדביקים את הקוד הקיים שלהם מבלי לעדכן משתנה זה. אם תשאיר את כתובת ה-URL המוגדרת כברירת מחדל, תקבל שגיאת 404 או תפגע במודל שאינו ללא צנזורה. תמיד אשר את החיבור על ידי בדיקת ה /v1/models נקודת קצה. עליך לראות את מזהה המודל הספציפי שלנו רשום שם. זה מאשר שהניתוב נכון לפני שליחת בקשת ההשלמה הראשונה שלך.
שכחת להגדיר את מזהה המודל
גם עם כתובת הבסיס הנכונה, השמטת מזהה המודל מובילה למודל גנרי או ישן יותר. עליך להגדיר במפורש את ה model פרמטר ל "uncensored" בכל בקשה. זה אומר לשכבת הניתוב שלנו לספק את מודל המשקל הפתוח הספציפי שהותאם לתוכן ללא הגבלה.
ללא הוראה מפורשת זו, ייתכן שתקבל מודל אחר עם כללי יישור שונים. חלק מהמודלים מסרנים נושאי בוגרים חוקיים כברירת מחדל. על ידי אילוץ ה uncensored ID, you guarantee the behavior you expect. Check your code for any hardcoded model names that might override your SDK defaults.
התעלמות ממגבלות אסימונים ושגיאות
חריגה מחלון ההקשר של 100,000 טוקנים או מגבול הפלט של 16,000 טוקנים גורמת לכשל מיידי בבקשה. ה-API שלנו אוכף מקסימום פלט של 16,000 טוקנים לכל בקשה. אם אינך מגדיר max_tokens, ברירת המחדל היא רק 2,048 טוקנים. זה לרוב קצר מדי עבור משימות חשיבה מורכבות.
שגיאות וסירובים אינם צורכים את הקרדיט המוקדם שלך. עם זאת, בקשות לא תקינות שפוגעות במגבלות קצב או חורגות מגודל הגוף (8 MB) עדיין נספרות נגד המכסה שלך. עקוב אחר כותרות התגובה שלך לצריכת טוקנים. התאם את הנדסת הת prompts שלך כדי להתאים לתוך חלון ההקשר. זה מונד נסיונות חוזרים יקרים ומבטיח זרימת נתונים חלקה.
הבנה שגויה של תשלום מראש
יתרת החשבון שלך קשורה לאשראי ששולם מראש, לא למנוי חודשי. אנו גובים $0.15 על כל 1M אסימוני קלט ו-$0.50 על כל 1M אסימוני פלט. שגיאות ללא תשלום, אך השלמות מוצלחת צורכת אשראי. עליך להעמיס באמצעות קריפטו כדי לשמור על זמינות השירות.
אנו מקבלים USDT (TRC20) או USDC (Base) להטענות. הפקדות מינימליות מתחילות ב-$20. בונוסים חלים ברמות גבוהות יותר: +5% החל מ-$50, +10% החל מ-$100, ו+15% החל מ-$200. האשראי אינו פג תוקף. ודא שיתרתך חיובית לפני הרצת קבצים גדולים. בדוק בלוח הבקרה כדי לאמת את יתרתך הנוכחית ואת העסקאות האחרונות.
בלבול בין זרימה לתגובות סטנדרטיות
זרימה באמצעות SSE משנה את אופן הניתוח של זרם התגובה. תגובות סטנדרטיות מחזירות אובייקט JSON בודד. זרימה מחזירה חלקים מרובים. עליך לטפל בחלק הסופי כדי לקבל סטטיסטיקות שימוש בטוקנים מדויקות.
יישום הזרמת הנתונים שלנו כולל שימוש בטוקנים בחלקיק האחרון. אם תפסיק לקרוא את הזרם מוקדם מדי, ייתכן שתפספס נתונים אלו. ודא שהספרייה שלך תומכת ב-SSE כראוי. זה קרישי ליישומים בזמן אמת שבהם מציגים טוקנים ככל שהם נוצרים. תצורה שגויה של הזרמה עלולה להוביל לטקסט לא שלם או למצבי ממשק משתק.
שגיאות תצורת tool_choice
לא נכון tool_choice הגדרות יכולות למנוע מקריאת פונקציות לעבוד כראוי. ניתן לאלץ כלי ספציפי או להשאיר למודל להחליט. תצורה שגויה מובילה לעיתים קרובות לכך שהמודל מתעלם מכלים זמינים.
שימוש tool_choice לשליטה האם המודל קורא לכלים באופן אוטומטי. הגדר אותו ל "auto" לגמישות או ציין מזהה כלי להתנהגות מחייבת. ודא שהגדרות הכלי שלך תואמות את הסכמה הצפויה. זה נמנע שגיאות ריצה כאשר המודל מנסה לקרוא לפונקציה שאינה קיימת. בדוק את הגדרות הכלי שלך לעומק לפני פריסה לסביבת ייצור.
מצב json_object חסר
ללא response_format: {"type": "json_object"}, המודל עשוי להפיק מרקדאון או טקסט רגיל. זה שובר מנתחים שמצפים ל-JJSON קפדני. הפעל מצב JSON כדי להבטיח פלט עקבי וניתן לפיענוח.
תכונה זו חיונית לשילוב עם מערכות זרועות הדורשות נתונים מובנים. זה מפחית משמעותית את העומס של עיבוד לאחר קבלה. תמיד אשר את סכמת הפלט בקוד הלקוח שלך. זה מבטיח חוסן בפני הולכות שווא אקראיות של המודל. השתמש במצב זה בעת חילוץ ישויות או יצירת קבצי תצורה.
הפתעות במגבלות קצב
ה-API שלנו מאפשר 300 בקשות לדקה לכל מפתח. חריגה מגבול זה גורמת לתגובת 429 Too Many Errors. בקשות מקבילות מוגבלות ל-8 לכל מפתח. תכנן את הגדרות המקבילות שלך בהתאם.
אם אתה מריץ מספר תהליכים, ודא שהם משתמשים באותו מפתח או צור מפתחות נפרדים. כל חשבון תומך במפתח פעיל אחד. מפתח חדש מחליף את הישן. מעקב אחר כותרות מגבלת הקצב בתגובה. יישום החזרה מעריכית בלוגיקת האיחוד שלך. זה מונע כשלונות רצופים במהלך תקופות עומס גבוה.
עיכובים בהעמסת קריפטו
עסקאות קריפטו עשויות לקחת זמן לאישור על הבלוקצ'יין. האשראי שלך עשוי לא להופיע מיד לאחר שליחת הכספים. השתמש ברשת הנכונה: TRC20 עבור USDT או Base עבור USDC. שליחה לרשת הלא נכונה גורמת לאובדן כספים.
העמלות נעות בין $20 ל-$500. ודא שאתה שולח את הסכום המדויק או התחשב בעמלות הרשת. בדוק את hash העסקה במדדן הבלוקצ'יין. אם הקרדיט מתעכב, פנה לתמיכה עם מזהה העסקה. אל תניח שהתשלום נכשל מיד. סבלנות במהלך עומסי רשת היא המפתח לתפעול חלק.
