מדריך התחלה מהירה לממשק API של Qwen AI

אימות & הגדרת כתובת הבסיס

התחל על ידי יצירת מפתח ה-API שלך בדשבורד. כתובת הבסיס היא https://api.qwenaiapi.com/v1 ותעביר את המפתח שלך ב- Authorization header. תצורה זו עובדת עם כל לקוח SDK סטנדרטי של OpenAI ללא שינויי קוד. אתה מקבל מפתח פעיל אחד לחשבון; יצירת מפתח חדש מבטלת מיד את המפתח הקודם. אין צורך במספר טלפון להרשמה.

בקשה ראשונה

שלחו בקשת POST ל /v1/chat/completions עם המפתח שלך ומזהה הדגם. מזהה הדגם הוא uncensored והוא מגיב להודעות צ'אט סטנדרטיות. תוכל לבדוק חיבוריות עם הודעת מערכת פשוטה כדי לאמת זמן תגובה ופורמט תגובה. שגיאות כמו 401 מציינות מפתח לא חוקי, בעוד ש-402 פירושו שהאשראי המזומן שלך אזל.

Copycurl https://api.qwenaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this pull request diff"}]
  }'

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

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

Copyfrom openai import OpenAI

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

שימוש ב-Node SDK

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

Copyimport OpenAI from "openai";

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

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

אפשרו זרמת נתונים על ידי הגדרת ה 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)

חלון ההקשר & מגבלות

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