תיעוד API & מדריך התחלה מהיר

אימות & כתובת הבסיס

התחל על ידי יצירת מפתח ה-API שלך בדשבורד. אנחנו משתמשים בכותרות סטנדרטיות OpenAI-compatible, כך שאתה צריך רק לעדכן את ה- base_url וגם API_KEY משתנים. זה מבטיח שהאינטגרציות הקיימות שלך עם ה-SDK יעבדו ללא שינוי. אנו תומכים ב-Google Sign-In או בהרשמה באמצעות אימייל/סיסמה, והמפתח שלך מופיע מיד עם היצירה.

• כתובת בסיס: https://api.routeropen.cc/v1
• כותרת Auth: Authorization: Bearer YOUR_API_KEY

שמור על המפתח שלך מאובטח, כיוון שהוא שולט באשראי ששולם מראש. כל חשבון מאפשר מפתח פעיל אחד בכל עת; יצירת מפתח חדש מחליף את הישן מיד.

בקשה ראשונה

שלחו prompt ראשון באמצעות ה- chat/completions נקודת קצה. מזהה המודל הוא פשוט uncensored. זה שולח טקסט פנימה ומחזיר טקסט החוצה, ללא מסנני תוכן לשימוש מבוגר חוקי.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

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

אינטגרציית SDK Python

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.routeropen.cc/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

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

שילוב Node SDK

למפתחי JavaScript, ה-Node SDK עובד עם שינויים מינימליים. הגדר את baseURL לנקודת הקצה שלנו וספק את המפתח שלך. זה מאפשר לך לשמור על זרימת העבודה הפיתוחית הנוכחית שלך תוך גישה למודלים ללא סינון.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.routeropen.cc/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

משתמשי Node יכולים לנצל את תבניות async/await לקוד נקי. מבנה התגובה תואם את סטנדרטים של OpenAI, מה שמבטיח תאימות עם מנתחים קיימים. ניתן להחליף מודלים או ספקים על ידי שינוי של שני משתנים בלבד.

תגובות בסטרימינג

אפשרו זרימה על ידי הגדרת stream: true בקשתך. אנו מחזירים אירועים מוכווני-שרת (SSE) למסירת טוקנים בזמן אמת. זה מפחית את תחושת זמן התגובה עבור משתמשים סופיים.

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

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

מגבלות, שגיאות & הקשר

ה-API שלנו מחייב חלון הקשר של 100,000 טוקנים ומגבלת גוף בקשה של 8MB. ניתן לבצע 300 בקשות לדקה לכל מפתח. אם תחרוג מזה, תקבל שגיאת מגבלת קצב 429. כשלי אימות מחזירים 401, וקרדיט לא מספיק מחזיר 402.

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