मिनीमैक्स एपीआई: क्विकस्टार्ट और SDK गाइड

प्रमाणीकरण और बेस यूआरएल

प्रदान की गई एपीआई कुंजी का उपयोग करें और अपने क्लाइंट को समर्पित बेस यूआरएल पर पॉइंट करें। प्रतिक्रियाएं जनरेट करने के लिए एंडपॉइंट है https://api.minimaxaiapi.com/v1/chat/completions. आप कुंजी को Authorization header एक bearer token के रूप में। यह किसी भी मानक OpenAI SDK के साथ काम करता है क्योंकि हम समान प्रोटोकॉल का पालन करते हैं।

• हेडर नाम: Authorization
• हेडर मान: Bearer YOUR_API_KEY
• बेस यूआरएल: https://api.minimaxaiapi.com/v1

कोई जटिल सेटअप की आवश्यकता नहीं है। बस अपनी मौजूदा प्रोजेक्ट में कॉन्फ़िगरेशन अपडेट करें।

Copycurl https://api.minimaxaiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with keys name and age"}]
  }'

चैट कंप्लीशंस एंडपॉइंट

टेक्स्ट रिस्पॉन्स प्राप्त करने के लिए चैट कंप्लीशन्स एंडपॉइंट पर एक POST रिक्वेस्ट भेजें। मॉडल आइडेंटिफायर है uncensored. आपको अपने संवाद इतिहास के साथ एक संदेश सरणी शामिल करनी होगी। सिस्टम इनपुट को संसाधित करता है और आपके प्रॉम्प्ट के आधार पर जनरेटेड टेक्स्ट लौटाता है।

यह एंडपॉइंट सभी टेक्स्ट जनरेशन हैंडल करता है। यह एम्बेडिंग्स, ऑडियो, या वीडियो को सपोर्ट नहीं करता है। आप रिस्पॉन्स को स्ट्रीम कर सकते हैं या पूरे ब्लॉक का इंतज़ार कर सकते हैं। मॉडल कुल 100,000 टोकन के कंटेक्स्ट को हैंडल करता है।

Copyfrom openai import OpenAI

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

स्ट्रीमिंग और टोकन उपयोग

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

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

Copyimport OpenAI from "openai";

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

फंक्शन कॉलिंग और JSON मोड

का उपयोग करें tools फ़ंक्शन कॉलिंग को सक्षम करने के लिए पैरामीटर। अनुरोध बॉडी में अपने फ़ंक्शन्स परिभाषित करें और मॉडल को यह चुनने दें कि किसे कॉल करना है। tool_choice पैरामीटर आपको एक विशिष्ट फ़ंक्शन को फोर्स करने या स्वतः-चयन करने की अनुमति देता है। कठोर JSON आउटपुट के लिए, सेट करें response_format को {"type": "json_object"}. यह सुनिश्चित करता है कि प्रतिक्रिया मान्य JSON हो।

फंक्शन कॉलिंग संरचित डेटा निकालने या क्रियाएं ट्रिगर करने के लिए उपयोगी है। JSON मोड उन API एकीकरणों के लिए उत्तम है जिनमें भविष्यसूचक फॉर्मेट की आवश्यकता होती है। मजबूत एप्लिकेशन लॉजिक के लिए दोनों को मिलाएं।

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)

मॉडल पैरामीटर और बाधाएँ

मानक पैरामीटर जैसे का उपयोग करके जनरेशन व्यवहार को समायोजित करें temperature, top_p, और stop. अधिकतम संदर्भ विंडो 100,000 टोकन की है, जिसमें प्रॉम्प्ट और पूर्णता दोनों शामिल हैं। प्रति अनुरोध अधिकतम आउटपुट 16,000 टोकन है। यदि आप सेट नहीं करते max_tokens, सीमा डिफ़ॉल्ट रूप से 2,048 टोकन है।

उपयोग करें seed पुनरुत्पादनीय परिणामों के लिए। सेट करें presence_penalty और frequency_penalty दोहराव को नियंत्रित करने के लिए। ये पैरामीटर मॉडल की रचनात्मकता और स्थिरता पर सूक्ष्म नियंत्रण प्रदान करते हैं। सही संतुलन खोजने के लिए हमेशा अपने विशिष्ट उपयोग मामले के साथ परीक्षण करें।

रेट लिमिट्स और त्रुटियाँ

API प्रति कुंजी प्रति मिनट 300 अनुरोधों की सीमा लागू करता है और 8 समवर्ती अनुरोधों की अनुमति देता है। यदि आप इन सीमाओं को पार करते हैं, तो आपको 429 त्रुटि मिलती है। 401 त्रुटि अमान्य या अनुपस्थित API कुंजी का संकेत देती है। 402 त्रुटि का अर्थ है कि आपका प्रीपेड क्रेडिट समाप्त हो गया है।

त्रुटियां आपके क्रेडिट का उपभोग नहीं करतीं। आप विफल अनुरोधों को बिना किसी दंड के पुनः प्रयास कर सकते हैं। अनुरोध बॉडी का आकार 8 MB तक सीमित है। थ्रॉटलिंग से बचने के लिए अपनी कंकरेंसी का सावधानीपूर्वक प्रबंधन करें। स्ट्रीमिंग प्रतिक्रियाओं के अंतिम चंक के माध्यम से अपने उपयोग की निगरानी करें।