MiniMax API: पांच मिनट में पहला अनुरोध
अपना पहला अनसेंस्ड टेक्स्ट जनरेशन मिनटों में चालू करें। यह गाइड बेस URL, ऑथेंटिकेशन और हमारे OpenAI-अनुकूल API के लिए SDK सेटअप कवर करती है।
https://api.minimaxapikey.com/v1uncensored
OpenAI SDK इंस्टॉल करें
अपनी पसंदीदा भाषा के लिए आधिकारिक OpenAI SDK इंस्टॉल करने से शुरू करें। लाइब्रेरी अनुरोध फॉर्मेटिंग और स्ट्रीमिंग को स्वचालित रूप से संभालती है। सुनिश्चित करें कि आपके पास Python 3.8+ या Node.js 18+ इंस्टॉल है। Python के लिए pip install openai या Node के लिए npm install openai चलाएँ। SDK /v1/chat/completions एंडपॉइंट के साथ इंटरैक्शन को सरल बनाता है। यह हेडर्स, रेट्राइज़ और SSE पार्सिंग को प्रबंधित करता है ताकि आप प्रॉम्प्ट पर ध्यान केंद्रित कर सकें। यह इसलिए काम करता है क्योंकि हमारा API OpenAI चैट कंप्लीशन मानक का पालन करता है। आपको एक कस्टम क्लाइंट लाइब्रेरी की आवश्यकता नहीं है। स्टैंडर्ड SDK विधियाँ सीधे हमारे एंडपॉइंट्स से मैप होती हैं। इससे इंटीग्रेशन समय कम होता है और मौजूदा डेवलपर ज्ञान का लाभ मिलता है।
अपना बेस URL और कुंजी कॉन्फ़िगर करें
अपनी API कुंजी और बेस URL को अपने एन्वायरनमेंट वेरिएबल्स में सेट करें। हमारा बेस URL https://api.minimaxapikey.com/v1 है। यह आपको बिना किसी संशोधन के स्टैंडर्ड OpenAI क्लाइंट्स का उपयोग करने की अनुमति देता है। अपनी कुंजी जनरेट करने के लिए एक खाता बनाएँ। कुंजी साइनअप के तुरंत बाद दिखाई जाती है। ट्रायल के लिए कार्ड की आवश्यकता नहीं है। कुंजी को सुरक्षित रूप से स्टोर करें। इसे हेडर या एन्वायरनमेंट वेरिएबल के रूप में पास करें। SDK डिफ़ॉल्ट रूप से OPENAI_API_KEY का उपयोग करता है। आप बेस URL को ओवरराइड कर सकते हैं ताकि यह हमारे सर्वर की ओर इशारा करे। यह सुनिश्चित करता है कि सभी अनुरोध अनसेंस्ड मॉडल पर जाएं। एक सरल पिंग के साथ अपनी कुंजी काम कर रही है, इसकी जाँच करें। यह कदम बाद में ऑथेंटिकेशन त्रुटियों को रोकता है।
बेसिक चैट कंप्लीशन भेजें
टेक्स्ट जनरेट करने के लिए अपना पहला अनुरोध बनाएँ। POST विधि का उपयोग /v1/chat/completions पर करें। मॉडल को uncensored के रूप में निर्दिष्ट करें। एक यूजर प्रॉम्प्ट के साथ एक संदेश सरणी पास करें। API एक कंप्लीशन टोकन लौटाता है। यह कोर टेक्स्ट जनरेशन फीचर है। यह 100k कॉन्टेक्स्ट विंडो का समर्थन करता है। आप लंबे प्रॉम्प्ट या कॉन्वर्सेशन हिस्ट्री भेज सकते हैं। प्रतिक्रिया में जनरेटेड टेक्स्ट और टोकन उपयोग शामिल है। यह क्रिएटिव राइटिंग या अनरिस्ट्रिक्टेड डायलॉग के लिए आदर्श है। सुनिश्चित करें कि सामग्री कानूनी है। मॉडल वयस्क विषयों को अस्वीकार नहीं करता है। यह केवल किशोरों से संबंधित यौन सामग्री को ब्लॉक करता है। कनेक्टिविटी की जाँच करने के लिए सरल शुरू करें।
स्ट्रीमिंग (SSE) सक्षम करें
रीयल-टाइम आउटपुट के लिए, स्ट्रीमिंग सक्षम करें। stream पैरामीटर को true सेट करें। API सर्वर-सेंट इवेंट्स (SSE) लौटाता है। प्रत्येक चंक प्रतिक्रिया का एक हिस्सा होता है। इससे अनुभवजन्य लेटेंसी कम होती है। यूजर देखते हैं कि टेक्स्ट जनरेट होते हुए दिखाई देता है। SDK चंक पार्सिंग को स्वचालित रूप से संभालता है। आप UI में टेक्स्ट को क्रमबद्ध रूप से प्रदर्शित कर सकते हैं। यह चैट इंटरफेस के लिए महत्वपूर्ण है। स्ट्रीमिंग सभी मॉडल प्रतिक्रियाओं के साथ काम करती है। यह टोकन गिनती को प्रभावित नहीं करती है। प्रत्येक चंक के अंत में उपयोग डेटा शामिल होता है। बेहतर यूजर अनुभव के लिए इसका उपयोग करें। यह पूर्ण प्रतिक्रिया का इंतज़ार करने की तुलना में अधिक रिस्पॉन्सिव लगता है। अपने क्लाइंट को चंक को सही तरीके से बफर करने के लिए कॉन्फ़िगर करें।
टूल/फ़ंक्शन कॉलिंग का उपयोग करें
फ़ंक्शन कॉलिंग के साथ संरचित आउटपुट का समर्थन करें। अनुरोध बॉडी में टूल परिभाषित करें। मॉडल प्रॉम्प्ट के आधार पर फ़ंक्शन कॉल कर सकता है। यह बाहरी सिस्टम के साथ इंटीग्रेशन को सक्षम बनाता है। टूल परिभाषाओं और यूजर संदेश पास करें। प्रतिक्रिया में एक टूल कॉल ऑब्जेक्ट शामिल होता है। फ़ंक्शन निष्पादित करें और परिणाम वापस फ़ीड करें। यह मानक OpenAI SDKs के साथ काम करता है। यह जटिल वर्कफ़्लो की अनुमति देता है। आप एजेंट या असिस्टेंट बना सकते हैं। मॉडल कॉल के बीच संदर्भ बनाए रखता है। यह ऑटोमेशन के लिए शक्तिशाली है। सुनिश्चित करें कि आपकी टूल परिभाषाएं सटीक हैं। API टूल आउटपुट के रूटिंग को संभालता है। यह कन्वर्सेशन को सहसंबद्ध रखता है। डायनामिक कंटेंट जनरेशन के लिए इसका उपयोग करें।
उपलब्ध मॉडल जांचें
GET /v1/models के माध्यम से मॉडल सूची की जाँच करें। यह एंडपॉइंट उपलब्ध मॉडल लौटाता है। हमारा API एक मॉडल सर्व करता है: uncensored। यह एक ओपन-वेट मॉडल है। यह GPT, Claude या Gemini नहीं है। प्रतिक्रिया मॉडल ID की पुष्टि करती है। क्लाइंट कॉन्फ़िगरेशन को डिबग करने के लिए इसका उपयोग करें। सुनिश्चित करें कि आपका कोड सही मॉडल को टारगेट कर रहा है। एंडपॉइंट तेज़ और विश्वसनीय है। यह JSON डेटा लौटाता है। आप इसे UI प्रदर्शन के लिए पार्स कर सकते हैं। यह पुष्टि करता है कि आपकी API कुंजी मान्य है। स्वचालित हेल्थ चेक के लिए इसका उपयोग करें। यह स्टैंडर्ड OpenAI स्पे का हिस्सा है। अतिरिक्त कॉन्फ़िगरेशन की आवश्यकता नहीं है। यह मौजूदा टूल्स के साथ संगतता सुनिश्चित करता है।
cURL
curl https://api.minimaxapikey.com/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."}]
}'Python
from openai import OpenAI
client = OpenAI(base_url="https://api.minimaxapikey.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
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.minimaxapikey.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);स्ट्रीमिंग
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)तकनीकी विवरण
API की सभी असली सीमाएँ और सुविधाएँ एक जगह — क्रेडिट जोड़ने से पहले इन्हें देख लें।
| मद | मान |
|---|---|
| API फ़ॉर्मेट | OpenAI के अनुकूल: कोई भी OpenAI SDK चलेगा — बस base URL और कुंजी बदलें |
| मॉडल ID | uncensored |
| Base URL | https://api.minimaxapikey.com/v1 |
| एंडपॉइंट | POST /v1/chat/completions · GET /v1/models |
| प्रमाणीकरण | Authorization: Bearer YOUR_KEY |
| पैरामीटर | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| JSON मोड | response_format: {"type": "json_object"} |
| कॉन्टेक्स्ट विंडो | 100,000 टोकन (इनपुट + आउटपुट मिलाकर) |
| स्ट्रीमिंग | हाँ — server-sent events; आख़िरी हिस्से में टोकन उपयोग |
| फ़ंक्शन कॉलिंग | हाँ — tools, tool_choice; जवाब में tool_calls, स्ट्रीमिंग में भी; नतीजे role: tool संदेश से भेजें |
| अधिकतम आउटपुट | 100,000-टोकन विंडो के शेष हिस्से तक; max_tokens वैकल्पिक (अलग सीमा नहीं) |
| समानांतर अनुरोध | प्रति कुंजी एक साथ 8 तक |
| रिस्पॉन्स हेडर | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| रेट लिमिट | प्रति कुंजी प्रति मिनट 300 अनुरोध |
| अनुरोध का आकार | 8 MB तक |
| बिलिंग | प्रीपेड क्रेडिट, असली उपयोग के अनुसार; त्रुटियाँ और अस्वीकृतियाँ मुफ़्त |
| वैधता | भुगतान किया क्रेडिट कभी समाप्त नहीं होता, कोई सदस्यता नहीं |
| मुफ़्त ट्रायल क्रेडिट | $0.50, 7 दिन, कार्ड की ज़रूरत नहीं · ट्रायल कुंजी: 2 समानांतर अनुरोध, 60 प्रति मिनट; पहले टॉप-अप के बाद पूरी सीमाएँ (8 और 300) |
| कीमत | प्रति 10 लाख इनपुट टोकन $0.25 · प्रति 10 लाख आउटपुट टोकन $1.00 |
| बोनस | $50 से +5%, $100 से +10% |
| टॉप-अप | USDT (TRC20) या USDC (Base), $10 से $500 तक कोई भी पूरी राशि |
| साइन इन | Google या ईमेल और पासवर्ड |
| कुंजियाँ | हर खाते में एक सक्रिय कुंजी; नई कुंजी पुरानी की जगह लेती है |
| सामग्री | वयस्क सामग्री की अनुमति; नाबालिगों से जुड़ी यौन सामग्री अस्वीकार |
त्रुटि कोड
त्रुटियाँ JSON में स्थिर type के साथ आती हैं; विफल या अस्वीकृत अनुरोधों का शुल्क नहीं लगता।
| कोड | प्रकार | अर्थ |
|---|---|---|
400 | bad_request | अमान्य JSON, खाली संदेश, गलत पैरामीटर या कॉन्टेक्स्ट विंडो से अधिक |
401 | missing_key · invalid_key · key_revoked | कुंजी नहीं, गलत कुंजी या नई कुंजी से बदली गई |
402 | no_credit | क्रेडिट ख़त्म — टॉप-अप करें, तुरंत चालू |
403 | content_blocked | नाबालिगों से जुड़ी यौन सामग्री — अस्वीकार, कोई शुल्क नहीं |
404 | not_found | अज्ञात एंडपॉइंट |
413 | request_too_large | बॉडी 8 MB से बड़ी |
429 | rate_limited · concurrency | 300/मिनट या 8 समानांतर से अधिक — रुककर फिर कोशिश करें |
503 | upstream_busy | मॉडल व्यस्त — कुछ सेकंड बाद फिर कोशिश करें |
प्रश्न और उत्तर
यदि मैं रेट लिमिट से अधिक हो जाता हूँ तो क्या होता है?
आपको 429 त्रुटि मिलेगी। प्रति कुंजी प्रति मिनट 300 अनुरोध की सीमा है। विंडो रीसेट होने के बाद रोकें और पुनः प्रयास करें। यदि आवश्यक हो तो एक नई कुंजी प्राप्त करने के लिए अपनी कुंजी को रीजनरेट करें।
मुझे 401 त्रुटि क्यों मिलती है?
आपकी API कुंजी अमान्य या अनुपस्थित है। जांचें कि आपने कुंजी को सही तरीके से कॉपी किया है। सुनिश्चित करें कि बेस URL हमारे एंडपॉइंट पर सेट है। साइनअप के तुरंत बाद कुंजियां दिखाई जाती हैं।
मूल्य निर्धारण कैसे काम करता है?
पे-एज़-यू-गो प्रीपेड क्रेडिट। 1M इनपुट टोकन के लिए $0.25, 1M आउटपुट टोकन के लिए $1.00। कोई मासिक शुल्क नहीं। क्रेडिट कभी एक्सपायर नहीं होता। टॉप-अप $10 से शुरू होते हैं।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएं, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।