מדריך אינטגרציה למפתחים

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

התחל על ידי הפניית הלקוח שלך לכתובת הבסיס שלנו וספק את מפתח ה-API שלך בראש ההרשאה. זה עובד עם כל SDK תואם OpenAI מכיוון שאנו עוקבים אחר הפרוטוקול הסטנדרטי בדיוק. צור את המפתח שלך באופן מיידי באמצעות Google או דוא"ל בדף Get API key; אין צורך במספר טלפון. שמור על המפתח שלך מאובטח והשתמש במפתח פעיל אחד לכל חשבון, שכן יצירת מפתח חדש מחליפה את הישן.

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

בקשה ראשונה

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

Copycurl https://api.deepseekapicost.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "calculate total monthly cost for 1 million tokens"}]
  }'

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

SDK Python

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

Copyfrom openai import OpenAI

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

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

Node SDK

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

Copyimport OpenAI from "openai";

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

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

זרימה

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

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)

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

מגבלות, שגיאות וחלון ההקשר

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

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