כתובת URL בסיסית ואימות
התחילו כל בקשה על ידי הפניית הלקוח שלכם לכתובת הבסיס הנכונה. השתמשו במפתח שהתקבל במהלך ההרשמה כדי להעביר ב Authorization header. כותרת זו מאמתת את החשבון שלך ועוקבת אחר צריכת הקרדיט המשולם מראש שלך.
התשתית שלנו בנויה למפתחים שרוצים גישה ישירה ללא עמלות נתיב מתווכים. אתם מקבלים ביצועים עקביים כי אנחנו מריצים את השרתים שלנו.
בקשה ראשונה
שלחו את ההודעה הראשונה כדי לאמת חיבוריות ותגובת מודל. השתמשו בנקודת הקצה הסטנדרטית של השלמות צ'אט עם ה-system prompt וה-query של המשתמש שלכם. זה מאשר שהמפתח שלכם עובד ומציג את תגובת ה-JSON הגולמית.
- הגדר את
modelfield touncensored. - כלול הודעת משתמש פשוטה כדי לבדוק זמן ריאקטיביות.
- בדקו את
usageאובייקט למספרי אסימונים.
SDK Python
שלב במהירות באמצעות הספרייה הרשמית של Python. התקן את החבילה ואתחל את הלקוח עם כתובת הבסיס והמפתח שלך. גישה זו מטפלת ביישור וניסיונות חוזרים באופן אוטומטי.
הגדירו את היסטוריית השיחה שלכם כרשימה של מילונים. העבירו אותם ישירות לנקודת הקצה של הצ'אט. הספרייה מחזירה אובייקט תגובה מבני שניתן לנתח עבור הטקסט של המסייע.
Node SDK
צרו לוגיקת צד שרת עם לקוח Node.js. ייבאו את הספרייה וקבעו את מפתח ה-API וכתובת ה-URL הבסיסית. הגדרה זו מתאימה היטב לשירותי backend שעובדים על קלט משתמשים באופן אסינכרוני.
התקשר לשיטת ההשלמה עם ההודעות שלך. התגובה כוללת את הטקסט שנוצר וסטטיסטיקות שימוש. טפל בשגיאות בצורה עדינה כדי למנוע קריסת היישום שלך בעומס גבוה.
תגובות בסטרימינג
קבלו אסימונים בזמן אמת לחווית משתמש חלקה יותר. הפעילו זרימה על ידי הגדרת הדגל המתאים בבקשה שלך. השרת שולח נתחי נתונים כפי שהם נוצרים.
צבור נתחים אלו בצד הלקוח כדי להציג טקסט בהדרגה. זה מפחית משמעותית את זמן התגושענות התפוס. פקח על הנתח הסופי עבור סך השימוש בטוקנים ונתוני חשבונאות.
מגבלות, שגיאות והקשר
כבדו את מגבלות הקצב כדי להימנע מהפרעות בשירות. מותר לכם 300 בקשות לדקה ו-8 חיבורים מקבילים לכל מפתח. אם תחריגו זאת, תקבלו שגיאת 429.
שגיאת 401 משמעה שמפתח ה-API שלך לא חוקי. שגיאת 402 מציינת חסר באשראי שולם מראש. חלון ההקשר שלך הוא 100,000 טוקנים בסך הכל. שמור על הפקודה והתגובה בתוך מגבלה זו כדי להבטיח ביצועים אמינים.
cURL
curl https://api.deepseekapiaccess.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Calculate the total latency for three sequential API calls."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.deepseekapiaccess.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.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.deepseekapiaccess.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 = 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)