मिनीसीपीएम उपयोगकर्ताओं के लिए क्विकस्टार्ट

बेस URL और प्रमाणीकरण

इस API का उपयोग करने के लिए, आपको एक API कुंजी और सही बेस URL की आवश्यकता है। हमारा सेवा मानक ओपनएआई क्लाइंट लाइब्रेरी के साथ पूरी तरह संगत है। आपको नई डिपेंडेंसीज इंस्टॉल करने या नए SDK को सीखने की आवश्यकता नहीं है। बस अपने मौजूदा क्लाइंट को हमारे एंडपॉइंट की ओर इशारा करें।

API कुंजी प्राप्त करें पृष्ठ पर एक कुंजी जनरेट करें। आप Google से साइन इन कर सकते हैं या ईमेल और पासवर्ड का उपयोग कर सकते हैं। कुंजी तुरंत प्रदर्शित होती है। इसे सुरक्षित रूप से संग्रहीत करें। प्रत्येक अनुरोध में Authorization हेडर में यह कुंजी शामिल होनी चाहिए।

सभी अनुरोधों के लिए बेस URL है: https://api.minicpm.cc/v1। यह URL चैट पूर्णता, मॉडल सूची और स्ट्रीमिंग प्रतिक्रियाओं को संभालता है। एम्बेडिंग या विज़न के लिए कोई अलग एंडपॉइंट नहीं है। यह केवल पाठ वाला API है।

पहला अनुरोध

एक मानक चैट पूरा करने का अनुरोध भेजें ताकि पाठ उत्पन्न शुरू हो सके। मॉडल आईडी हमेशा uncensored होती है। यह मॉडल एक ओपन-वेट बड़ा भाषा मॉडल है जिसे कानूनी वयस्क उपयोग के लिए बिना सेंसर उत्तर देने के लिए ट्यून किया गया है। यह GPT, Claude या किसी अन्य विक्रेता का मॉडल नहीं है।

model फ़ील्ड को uncensored पर सेट करें। अपने संदेशों को मानक सरणी प्रारूप में प्रदान करें। API एक टेक्स्ट प्रतिक्रिया देता है। आप max_tokens के साथ आउटपुट लंबता को नियंत्रित कर सकते हैं। यदि आप इसे सेट नहीं करते हैं, तो डिफ़ॉल्ट अधिकतम आउटपुट 2,048 टोकन होता है।

पायथन SDK इंटीग्रेशन

API के साथ इंटरैक्ट करने के लिए आधिकारिक ओपनएआई पायथन लाइब्रेरी का उपयोग करें। आपको केवल बेस URL और API कुंजी कॉन्फ़िगर करने की आवश्यकता है। लाइब्रेरी का बाकी हिस्सा अपेक्षित तरीके से काम करता है। इसमें स्ट्रीमिंग, फ़ंक्शन कॉलिंग और JSON मोड का समर्थन शामिल है।

pip install openai के साथ लाइब्रेरी इंस्टॉल करें। अपने बेस URL और कुंजी के साथ क्लाइंट इनिशियलाइज़ करें। चैट पूर्णता एंडपॉइंट पर संदेश भेजें। प्रतिक्रिया ऑब्जेक्ट में जनरेटेड टेक्स्ट, टोकन उपयोग और फिनिश रीजन होता है। आप इन फ़ील्ड्स को अपने पायथन कोड में सीधे एक्सेस कर सकते हैं।

नोड SDK इंटीग्रेशन

नोड.js SDK पायथन वर्जन की तरह ही काम करता है। पैकेज इंस्टॉल करें और बेस URL कॉन्फ़िगर करें। क्लाइंट ऑथेंटिकेशन और रिक्वेस्ट फॉर्मेटिंग को स्वचालित रूप से हैंडल करता है। इससे आप API को अपने बैकएंड सर्विसेज में तेज़ी से इंटीग्रेट कर सकते हैं।

बेस URL और API कुंजी को ओपनएआई क्लाइंट कन्स्ट्रक्टर में पास करें। chat.completions.create विधि का उपयोग करें। प्रतिक्रिया संरचना ओपनएआई मानक से मेल खाती है। आप त्रुटियों को संभाल सकते हैं, टोकन उपयोग की जांच कर सकते हैं और सामग्री को प्रोसेस कर सकते हैं। यह दृष्टिकोण मौजूदा कोडबेस के साथ संगतता सुनिश्चित करता है जो पहले से ओपनएआई का उपयोग कर रहे हैं।

स्ट्रीमिंग रिस्पॉन्स

अपने अनुरोध में stream: true सेट करके स्ट्रीमिंग सक्षम करें। API सर्वर-सेंट इवेंट्स (SSE) का एक क्रम लौटाता है। प्रत्येक इवेंट में प्रतिक्रिया का एक चंक होता है। यह आपको टेक्स्ट को जनरेट होते ही उपयोगकर्ता को प्रदर्शित करने की अनुमति देता है।

अंतिम चंक में टोकन उपयोग के सांख्यिकी शामिल हैं। यह लागत ट्रैक करने के लिए उपयोगी है। स्ट्रीमिंग से उपयोगकर्ताओं के लिए प्रतीत होने वाली विलंबता कम हो जाती है। चैट इंटरफ़ेस के लिए इसे अनुशंसित किया जाता है। आप अंतिम प्रतिक्रिया बनाने या टोकन को रियल-टाइम में प्रदर्शित करने के लिए अपने क्लाइंट कोड में इवेंट्स को पार्स कर सकते हैं।

लिमिट्स, एरर्स और कॉन्टेक्स्ट

मॉडल 100,000 टोकन की कॉन्टेक्स्ट विंडो का समर्थन करता है। इसमें प्रॉम्प्ट और कंप्लीशन दोनों शामिल हैं। प्रति अनुरोध अधिकतम आउटपुट 32,000 टोकन है। आप max_tokens पैरामीटर को सेट करके इसे नियंत्रित कर सकते हैं।

रेट लिमिट प्रति कुंजी प्रति मिनट 300 अनुरोध पर सेट किए गए हैं। आपके पास 8 समानांतर अनुरोध हो सकते हैं। अनुरोध बॉडी 8 MB से कम होनी चाहिए। यदि कुंजी अमान्य है, तो आपको 401 त्रुटि मिलेगी। यदि आपके पास क्रेडिट नहीं है, तो आपको 402 त्रुटि मिलेगी। यदि आप रेट लिमिट से अधिक हो जाते हैं, तो आपको 429 त्रुटि मिलेगी। त्रुटियां और अस्वीकृतियां क्रेडिट खर्च नहीं करतीं।

cURL

Copycurl https://api.minicpm.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

पायथन

Copyfrom openai import OpenAI

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

नोड.js

Copyimport OpenAI from "openai";

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

2026-050