Character AI API: तीन पंक्तियों में अपना क्लाइंट बदलें

आवश्यकताएं

कोड लिखने से पहले, आपको characteraiapi.com पर एक सक्रिय खाते की आवश्यकता है। API कुंजी प्राप्त करें पृष्ठ पर जाएं और केवल ईमेल और पासवर्ड से साइन अप करें। शुरू करने के लिए क्रेडिट कार्ड की आवश्यकता नहीं है, और नए खातों को 7 दिनों के लिए मान्य $0.50 के मुफ़्त ट्रायल क्रेडिट प्राप्त होते हैं। पंजीकरण के बाद, आपकी API कुंजी तुरंत प्रदर्शित होती है। इस कुंजी को सुरक्षित रखें, क्योंकि यह एंडपॉइंट को सभी अनुरोधों को प्रमाणीकृत करती है। आपको अपने विकास वातावरण में एक समर्थित भाषा SDK की भी आवश्यकता होगी। character ai api एंडपॉइंट मानक OpenAI पैरामीटर स्वीकार करता है, इसलिए कोई भी मौजूदा OpenAI-संगत क्लाइंट न्यूनतम परिवर्तनों के साथ काम कर सकता है।

SDK इंस्टॉल करें

Python प्रोजेक्ट्स के लिए, pip का उपयोग करके आधिकारिक OpenAI पैकेज स्थापित करें। यह लाइब्रेरी JSON सीरियलाइज़ेशन और HTTP अनुरोधों को स्वचालित रूप से संभालती है। Node.js अनुप्रयोगों के लिए, npm का उपयोग करके openai पैकेज जोड़ें। दोनों लाइब्रेरियां इस मार्गदर्शिका में बाद में वर्णित स्ट्रीमिंग और टूल-कॉलिंग सुविधाओं का समर्थन करती हैं। सुनिश्चित करें कि आपका SDK संस्करण रियल-टाइम टोकन स्ट्रीमिंग के लिए सर्वर-सेंट इवेंट्स (SSE) का समर्थन करने के लिए पर्याप्त नवीन है। यदि आप SDK के बजाय एक कस्टम HTTP क्लाइंट का उपयोग कर रहे हैं, तो आपको OpenAI API विनिर्देश के अनुसार JSON पेलोड और SSE स्ट्रीम पार्सिंग को मैन्युअल रूप से संभालना होगा।

प्रमाणीकरण

API को प्रत्येक अनुरोध में अपनी API कुंजी Authorization हेडर में शामिल करनी होगी। Bearer YOUR_API_KEY प्रारूप का उपयोग करें। सभी अनुरोधों के लिए बेस यूआरएल https://api.characteraiapi.com/v1 है। जब SDK का उपयोग करें, तो इस मान के लिए base_url कॉन्फ़िगरेशन सेट करें और api_key पैरामीटर के माध्यम से अपनी कुंजी प्रदान करें। यदि आप अपनी कुंजी खो देते हैं या लीक होने का संदेह है, तो आप डैशबोर्ड से इसे पुन: उत्पन्न कर सकते हैं; पुरानी कुंजी तुरंत रद्द कर दी जाएगी। प्रति खाता केवल एक सक्रिय कुंजी की अनुमति है। सुनिश्चित करें कि आप सही बेस यूआरएल का उपयोग कर रहे हैं, क्योंकि मानक OpenAI एंडपॉइंट पर अनुरोध 404 या 401 त्रुटि के साथ विफल हो जाएंगे।

बुनियादी चैट पूर्णता

मुख्य कार्यक्षमता /v1/chat/completions एंडपॉइंट के माध्यम से प्रदान की जाती है। मॉडल नाम uncensored और अपनी संवाद इतिहास के साथ एक POST अनुरोध भेजें। मॉडल कानूनी वयस्क सामग्री के लिए मानक सामग्री फ़िल्टर लागू किए बिना टेक्स्ट आउटपुट के साथ प्रतिक्रिया देता है। नीचे एक सरल टेक्स्ट कंप्लीशन अनुरोध को प्रदर्शित करने वाला एक curl उदाहरण दिया गया है।

Copycurl https://api.characteraiapi.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."}]
  }'

यह अनुरोध उत्पन्न टेक्स्ट वाला एक कंप्लीशन ऑब्जेक्ट लौटाता है। आप यादृच्छिकता को नियंत्रित करने के लिए temperature जैसे पैरामीटर को समायोजित कर सकते हैं या आउटपुट लंबाई को सीमित करने के लिए max_tokens। मॉडल 100,000 टोकन की कॉन्टेक्स्ट विंडो का समर्थन करता है, जिससे एकल अनुरोध में संवाद इतिहास के बड़े हिस्से या लंबे दस्तावेजों को संसाधित करने की अनुमति मिलती है।

स्ट्रीमिंग प्रतिक्रियाएं

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

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)

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

API प्रति कुंजी प्रति मिनट 300 अनुरोधों की सीमा लागू करता है। यदि आप इससे अधिक हो जाते हैं, तो आपको 429 Too Many Requests त्रुटि प्राप्त होगी। अनुरोध बॉडी 8 MB तक सीमित है। सामान्य त्रुटियों में अमान्य या अनुपस्थित कुंजी के लिए 401 और यदि आपका प्रीपेड क्रेडिट समाप्त हो जाता है तो 402 शामिल है। आप क्रिप्टो (USDT या USDC) का उपयोग करके $10 से टॉप-अप कर सकते हैं, बड़े जमा के लिए बोनस क्रेडिट उपलब्ध हैं। कुछ प्रदाताओं के विपरीत, कोई छिपा शुल्क या सब्सक्रिप्शन लॉक नहीं हैं; आप केवल उन टोकन के लिए भुगतान करते हैं जिन्हें आप उपभोग करते हैं। मूल्य पारदर्शी है: 1M इनपुट टोकन प्रति $0.25 और 1M आउटपुट टोकन प्रति $1.00। सुनिश्चित करें कि आपकी त्रुटि हैंडलिंग लॉजिक 429 पर एक्सपोनेंशियल बैकऑफ़ के साथ पुन: प्रयास करता है।

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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