प्रमाणीकरण और बेस URL सेटअप
आपका API key हमारे सर्वरों द्वारा हर अनुरोध को प्रमाणीकृत करता है। बस Google या एक ईमेल पते से साइन अप करें और अपनी डैशबोर्ड से कुंजी कॉपी करें। इसे अपने एन्वायरनमेंट वेरिएबल में पेस्ट करें DEEPSEEK_API_KEY औह अपने क्लाइंट को https://api.keyapideepseek.com/v1. यह बेस URL किसी भी मानक OpenAI-संगत लाइब्रेरी के साथ काम करता है।
curl 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"}]
}'आप उपलब्ध मॉडल्स की सूची बनाकर अपनी सेटअप की जांच कर सकते हैं। प्रतिक्रिया पुष्टि करती है कि आपकी कुंजी मान्य और सक्रिय है। यह कदम सुनिश्चित करता है कि आपका एकीकरण सही अनफ़िल्टर्ड एंडपॉइंट की ओर इशारा करता है, इससे पहले कि आप प्रॉम्प्ट भेजें।
चैट कंप्लीशंस एंडपॉइंट
The POST /v1/chat/completions एंडपॉइंट आपका प्रॉम्पट स्वीकार करता है और मॉडल प्रतिक्रिया लौटाता है। आप एक JSON बॉडी भेजते हैं जिसमें संदेश, आपकी सिस्टम निर्देश, और तापमान जैसे पैरामीटर शामिल होते हैं। मॉडल आईडी हमेशा होती है uncensored. यह एकल मॉडल सभी आपके टेक्स्ट जनरेशन की आवश्यकताओं को रूटिंग जटिलता के बिना संभालता है।
from 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 खंडों की एक Server-Sent Events (SSE) स्ट्रीम लौटाता है। प्रत्येक खंड आंशिक टेक्स्ट और उपयोग सांख्यिकी शामिल करता है। अंतिम खंड में अनुरोध के लिए कुल टोकन गणना शामिल होती है।
stream = 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 त्रुटि लौटाई जाती है।
अपने क्लाइंट कोड में एक्सपोनेंशियल बैकऑफ लागू करें। विफल अनुरोधों को छोटी देरी के बाद रीट्राई करें। यह ट्रांजिएंट नेटवर्क समस्याओं को सहजता से हैंडल करता है। आपका प्रीपेड क्रेडिट केवल सफल पूर्णताओं के लिए चार्ज होता है, रेट-लिमिटेड रीट्राई के लिए नहीं।
त्रुटि हैंडलिंग और अस्वीकृति
401 त्रुटि का अर्थ है कि आपकी कुंजी अमान्य या समाप्त हो चुकी है। 402 त्रुटि अपर्याप्त पूर्वभुगतान क्रेडिट को दर्शाती है। 429 त्रुटि संकेत देती है कि आपने दर सीमा को पार कर लिया है। मॉडल उन अनुरोधों को अस्वीकार करता है जिनमें किशोरों के साथ यौन सामग्री शामिल होती है। अन्य सभी कानूनी वयस्क सामग्री की अनुमति है।
विवरित संदेशों के लिए त्रुटि प्रतिक्रिया बॉडी की जाँच करें। एकीकरण समस्याओं को डिबग करने के लिए इन त्रुटियों को लॉग करें। आपके क्रेडिट विफल अनुरोधों के लिए खपत नहीं होते हैं। यह पारदर्शी बिलिंग मॉडल आपको छिपे शुल्कों के बिना लागत की सटीक भविष्यवाणी करने में मदद करता है।
Node.js
import 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);