תיעוד API: השלמת צ'אט

כתובת URL בסיסית ואימות

כתובת ה-URL הבסיסית היא https://api.routeria.cc/v1. העבר את מפתח ה-API שלך ב Authorization כותרת. שגיאות ודחיות הן חינמיות, כך שאתה משלם רק עבור טוקנים שנוצרו.

• GET /v1/models מציג מודלים זמינים.
• POST /v1/chat/completions מטפל ביצירת טקסט.

האימות הוא קפדני. שגיאת 401 משמעה שהמפתח לא חוקי או חסר. שגיאת 402 מציינת חסר באשראי ששולם מראש. ניתן להטעין מחדש עם USDT (TRC20) או USDC (Base).

בקשה ראשונה עם cURL

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

עליך להגדיר את Content-Type header ל application/json. גוף הבקשה כולל את מזהה המודל ואת מערך ההודעות שלך.

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

Copycurl https://api.routeria.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "explain how the router handles packet loss"}]
  }'

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

השתמשו ב-SDK הרשמי של OpenAI ל-Python. הגדירו את כתובת הבסיס ל https://api.routeria.cc/v1 והספק את מפתח ה-API שלך. מזהה המודל נשאר uncensored.

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

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.routeria.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)

שימוש ב-Node SDK

אתחל את הלקוח עם כתובת ה-URL הנכונה ומפתח ה-API. העבר את מזהה המודל uncensored בקריאות ההשלמה שלך.

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

ודאו שמשתני הסביבה מאחסנים את המפתח בצורה מאובטחת. מפתח ה-API מוצג מיד עם ההרשמה דרך Google או דוא"ל.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.routeria.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);

שימוש בטוקנים וסטרימינג

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

החלק האחרון מכיל את סטטיסטיקות השימוש המלאות בטוקנים. טוקני קלט נגבים ב-$0.15 לכל 1M טוקנים. טוקני פלט עולים $0.50 לכל 1M טוקנים.

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

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)

פקודות פונקציה ומצב JSON

אפשרו קריאת פונקציות עם ה tools פרמטר. המודל תומך tool_choice לשליטה קפדנית. השתמש response_format: {"type": "json_object"} לפלט מבני.

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

ניתן לשלב כלים עם זרם. המודל יפעיל פונקציות לפי הצורך. כל הפרמטרים כמו temperature וגם top_p נתמכים.

פרמטרים: טמפרטורה, Top-P, Stop

התאם temperature ליצירתיות. ערכים נמוכים הופכים את הפלט לדטרמיניסטי יותר. top_p שולטת בסינון גרעין (nucleus sampling). הגדירו stop רצפים לעצירת ייצור.

פרמטרים נתמכים נוספים כוללים seed, presence_penalty, וכן frequency_penalty. אלו מאפשרים עיבוד עדין של סגנון הפלט.

הפלט המקסימלי המוגדר כברירת מחדל הוא 2,048 טוקנים. ניתן להגדיל אותו עד ל-16,000 טוקנים לכל בקשה. חלון ההקשר הכולל הוא 100,000 טוקנים.

מגבלות ומכסות

כל מפתח API מוגבל ל-300 בקשות לדקה. ניתן לבצע 8 בקשות מקבילות לכל מפתח. גודל גוף הבקשה מוגבל ל-8 MB.

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

מזהה המודל הוא תמיד uncensored. זהו לא GPT, Claude או כל מודל ספק אחר. זהו מודל בעל משקל פפתוח המופעל על השרתים שלנו.