מדריך אינטגרציה: מפתח API של deepseek coder

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

מפתח ה-API שלך מאמת כל בקשה. הגדר את כתובת הבסיס ל- https://api.deepseekcoderapikey.com/v1 בתצורת הלקוח שלך. כתובת זו מטפלת גם בנקודות הקצה של השלמת צ'אט ודגמים ללא צורך בפרמטרי נתיב נוספים. אתה מקבל מפתח אחד לכל חשבון, ויצירת מפתח חדש מחליפה את המפתח הקודם מיד.

אחסן את המפתח במשתנה סביבה בשם DEEPSEEK_API_KEY או להעביר אותו ישירות ללקוח ה-SDK שלך. נקודת הקצה מקבלת כותרות סטנדרטיות, כך שתוכל להחליף ספקים על ידי שינוי רק כתובת הבסיס וערך המפתח. גישה זו עובדת עם Cursor, תוספי VS Code וכלי פיתוח מקומיים המצפים לממשל תואם OpenAI.

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

Copycurl https://api.deepseekcoderapikey.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Convert this SQL query to python pandas syntax"}]
  }'

דוגמה כדי לאמת חיבוריות לפני שילוב לוגיקת היישום שלך.

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

שלם הודעות ל POST /v1/chat/completions נקודת קצה (endpoint) באמצעות מזהה המודל uncensored. נקודת הקבלה הזו מעבדת קלט טקסט ומחזירה פלט טקסט, תומכת הן בתגובות סינכרוניות והן בסטרימינג. ניתן להגדיר את התנהגות המודל באמצעות פרמטרים כמו טמפרטורה, top_p ורצפי עצירה.

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.deepseekcoderapikey.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 הרשמי של OpenAI ב-Python.

שגיאות כמו אשראי לא מספיק מחזירות קוד סטטוס 402, בעוד שבקשות לא תקינות מחזירות 400. בדוק את גוף התגובה להודעות שגיאה מפורטות כדי לנטרל את מבנה הפולייד שלך במהירות.

נקודת קצה של מודלים (GET)

בצע שאילתה על המודלים הזמינים על ידי שליחת GET /v1/models בקשה. נקודת קצה זו מחזירה רשימה של אובייקטי מודל, כולל ה uncensored מזהה המודל. ניתן להשתמש בנקודת הקצה הזו כדי לוודא שמפתח ה-API שלך תקף וששירות מחובר לפני ביצוע בקשות שימוש כבדות.

התגובה כוללת מטא-דטה כגון מזהה המודל, סוג האובייקט ומידע על הבעלות. השתמש בנתונים אלה כדי להגדיר את היישום שלך דינמית או כדי לרשום מודלים זמינים למטרות איתור באגים. נקודת הקצה אינה דורשת גוף (body), רק כותרת האימות הסטנדרטית.

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

תגובות בסטרימינג (SSE)

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

כל מקטע מכיל תוכן חלקי, והמקטע הסופי כולל את סטטיסטיקות ספירת הטוקנים הכוללת. פתחו את זרם ה-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)

דוגמה מדגימה כיצד לטפל בזרם ב-JavaScript.

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

פקודות פונקציה ומצב JSON

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

לפלטות מבניות, הפעל מצב JSON על ידי הגדרת response_format אל json_object. זה מכריח את המודל להחזיר JSON תקף, שזה שימושי לפיענוח נתוני תצורה או תגובות API. ה

Copyimport OpenAI from "openai";

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

הקטע מראה כיצד להגדיר מצב JSON ב-Node.js.

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

מגבלות קצב ואילוצים

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

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

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