תיעוד API למפתחים

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

התחל על ידי שינוי כתובת ה-URL הבסיסית לנקודת הקצה הייעודית שלנו והעברת מפתח ה-API בכותרת Authorization. אנחנו לא משתמשים בכתובת ה-URL הבסיסית הסטנדרטית של OpenAI; עליך להפנות את ה-SDK שלך ל- https://api.deepseektokenplan.com/v1. זה מבטיח שהבקשות שלך יועברו דרך תשתית המודל ללא צנזורה שלנו במקום פרוקסי צד שלישי. מזהה המודל שאתה מציין בגוף הבקשה הוא "uncensored", מה שמפעיל משקלים מותאמים ספציפיים בשרתים שלנו. האימות מסתמך על סכמת אסימון Bearer פשוטה שפועלת עם כל ספריית לקוח תואמת OpenAI. המפתח שלך נוצר מיד עם ההרשמה באמצעות Google או דוא"ל, ללא צורך במספר טלפון. שמור על המפתח הזה מאובטח, שכן הוא מקושר ישירות למאזן האשראי שלך בתשלום מראש.

בקשה ראשונה

Send a standard chat completions request using cURL to verify your setup and model availability. This simple POST request demonstrates how the API accepts your system prompt and user message. You can adjust the temperature and top_p parameters to control creativity. The response returns the generated text along with token usage statistics for billing transparency. Ensure your request body includes the correct model identifier and your API key in the header. This method works for both text generation and function calling scenarios. Use this command to confirm connectivity before integrating into your application. The endpoint supports streaming and non-streaming modes equally well.

אינטגרציית SDK Python

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

שילוב Node SDK

שלב את ה-API באפליקציות JavaScript או TypeScript שלך באמצעות חבילת ה-Node של OpenAI. הגדר את כתובת ה-URL הבסיסית ומפת ה-API בתצורת הלקוח לפני ביצוע כל בקשה. הגדרה זו מאפשרת לך להשתמש בשיטות מוכרות כמו chat.completions.create() עם המודל ללא צנזרה שלנו. ניתן להעביר פרמטרים כמו טמפרטורה ורצפי עצירה כדי לכוונן את הפלט. ה-SDK מטפל בתגובות זרימה ביעילות לאפליקציות בזמן אמת. השתמש בגישה זו לשרתי ווב או כלי שורת פקודה. ודא שאתה מייבא את המודולים הנדרשים ומגדיר משתני סביבה נכון. שיטה זו תומכת גם בדפוסים סינכרוניים ולא סינכרוניים של בקשות.

שידור חי ואסימונים

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

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

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

cURL

Copycurl https://api.deepseektokenplan.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 50 million tokens"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

זרימה

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)