MiniMax API सेटअप: कुंजी, बेस URL और पहला अनुरोध
यह minimaxapikey.com पर OpenAI-कम्पैटिबल API के लिए चरण-दर-चरण सेटअप है: खाता, कुंजी, बेस URL, पहला अनुरोध। यह एक स्वतंत्र सेवा है, किसी मॉडल विक्रेता की आधिकारिक API नहीं।
अपडेटेड

मुख्य बिंदु
- Google या ईमेल से साइन अप करें, फिर कुंजी पेज पर $0.50 का मुफ़्त ट्रायल क्रेडिट क्लेम करें। कार्ड की आवश्यकता नहीं है।
- बेस URL https://api.minimaxapikey.com/v1 है, मॉडल ID uncensored है, प्रमाणीकरण एक Bearer कुंजी है।
- दो विधियाँ मौजूद हैं: POST /v1/chat/completions और GET /v1/models।
- 401 का अर्थ है कुंजी खराब है, और 429 का अर्थ है कि रेट लिमिट टकरा गया है, इसलिए बॉडी में त्रुटि कोड की जाँच करें।
आप क्या सेटअप कर रहे हैं
लोग minimax api setup खोजते हैं, जिसमें दो चीज़ों में से एक की उम्मीद होती है: आधिकारिक MiniMax डेवलपर प्लेटफ़ॉर्म, या एक ड्रॉप-इन OpenAI-शैली एंडपॉइंट। यह पृष्ठ दूसरे को कवर करता है। minimaxapikey.com के पीछे की सेवा एक होस्टेड, OpenAI-कम्पैटिबल टेक्स्ट API है जो एक एकल ओपन-वेट मॉडल चलाती है, जिसे एक स्वतंत्र प्रदाता संचालित करता है। यह MiniMax या किसी अन्य मॉडल विक्रेता की आधिकारिक API नहीं है, और यह विक्रेताओं के बीच अनुरोध रूट नहीं करता है। यदि आपको विक्रेता का अपना प्लेटफ़ॉर्म चाहिए, तो उनकी साइट का उपयोग करें।
आपको जो मिलता है वह सरल है। बेस URL और कुंजी बदलने के बाद कोई भी OpenAI SDK या क्लाइंट काम करता है। दो विधियाँ हैं, POST /v1/chat/completions और GET /v1/models, एक मॉडल ID, uncensored, और प्रॉम्प्ट व कॉम्पलीशन के लिए साझा 100,000-टोकन कॉन्टेक्स्ट विंडो। यह केवल टेक्स्ट संभालता है, इसलिए इमेज, ऑडियो या वीडियो जनरेशन, एम्बेडिंग्स या फाइन-ट्यूनिंग नहीं है। स्ट्रीमिंग, फ़ंक्शन कॉलिंग और JSON मोड समर्थित हैं।
पूरा सेटअप कुछ मिनटों में होता है। नीचे दिए गए चरण क्रम में हैं, और प्रत्येक एक जाँच के साथ समाप्त होता है ताकि आप जान सकें कि आगे बढ़ने से पहले यह काम कर गया है।
चरण 1 और 2: खाता बनाएं और ट्रायल क्लेम करें
- कुंजी पेज खोलें। API कुंजी पेज पर जाएं और साइन अप करें। आप Google, या एक ईमेल पता और पासवर्ड का उपयोग कर सकते हैं।
- ट्रायल क्रेडिट दावा करें। साइन-अप के बाद, कुंजी पृष्ठ पर $0.50 के मुफ़्त ट्रायल क्रेडिट के लिए एक बटन होता है। यह एक क्लिक में होता है, कार्ड की आवश्यकता नहीं होती, 7 दिनों के लिए मान्य होता है, और प्रति व्यक्ति केवल एक बार उपलब्ध होता है।
ट्रायल जानबूझकर छोटा है। $0.15 प्रति 1M इनपुट टोकन और $0.50 प्रति 1M आउटपुट टोकन की दर से, $0.50 परीक्षण अनुरोधों की एक अच्छी संख्या को कवर करता है। 1,000 टोकन के प्रॉम्प्ट और 500-टोकन के उत्तर के लिए इनपुट के लिए $0.00015 और आउटपुट के लिए $0.00025 लागत आती है, जो कुल $0.0004 है। $0.50 को उससे विभाजित करने पर 1,250 ऐसे अनुरोध मिलते हैं, इसलिए आपके पास प्रयोग करने के लिए पर्याप्त स्थान है।
ट्रायल कुंजी की सीमाएँ ध्यान में रखें: 2 समानांतर अनुरोध और प्रति मिनट 60 अनुरोध। टॉप-अप करने पर जो पूर्ण कुंजी मिलती है, वह 8 समानांतर अनुरोध और प्रति मिनट 300 की अनुमति देती है। यदि आपका टेस्ट लूप समानांतर चलता है और आपको 429 त्रुटियाँ दिखती हैं, तो यह जाँचने वाली पहली चीज़ है।
चरण 3: कुंजी बनाएं और इसे सुरक्षित रखें
उसी पृष्ठ पर, एक API कुंजी बनाएं और इसे कॉपी करें। इसे एक पासवर्ड की तरह मानें। इसे एक एनवायरनमेंट वेरिएबल या सिक्रेट्स मैनेजर में रखें, रैपॉजिटरी, फ्रंट-एंड बंडल या स्क्रीनशॉट में कभी नहीं। यदि कुंजी लीक हो जाती है, तो उसे हटा दें और एक नई बनाएं।
# macOS / Linux
export UNCENSORED_KEY="paste-your-key-here"
# Windows PowerShell
$env:UNCENSORED_KEY = "paste-your-key-here"
सर्वर-साइड कोड को रनटाइम पर वेरिएबल पढ़ना चाहिए। ब्राउज़र कोड को कुंजी को कभी नहीं रखना चाहिए: अपने बैकएंड से अनुरोध भेजें, क्योंकि ब्राउज़र में भेजा गया कुछ भी हर आगंतुक के लिए दिखाई देता है।
चरण 4: कुंजी की पुष्टि के लिए मॉडल सूचीबद्ध करें
सबसे सस्ता संभव टेस्ट मॉडल एंडपॉइंट है। यह कोई टेक्स्ट जनरेट नहीं करता, इसलिए यह कुंजी, URL और आपके नेटवर्क की एक स्वच्छ जाँच है।
curl -s https://api.minimaxapikey.com/v1/models \
-H "Authorization: Bearer $UNCENSORED_KEY"
आपको एक JSON सूची मिलनी चाहिए जिसमें uncensored शामिल हो। यदि आपको 401 मिलता है, तो कुंजी गलत है या उसके चारों ओर कोई अतिरिक्त स्पेस या क्वोट है। यदि कनेक्शन विफल हो जाता है, तो जांचें कि URL /v1 पर समाप्त होता है और आपने https का उपयोग किया है।
चरण 5: पहला चैट अनुरोध भेजें
अब एक वास्तविक कॉम्पलीशन अनुरोध। बॉडी मानक chat completions रूप में है।
curl -s https://api.minimaxapikey.com/v1/chat/completions \
-H "Authorization: Bearer $UNCENSORED_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "user", "content": "Explain what an API key is in two sentences."}
],
"temperature": 0.7
}'
प्रतिक्रिया में choices[0].message.content और एक usage ब्लॉक होता है जिसमें प्रॉम्प्ट और कॉम्पलीशन टोकन की गिनती होती है। curl -i के साथ प्रतिक्रिया हेडर भी देखें। आपको X-Request-Id दिखेगा, जिसका उपयोग सहायता आपका अनुरोध खोजने के लिए कर सकती है, X-Balance-USD, आपका शेष क्रेडिट, और रेट लिमिट हेडर X-RateLimit-Limit-Requests और X-RateLimit-Limit-Concurrency।
temperature, top_p, stop, seed और पेनल्टी जैसे पैरामीटर पास किए जाते हैं। max_tokens वैकल्पिक है। यदि आप इसे छोड़ देते हैं, तो कॉम्पलीशन विंडो के शेष हिस्से का उपयोग कर सकता है।
चरण 6: SDK से समान कॉल
एक बार curl काम कर जाने के बाद, उस भाषा पर जाएं जिसे आप वास्तव में उपयोग करेंगे। स्टॉक OpenAI सेटअप से केवल दो तर्क बदलते हैं।
from openai import OpenAI
import os
client = OpenAI(
base_url="https://api.minimaxapikey.com/v1",
api_key=os.environ["UNCENSORED_KEY"],
)
reply = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Give me three names for a hiking app."}],
)
print(reply.choices[0].message.content)
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.minimaxapikey.com/v1",
apiKey: process.env.UNCENSORED_KEY,
});
const reply = await client.chat.completions.create({
model: "uncensored",
messages: [{ role: "user", content: "Give me three names for a hiking app." }],
});
console.log(reply.choices[0].message.content);
स्ट्रीमिंग के लिए, stream: true जोड़ें और सर्वर-सेंट इवेंट्स पढ़ें। उपयोग संख्याएँ स्ट्रीम के अंत में आती हैं। डॉक्स पेज स्ट्रीमिंग, फ़ंक्शन कॉलिंग और JSON मोड को response_format: {"type":"json_object"} के साथ कवर करता है।
मौजूदा OpenAI प्रोजेक्ट को स्थानांतरित करना
अधिकांश समय उस प्रोजेक्ट के साथ जो आप कनेक्ट करना चाहते हैं, पहले से OpenAI की क्लाइंट लाइब्रेरी के साथ काम करता है। उस स्थिति में आपको कोड में बहुत कम बदलाव करने की आवश्यकता होती है। आधिकारिक SDKs पर्यावरण चर OPENAI_API_KEY और OPENAI_BASE_URL पढ़ते हैं जब आप तर्क नहीं देते, इसलिए एक डिप्लॉयमेंट बदलाव पर्याप्त हो सकता है।
export OPENAI_BASE_URL="https://api.minimaxapikey.com/v1"
export OPENAI_API_KEY="paste-your-key-here"
# then in your code, request model "uncensored"
बाकी एकमात्र संपादन मॉडल नाम है। एक स्ट्रिंग जैसे OpenAI मॉडल ID यहाँ मौजूद नहीं होगी, इसलिए इसे uncensored से बदलें, बेहतर होगा कि इसे एक कॉन्फ़िगरेशन मान के माध्यम से करें ताकि आप वापस स्विच कर सकें। फिर कोड में उन सुविधाओं की जाँच करें जो सेवा प्रदान नहीं करती। इमेज जनरेशन, ऑडियो, एम्बेडिंग्स और फाइन-ट्यूनिंग उपलब्ध नहीं हैं, क्योंकि यह एक टेक्स्ट-ओनली चैट API है। यदि आपका ऐप खोज के लिए एम्बेडिंग्स को कॉल करता है, तो आपको उस भाग के लिए एक अन्य प्रदाता की आवश्यकता होगी और चैट को इस पर ही रख सकते हैं।
इसे जानने में भी मदद मिलती है कि मॉडल क्या है। यह एक अकेला ओपन-वेट मॉडल है, जिसे कानूनी वयस्कों के उपयोग के लिए बिना सेंसर उत्तर देने के लिए ट्यून्ड किया गया है, और एक कठोर सीमा सभी सेटिंग्स के बावजूद लागू होती है: नाबालिगों को शामिल करने वाली यौन सामग्री की अनुमति नहीं। किसी अन्य मॉडल के लिए लिखे गए प्रॉम्प्ट में छोटे समायोजन की आवश्यकता हो सकती है, क्योंकि प्रत्येक मॉडल समान सिस्टम प्रॉम्प्ट के प्रति अलग-अलग प्रतिक्रिया देता है। वास्तविक ट्रैफ़िक को स्विच करने से पहले अपने परीक्षण प्रॉम्प्ट को साइड-बाय-साइड चलाएं।
पहले दिन चुनने योग्य सेटिंग्स
कुछ निर्णय लॉन्च के बाद की तुलना में सेटअप समय पर बनाना आसान है। उनमें से कोई भी कठिन नहीं है, लेकिन प्रत्येक बाद में एक आश्चर्य से बचाता है।
- एक सिस्टम प्रॉम्प्ट। टोन, प्रारूप और भूमिका के बारे में अपने निर्देश एक
systemसंदेश में डालें। इसे छोटा और विशिष्ट रखें, क्योंकि हर अनुरोध इसे इनपुट टोकन के रूप में दोहराता है। - एक टोकन कैप।
max_tokensवैकल्पिक है, लेकिन एक कैप एक सस्ता सुरक्षा कवच है। एक के बिना एक अकेला उत्तर 100,000-टोकन विंडो के शेष हिस्से का उपयोग कर सकता है। - इंटरैक्टिव उपयोग के लिए स्ट्रीमिंग। यदि कोई व्यक्ति प्रतिक्रिया का इंतज़ार कर रहा है, तो
stream: trueसेट करें। बैच जॉब्स के लिए, सादे अनुरोध अधिक सरल हैं। - 429 के लिए पुनः प्रयास नियम। 429 को विफलता के बजाय प्रतीक्षा का संकेत मानें। जब प्रतिक्रिया में
Retry-After: 5शामिल हो, तो उतनी देर प्रतीक्षा करना और फिर से प्रयास करना सही कदम है। - अनुरोध का आकार। बॉडी की सीमा 8 MB है। यह एक सामान्य प्रॉम्प्ट की आवश्यकता से कहीं अधिक है, लेकिन पेस्ट किए गए लॉग या दस्तावेज़ इस तक पहुँच सकते हैं।
प्रॉम्प्ट को प्रशिक्षण के लिए उपयोग नहीं किया जाता है, जो यदि आप आंतरिक दस्तावेज़ या उपयोगकर्ता संदेश भेजने की योजना बना रहे हैं तो महत्वपूर्ण है। आप जो भेजते हैं, उसके लिए आप ही उत्तरदायी हैं, इसलिए प्रॉम्प्ट में उन रहस्यों को न डालें जिनकी मॉडल को आवश्यकता नहीं है।
ट्रायल के बाद टॉप-अप करना
ट्रायल यह जाँचने के लिए है कि सब कुछ काम कर रहा है या नहीं। जब आप बनाने के लिए तैयार हों, तो प्रीपेड क्रेडिट जोड़ें। कोई सब्सक्रिप्शन नहीं है: आप उपयोग किए गए टोकन के लिए भुगतान करते हैं, $0.15 प्रति 1M इनपुट टोकन और $0.50 प्रति 1M आउटपुट टोकन के लिए, और क्रेडिट कभी समाप्त नहीं होता, इसलिए एक अप्रयुक्त शेष राशि महीने के अंत में गायब नहीं होती।
$20 से $500 तक कोई भी पूर्णांक राशि काम करती है। एक $50 टॉप-अप 5% बोनस जोड़ता है, $100 10% जोड़ता है, और $200 15% जोड़ता है। एक त्वरित उदाहरण के रूप में, 10% बोनस के साथ एक $100 टॉप-अप क्रेडिट का $110 देता है। चरण दो से 1,000-टोकन प्रॉम्प्ट और 500-टोकन उत्तर पर, प्रत्येक अनुरोध $0.0004 का खर्च करता है, इसलिए $110 275,000 अनुरोधों को कवर करता है। वास्तविक प्रॉम्प्ट आमतौर पर लंबे होते हैं, इसलिए उस संख्या को अपने औसत पर स्केल करें।
सामान्य सेटअप त्रुटियों को ठीक करना
| लक्षण | संभावित कारण | समाधान |
|---|---|---|
| हर कॉल पर 401 | गुम, गलत टाइप या रद्द की गई कुंजी | Authorization: Bearer <key> भेजें, बिना अतिरिक्त कोट्स के |
| 404 या HTML प्रतिक्रिया | गलत पथ, आमतौर पर /v1 की कमी | /v1 पर समाप्त होने वाली पूर्ण बेस URL का उपयोग करें |
| मॉडल नहीं मिला | दूसरे प्रदाता से कॉपी किया गया मॉडल नाम | uncensored का उपयोग करें |
429 के साथ rate_limited | प्रति मिनट अनुरोधों की सीमा से अधिक | गति कम करें, या ट्रायल सीमाओं से पूर्ण सीमाओं में जाने के लिए टॉप-अप करें |
429 के साथ concurrency | एक साथ बहुत सारे अनुरोध | समानांतर कॉल को 8 (ट्रायल कुंजी पर 2) तक सीमित करें |
429 के साथ Retry-After: 5 | अस्थायी ओवरलोड | 5 सेकंड प्रतीक्षा करें और पुनः प्रयास करें |
| 413 या बॉडी अस्वीकृत | अनुरोध 8 MB से अधिक | प्रॉम्प्ट को काटें या कार्य को विभाजित करें |
जब आप ट्रायल से अधिक के लिए तैयार हों, तो प्राइसिंग पेज टॉप-अप विकल्पों की सूची देता है: $20 से $500 तक कोई भी पूर्णांक राशि, क्रिप्टो (TRC20 पर USDT, Base पर USDC) द्वारा भुगतान, $50 से 5% बोनस, $100 से 10% और $200 से 15% के साथ। विफल या अस्वीकृत अनुरोधों पर चार्ज नहीं किया जाता है, और प्रॉम्प्ट प्रशिक्षण के लिए उपयोग नहीं किए जाते हैं।
अधिक गाइड
प्रश्न और उत्तर
क्या यह आधिकारिक MiniMax API है?
नहीं। यह एक स्वतंत्र, होस्टेड, OpenAI-कम्पैटिबल API है जो एक ओपन-वेट मॉडल को सर्व करती है, जिसे कानूनी वयस्क उपयोग के लिए बिना सामग्री अस्वीकृति के उत्तर देने के लिए ट्यून्ड किया गया है। यह किसी मॉडल विक्रेता की आधिकारिक API नहीं है और न ही विक्रेताओं के बीच एक राउटर है।
क्या इसे ट्राई करने के लिए क्रेडिट कार्ड की आवश्यकता है?
नहीं। साइन-अप करने के बाद, आप API कुंजी पेज पर एक क्लिक से $0.50 का मुफ़्त ट्रायल क्रेडिट क्लेम कर सकते हैं। यह 7 दिनों के लिए मान्य है और प्रति व्यक्ति केवल एक बार उपलब्ध है।
अनुरोधों में उपयोग करने के लिए मॉडल का नाम क्या है?
uncensored का उपयोग करें। सेवा इस एकल मॉडल ID को एक्सपोज़ करती है, और GET /v1/models इसे दिखाएगा।
बाद में अधिक क्रेडिट कैसे जोड़ें?
$20 से $500 तक कोई भी पूर्णांक राशि टॉप-अप करें। बोनस $50 (+5%), $100 (+10%) और $200 (+15%) से लागू होते हैं, और क्रेडिट कभी समाप्त नहीं होता है।
क्या मैं OpenAI SDK का उपयोग कर सकता हूँ?
हाँ। base_url को https://api.minimaxapikey.com/v1 पर सेट करें, अपनी कुंजी का उपयोग करें, और uncensored मॉडल को भेजें। आपके कोड में और कुछ बदलने की ज़रूरत नहीं है।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।