מודל apis מדריך התחלה מהירה

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

נקודת הקצה נמצאת ב https://api.modelapis.cc/v1. העבר את המפתח שלך ב Authorization header כערך bearer token. המערכת דוחה בקשות עם מפתחות לא חוקיים באמצעות שגיאות 401 וחסמת ניסיונות להוציא אשראי שאינו ברשותכם באמצעות שגיאות 402. ניתן ליצור מפתח חדש מיד בלוח הבקרה, והמפתח הישן הופך לא פעיל מיד.

שליחת השלמת צ'אט

שלחו בקשת POST ל /v1/chat/completions עם היסטוריית ההודעות שלך. מזהה הדגל הוא "uncensored" והוא מקבל פרמטרים סטנדרטיים כמו temperature וגם top_p. תצורה זו עובדת עם כל לקוח התומך בפרוטוקול OpenAI, כולל Cursor וכלי פיתוח אחרים.

Copycurl https://api.modelapis.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "get current unix timestamp"}]
  }'

בדוק את התגובה ל content field inside the assistant message. If you exceed your rate limit, the API returns a 429 status code. You can monitor your remaining balance directly in the dashboard dashboard without needing to parse headers manually.

תגובות בסטרימינג באמצעות SSE

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

Copyfrom openai import OpenAI

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

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

פקודות פונקציה וכלים

הגדירו את הכלים שלכם ב- tools פרמטר והגדירו את tool_choice אל auto. המודל מחזיר קריאות כלי מבניות כאשר מתאים, ומאפשר ליישום שלך לבצע פונקציות חיצוניות. תכונה זו עובדת בצורה חלקה עם ה-SDKs הסטנדרטיים של OpenAI.

Copyimport OpenAI from "openai";

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

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

אכיפת מצב JSON

הגדר response_format אל {"type": "json_object"} לכפות על המודל להפיק JSON תקף. זה קרישי ליישומים המנתחים את התגובה תוכנית. המודל יקפיד על אילוץ זה בקפידה.

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

מגבלות טוקנים וחלון הקשר

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

בקשות מוגבלות ל-300 לדקה לכל מפתח. גודל גוף הבקשה המקסימלי הוא 8 MB. מגבלות אלו מבטיחות ביצועים יציבים לשימוש בנפח גבוה. שגיאות וסירובים לא צורכים את האשראי המוקדם שלכם, כך שתשלמו רק על יצירות מוצלחות.

זרימה

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)