תיעוד ממשק API תואם ל-OpenAI

הגדרת כתובת הבסיס ואימות

מפתח ה-API שלך מאמת כל בקשה לשרתים שלנו. פשוט הירשם עם Google או כתובת אימייל והעתק את המפתח מלוח הבקרה שלך. הדבק אותו במשתנה הסביבה שלך כ- DEEPSEEK_API_KEY והפנה את הלקוח שלך ל https://api.keyapideepseek.com/v1. כתובת הבסיס הזו עובדת עם כל ספריה תואמת סטנדרטית ל-OpenAI.

Copycurl https://api.keyapideepseek.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check the system health and confirm uptime status"}]
  }'

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

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

ה POST /v1/chat/completions נקודת הקצה מקבלת את הפקודה שלך ומחזירה את תגובת המודל. אתה שולח גוף JSON המכיל הודעות, הוראות המערכת שלך ופרמטרים כמו טמפרטורה. מזהה המודל הוא תמיד uncensored. מודל יחיד זה מטפל בכל צרכי יצירת הטקסט שלך ללא מורכבות ניהול.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.keyapideepseek.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 SDK מטפלת בבקשות ה-HTTP באופן אוטומטי. אתה מעביר את המפתח שלך ואת כתובת ה-URL הבסיסית לבנאי הלקוח. שאר הקוד משקף את הדפוסים הסטנדרטיים של OpenAI. זה מבטיח שניתן יהיה להחליף ספקים מאוחר יותר ללא צורך לכתוב מחדש את לוגיקת האפליקציה כולה.

תגובות בסטרימינג וצריכת טוקנים

אפשרו זרימה על ידי הגדרת stream: true בבקשה שלך. ה-API מחזיר זרם אירועים שנשלחו על ידי השרת (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)

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

מצב JSON וקריאת פונקציות

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

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

מגבלות קצב ונלוות

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

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

טיפול בשגיאות וסירובים

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

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

Node.js

Copyimport OpenAI from "openai";

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