איך ל-Integrate the DeepSeek API

דרישות מוקדמות: הגדרת סביבה

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

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

התקנת ה-SDK הרשמי

התקן את ה-SDK הרשמי לשפת התכנות המועדפת עליך כדי לטפל באימות וברצף בקשות. עבור Python, השתמש ב pip install openai. עבור Node.js, הרץ npm install openai. ספרייה זו מנהלת את חיבורי ה-HTTP הבסיסיים.

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

Copyfrom openai import OpenAI

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

הגדרת כתובת URL בסיסית ומפתח

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

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

ביצוע הבקשה הראשונה

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

גוף הבקשה כולל את messages מערך ו- model מזהה. התגובה מכילה את הטקסט שנוצר ב- content שדה. זה מאשר ששילוב ה-API שלכם עובד כראוי עם המודל ללא צנזורה.

Copycurl https://api.deepseekpago.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of top five open source llms"}]
  }'

הפעלת תגובות בזרם

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

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

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)

שימוש בכלים וב-FUNCTION CALLING

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

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

Copyimport OpenAI from "openai";

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

כפה על המודל להחזיר JSON תקין על ידי הגדרת response_format אל {"type": "json_object"}. זה שימושי לפיענוח נתונים לתוך האפליקציה שלך. זה מקטין את הצורך בביטויים רגולריים (regex) לעיבוד לאחר קבלת התשובה.

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

טיפול בשגיאות ומגבלות קצב

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

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

ניטור שימוש בטוקנים

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

המחירים הם $0.15 ל-1M טוקני קלט ו-$0.50 ל-1M טוקני פלט. שגיאות ללא תשלום. ניתן לחשב עלויות מקומית על ידי הכפלת כמות הטוקנים בקצבים אלו. זה עוזר לתקצב את הטעינות בקריפטו שלך במדויק.