כתובת URL בסיסית ואימות
השתמשו בכתובת ה-URL הבסיסית שסופקה ובמפת API תקף כדי לחבר את הלקוח שלכם. נקודת הקצה היא https://api.qwencodeapikey.com/v1. עליך לכלול את המפתח שלך ב- Authorization header של כל בקשה. זה מבטיח שהשירות מזהה נכון את חשבון האשראי ששולם מראש שלכם.
curl https://api.qwencodeapikey.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Check my api key validity status"}]
}'
ניתן ליצור מפתח דרך Google או אימייל בדף ההרשמה. המפתח מופיע מיד. שמור אותו מאובטח, שכן הוא שולט בהוצאות שלך.
נקודת קצה להשלמות צ'אט
שלם הודעות ל /v1/chat/completions נקודת קצה (endpoint) לקבלת תגובות טקסט. זהו הממשק הסטנדרטי לרוב SDKs של OpenAI. אתה מגדיר את ה- model כ uncensored והספק רשימה של הודעות ב messages מערך. ה-API מעבד את הקלט שלך ומחזיר השלמה שנוצרה.
from openai import OpenAI
client = OpenAI(base_url="https://api.qwencodeapikey.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)
ודאו שספריית הלקוח שלכם מצביעה על הכתובת הבסיסית הנכונה. מזהה המודל uncensored מפעיל את מודל המשקל הפתוח המותאם למספר פחות של סירובים. הוא מטפל בסיבובי שיחה בדיוק כמו כל ממשק API אחר של צ׳אט.
נקודת קצה למודלים
שאילתה (Query) GET /v1/models לבדיקת מודלים זמינים ופרטיהם. נקודה סופית זו מחזירה רשימה של מודלים הנגישים למפתח שלך. זה עוזר לך לאשר את uncensored מודל פעיל ומוכן לבקשות. השתמש בזה לניפוי באגים של תצורות לקוח לפני שליחת מטענים מלאים.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.qwencodeapikey.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);
בדוק את מבנה התגובה כדי לוודא שה-SDK שלך מנתח נכון את רשימת המודלים. נקודת קצה זו לא צורכת אשראי, מה שהופך אותה לבטוחה לבדיקות אתחול.
פרמטרי בקשה וזרימה
תומך בפרמטרים סטנדרטיים כמו temperature, top_p, stop, וכן seed. הפעל סטרימינג על ידי הגדרת stream: true. ה-API שולף אסימונים באמצעות אירועים מוכוונים-שרת (SSE). סטטיסטיקות שימוש באסימונים מופיעות במקטע הסופי של הזרם. זה מאפשר הצגה בזמן אמת של הטקסט שנוצר.
stream = 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)
הגדר max_tokens לשליטה באורך הפלט. ברירת המחדל היא 2,048 טוקנים. ניתן להגדיל זאת עד 16,000 טוקנים לכל בקשה. התאם פרמטרים כדי לאזן יצירתיות ודיוק בתגובות שלך.
מגבלות קצב ואילוצים
כל מפתח מאפשר 300 בקשות לדקה ו-8 בקשות מקבילות. גודל הגוף המקסימלי של הבקשה הוא 8 MB. מגבלות אלו מונעות שימוש לרעה ומבטיחות ביצועים יציבים. אם תחרגו מהקצב, תקבלו שגיאת 429. התאימו את לוגיקת הלקילנט שלכם לטיפול בניסיונות חוזרים עם backoff מעריכי.
חלון ההקשר תומך ב-100,000 טוקנים בסך הכל. זה כולל את הפלט והשלמת. הקשרים גדולים דורשים ניהול טוקנים קפדני כדי להישאר בתוך המגבלות.
מצב JSON וקריאת פונקציות
שימוש response_format: {"type": "json_object"} לפלט מבני. זה מבטיח שהמודל יחזיר JSON תקף, שימושי לשילוב תוכנית. קריאה לפונקציות עובדת דרך ה tools פרמטר. הגדירו כלים בפורמט הסטנדרטי של OpenAI. המודל יקרא לפונקציות לפי הצורך.
שגיאות וסירובים לא צורכים נקודות זכות. זה חל גם אם המודל מסרב לבקשה עקב מגבלת התוכן הקשה. אתה משלם רק עבור שימוש אמיתי בטוקנים. נקודות הזכות לא פגות תוקף, כך שתוכל להעמיס כאשר זה נוח לך.
טיפול בשגיאות ושימוש
טפול בשגיאות HTTP בצורה חכמה. שגיאת 401 מציין מפתח API לא חוקי או פג תוקף. שגיאת 402 משמעותה שאשראיך המקומד אזל. שגיאת 429 מסמנת חריגת מגבלת קצב. בדוק את גוף התגובה להודעות שגיאה מפורטות.
השימוש נמדד לפי מפתח. מפתח פעיל אחד לחשבון מפשט את החיוב. אם ביטית טעות, כמו חיוב כפול, השתמש בדף התמיכה. הקרדיט לא מוחזר אך נשאר תקף. שגיאות הן ללא תשלום, כך שבקשות כושלות לא מנזלות את היתרה שלך.
סיכום ונהלים מומלצים
התחל עם כתובת ה-URL הבסיסית ומפתח תקף. השתמש ב uncensored מזהה המודל לטעויות פחותות. סיים תגובות לחוויית משתמש טובה יותר. פקח על מגבלות קצב כדי להימנע מהפרעות. השתמש במצב JSON לנתונים מבניים. טפל בשגיאות כדי לשמור על אמינות. הקרדיט הוא מראש ולא פג תוקף. מלא קרדיט עם קריפטו כשצריך. API זה מתאים בצורה חלקה לקודבסיס קיים של OpenAI. לא נדרשים SDKs חדשים. רק שנה את כתובת הבסיס ואת המפתח.
