תיעוד API ונקודות קצה

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

ה-API דורש מפתח תקף לכל בקשה. אתה יוצר מפתח זה באופן מיידי כשאתה נרשם עם Google או כתובת אימייל. העבר את המפתח ב- Authorization כותרת באמצעות Bearer שיטה. כתובת הבסיס לכל הבקשות היא HTTPS://api.qwenaipricing.com/v1. כתובת URL זו עובדת עם ה-SDKs הרשמיים של OpenAI וכל לקוח תואם על ידי עדכון תצורת הבסיס בלבד.

נקודת קצה להשלמות צ'אט

הנקודה הקצה העיקרית היא POST /v1/chat/completions. הוא מקבל גוף JSON עם messages מערך ו- model שדה. הגדירו את מזהה המודל ל-"uncensored" כדי לגשת למודל השפה הגדול המכוון לפלט ללא הגבלות. אתם יכולים להגדיר תפקידי מערכת, משתמש ועוזר כדי למבנות את הקשר של השיחה.

Copycurl https://api.qwenaipricing.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "What is the monthly cost for the 72B model?"}]
  }'

התגובה כוללת את התוכן שנוצר, סטטיסטיקות שימוש וסיבת סיום. שגיאות מחזירות קודי HTTP סטנדרטיים כמו 401 למפתחות לא חוקיים או 402 אם האשראי שלך שולם מראש אזל. ה-API אינו תומך באינטגרציות של הטמעות (embeddings), יצירת תמונות או נקודות קצה לדיקוק עדין (fine-tuning).

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

השתמשו ב openai חבילת Python לתקשורת עם ה-API. אתחל את הלקוח על ידי ספקת מפתח ה-API שלך והגדרת כתובת ה-URL הבסיסית לנקודת הקצה שלנו. זה מאפשר לך להשתמש בשיטות מוכרות כמו chat.completions.create() ללא כתיבת מחדש של לוגיקת הלקוח שלך. הספרייה מטפלת ברישום JSON ובניתוח התגובות באופן אוטומטי.

Copyfrom openai import OpenAI

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

העבירו את ההודעות שלכם כרשימה של מילונים. ה-SDK תומך בכל הפרמטרים הסטנדרטיים כמו temperature ו-top_p. גישה זו מבטיחה תאימות לקוד קיים שמצפה לממשק התואם ל-OpenAI.

שילוב SDK Node.js

SDK Node.js עובד באופן דומה לגרסת Python. התקן את openai חבילה וקונפיגור את כתובת הבסיס ומפתח ה-API. לאחר מכן תוכל לקרוא לנקודת הסיום של השלמת צ'אט עם הפרמטרים הרצויים שלך. שיטה זו אידיאלית ליישומי צד שרת או שירותי Backend שצריכים לייצר טקסט באסינכרוני.

Copyimport OpenAI from "openai";

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

טפל בזרם התגובה או בהבטלה (promise) לעיבוד הטוקנים שנוצרו. ה-SDK מנהל את חיבור ה-HTTP ואת טיפול בשגיאות עבורך. ניתן גם להשתמש ב GET /v1/models נקודת קצה (endpoint) לאימות מזהה המודל הזמין.

שידור חי ונתוני שימוש

אפשרו זרימה על ידי הגדרת stream: true בבקשה שלך. ה-API מחזיר זרם של אירועים שנשלחו על ידי השרת (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)

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

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

המודל תומך בחלון הקשר של 100,000 טוקנים לשילוב של פרומפט והשלמה. המקסימום לפלט בכל בקשה הוא 16,000 טוקנים. אם לא קבעתם max_tokens, הגבלה היא 2,048 טוקנים. מותר לך לבצע 300 בקשות לדקה ו-8 בקשות מקבילות לכל מפתח. שגיאת 429 מציינת שחרגת ממגבלות אלו. בקשות עם שגיאות או דחייה לא צורכות אשראי. ה-API לא מציע הבטחות SLA או הסמכות.