מדריך API Quickstart

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

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

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

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

שלחו את הבקשה הראשונה אל /v1/chat/completions נקודת קצה (endpoint) באמצעות מזהה המודל uncensored. נקודת הקבלה הזו מטפלת באינטראקציות טקסט נכנס/יוצא ללא מדיניות תוכן מובנית. ניתן לשלוט בסגנון התגובה באמצעות פרמטרים כמו temperature וגם top_p. המודל תומך בחלון הקשר של 100,000 טוקנים, המאפשר היסטוריית שיחה נרחבת או עיבוד מסמכים בקריאה אחת. הפלט המקסימלי מוגבל ל-16,000 טוקנים לבקשה, או 2,048 אם תשמיט את המגבלה.

• שימוש response_format עם json_object לפלט נתונים מבניים.
• הגדר stream: true למסירת טוקנים בזמן אמת.
• עבור stop רצפים לעצירת ייצור בסימנים ספציפיים.

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

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

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

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

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

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

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

מגבלות ונהלים מומלצים

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

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

דוגמאות ללקוח

להלן קטעי קוד לשפות נפוצות. השתמשו ב-SDKs הרשמיים של OpenAI או בכל לקט תואם. החליפו YOUR_API_KEY עם המפתח שנוצר שלך. כתובת ה-URL הבסיסית היא https://api.deepseekapidiscount.com/v1. דוגמאות אלו מדגימות יצירת טקסט בסיסית וזרם. תוכל להתאים אותן למקרה השימוש הספציפי שלך, בין אם זה צ'אט, סיכום או חילוץ נתונים.

cURL

Copycurl https://api.deepseekapidiscount.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check server status for uptime reliability and latency metrics"}]
  }'

Python

Copyfrom openai import OpenAI

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