HI ▾
API कुंजी पाएँ

Character AI API कुंजी: कैसे प्राप्त करें और उपयोग करें

यदि आपने Character AI API कुंजी खोजी, तो सबसे पहले यह जानना है कि यह साइट Character.ai नहीं है और न ही इसकी कुंजियाँ जारी करती है। यह आपको एक स्वतंत्र, OpenAI-संगत टेक्स्ट API के लिए एक कुंजी देता है जो कैरेक्टर चैट ऐप्स के लिए एक ड्रॉप-इन बैकएंड के रूप में काम करती है।

चैट पैनल के ऊपर चमकती हुई कुंजी, जो सर्वर क्यूब से जुड़ी है, जो API कुंजी एक्सेस को दर्शाती है

मुख्य बिंदु

  1. Google या ईमेल और पासवर्ड से साइन इन करने के बाद, और API कुंजी पेज खोलने पर आपको एक कुंजी मिलती है।
  2. नए उपयोगकर्ता एक क्लिक से $0.50 का ट्रायल क्रेडिट प्राप्त कर सकते हैं, कार्ड की आवश्यकता नहीं, 7 दिनों के लिए मान्य।
  3. किसी भी OpenAI SDK के साथ Base URL https://api.characteraiapi.com/v1 और model ID uncensored का उपयोग करें।
  4. कुंजी को सर्वर पर या एक पर्यावरण चर में रखें, कभी भी सार्वजनिक फ्रंट-एंड कोड में नहीं।

आपको वास्तव में क्या मिल रहा है

Character.ai एक उपभोक्ता चैट उत्पाद है। लोग जो Character AI API कुंजी खोजते हैं, आमतौर पर दो चीज़ों में से एक चाहते हैं: अपने कोड से एक कैरेक्टर चैटबॉट को कॉल करने का तरीका, या एक ऐसा बैकएंड जो किसी होस्टेड उत्पाद के नियमों से सीमित न हो। यह साइट दूसरी आवश्यकता को कवर करती है। आप साइन अप करते हैं, एक कुंजी प्राप्त करते हैं, और एक OpenAI-संगत एंडपॉइंट पर अनुरोध भेजते हैं। यहाँ कुछ भी Character.ai से कनेक्ट नहीं होता या उसके कैरेक्टर्स का पुन: उपयोग नहीं करता।

यह सेवा एक ओपन-वेट मॉडल के सामने एक होस्टेड टेक्स्ट API है, जो एक स्वतंत्र प्रदाता द्वारा चलाई जाती है और कानूनी वयस्क उपयोग के लिए कंटेंट अस्वीकार किए बिना जवाब देने के लिए ट्यून्ड है। यह किसी मॉडल विक्रेता की आधिकारिक API नहीं है और न ही यह विक्रेताओं के बीच एक रूटर है। मॉडल ID uncensored है, और बेस URL https://api.characteraiapi.com/v1 है। दो विधियाँ मौजूद हैं: POST /v1/chat/completions और GET /v1/models।

क्योंकि इंटरफ़ेस OpenAI से मेल खाता है, किरदार बनाने की मेहनत आपके पक्ष में है। आप व्यक्तित्व को सिस्टम संदेश के रूप में लिखते हैं, बातचीत का इतिहास बनाए रखते हैं और इसे प्रत्येक अनुरोध के साथ भेजते हैं। इससे आपको आवाज़, स्मृति और गति पर वह नियंत्रण मिलता है जो एक बंद उत्पाद दुर्लभ रूप से प्रकट करता है। कठोर सीमा हर उपयोगकर्ता के लिए समान है: नाबालिगों से जुड़ी यौन सामग्री कभी नहीं।

अपनी कुंजी पाँच चरणों में प्राप्त करें

पूरा मार्ग कुछ मिनटों में होता है। शुरू करने के लिए आपको कार्ड की आवश्यकता नहीं है।

  1. साइन अप करें। Google का उपयोग करें, या एक ईमेल और पासवर्ड के साथ पंजीकरण करें।
  2. कुंजी पेज खोलें। API कुंजी पेज पर जाएं, जहाँ आपके खाते की कुंजी दिखाई जाती है।
  3. ट्रायल क्रेडिट प्राप्त करें। उस पेज पर एक क्लिक करने से $0.50 का मुफ़्त ट्रायल क्रेडिट जुड़ जाता है। यह प्रति व्यक्ति एक बार सीमित है और 7 दिनों के लिए मान्य है।
  4. कुंजी कॉपी करें। इसे तुरंत एक पासवर्ड मैनेजर या सीक्रेट्स फ़ाइल में स्टोर करें।
  5. एक टेस्ट अनुरोध भेजें। किसी भी ऐप कोड को छूने से पहले नीचे दिए गए curl कमांड का उपयोग करें।

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

curl के साथ कुंजी का परीक्षण करें

कुंजी को एक पर्यावरण चर के रूप में सेट करें ताकि यह आपके शेल इतिहास में कभी भी एक स्क्रिप्ट के अंदर सादे टेक्स्ट के रूप में न आए। फिर मॉडल सूचीबद्ध करें। यह पुष्टि करता है कि कुंजी काम कर रही है और आप सही होस्ट तक पहुँच रहे हैं।

export API_KEY="paste-your-key-here"

curl https://api.characteraiapi.com/v1/models \
  -H "Authorization: Bearer $API_KEY"

आपको एक JSON सूची मिलनी चाहिए जिसमें uncensored शामिल है। अब एक छोटे व्यक्तित्व के साथ एक पहला चैट अनुरोध भेजें। सिस्टम संदेश किरदार सेट करता है, उपयोगकर्ता संदेश दृश्य शुरू करता है।

curl https://api.characteraiapi.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [
      {"role": "system", "content": "You are Mara, a dry-witted ship engineer in a space opera. Stay in character."},
      {"role": "user", "content": "The reactor is humming wrong again. What do you do?"}
    ],
    "temperature": 0.9
  }'

प्रतिक्रिया मानक चैट पूर्णता आकार का अनुसरण करती है। जवाब टेक्स्ट choices[0].message.content में होता है। प्रतिक्रिया हेडर में X-Request-Id, X-Balance-USD और रेट लिमिट हेडर भी होते हैं, जो आपके अपने UI में शेष बैलेंस दिखाने के लिए उपयोगी होता है।

Python या Node से कुंजी का उपयोग करें

एक बार जब आप दो मान बदल देते हैं — बेस URL और कुंजी — तो कोई भी OpenAI SDK काम कर देता है। यहाँ आधिकारिक openai पैकेज के साथ Python संस्करण है।

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.characteraiapi.com/v1",
    api_key=os.environ["API_KEY"],
)

reply = client.chat.completions.create(
    model="uncensored",
    messages=[
        {"role": "system", "content": "You are Mara, a ship engineer. Stay in character."},
        {"role": "user", "content": "Status report?"},
    ],
)
print(reply.choices[0].message.content)

और Node में वही कॉल:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.characteraiapi.com/v1",
  apiKey: process.env.API_KEY,
});

const reply = await client.chat.completions.create({
  model: "uncensored",
  messages: [
    { role: "system", content: "You are Mara, a ship engineer. Stay in character." },
    { role: "user", content: "Status report?" },
  ],
});
console.log(reply.choices[0].message.content);

अधिकतर चैट फ्रंट-एंड्स में एक कस्टम OpenAI-संगत एंडपॉइंट के लिए फ़ील्ड होता है। उन टूल्स में आप बेस URL पेस्ट करते हैं, कुंजी पेस्ट करते हैं, और मॉडल नाम के रूप में uncensored टाइप करते हैं। कुछ और बदलने की आवश्यकता नहीं है। दस्तावेज़ पृष्ठ समर्थित पैरामीटर की सूची देता है, जिसमें स्ट्रीमिंग, फ़ंक्शन कॉलिंग और JSON मोड शामिल हैं।

कुंजी की सामान्य समस्याएँ और त्वरित समाधान

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

  • कुंजी में अतिरिक्त सफ़ेद स्थान या उद्धरण चिह्न। फ़ाइल से कॉपी किया गया एक ट्रेलिंग न्यूलाइन भी प्रमाणीकरण को विफल कर सकता है। वेरिएबल की लंबाई प्रिंट करें और इसे उससे तुलना करें जिसे आपने कॉपी किया था।
  • गलत बेस URL। बेस URL /v1 पर समाप्त होता है, और SDK स्वयं /chat/completions जोड़ देता है। यदि आप बेस URL में भी /chat/completions जोड़ देते हैं, तो पथ दोगुना हो जाता है और अनुरोध विफल हो जाता है।
  • गलत मॉडल नाम। मॉडल ID uncensored है। अन्य सेवाओं से लिए गए नाम मेल नहीं खाएंगे। यह देखने के लिए कि सर्वर क्या रिपोर्ट कर रहा है, GET /v1/models कॉल करें।
  • हैडर की कमी। शुद्ध HTTP कॉल्स में Authorization: Bearer की ज़रूरत होती है, जिसके बाद एक स्पेस और कुंजी आती है, साथ ही POST अनुरोधों पर Content-Type: application/json भी।
  • खाली बैलेंस। X-Balance-USD रिस्पॉन्स हेडर दिखाता है कि क्या शेष है। जब मुफ़्त ट्रायल क्रेडिट खत्म हो जाता है या 7 दिनों की अवधि समाप्त हो जाती है, तो टॉप-अप करें या अनुरोध सफल नहीं होंगे।
  • रेट लिमिट। एक ट्रायल कुंजी 2 समानांतर अनुरोध और प्रति मिनट 60 की अनुमति देती है। दो खुले स्ट्रीम्स पहले ही दोनों स्लॉट्स ले लेते हैं।

एक खराब कुंजी आमतौर पर मॉडल की प्रतिक्रिया के बजाय एक प्रमाणीकरण त्रुटि उत्पन्न करती है। एक लिमिट HTTP 429 के साथ rate_limited या concurrency कोड के साथ आती है। त्रुटि बॉडी को पढ़ना, केवल स्टेटस कोड के बजाय, समय बचाता है क्योंकि कोड बताता है कि आप किस लिमिट पर पहुँचे हैं। हर रिस्पॉन्स में एक X-Request-Id होता है; इसे अपने लॉग में रखें, ताकि आप बाद में किसी विफल कॉल को विशिष्ट अनुरोध से मिला सकें।

ट्रायल सीमाएँ और ट्रायल से क्या खरीदा जा सकता है

एक ट्रायल कुंजी की लिमिट पूर्ण कुंजी की तुलना में कम होती है: 2 समानांतर अनुरोध और प्रति मिनट 60 अनुरोध। एक पूर्ण कुंजी 8 समानांतर अनुरोधों और प्रति मिनट 300 अनुरोधों की अनुमति देती है। एकल पर्सोना के लिए परीक्षण करने के लिए यह पर्याप्त है। यदि आप टेस्ट स्क्रिप्ट से एक साथ कई चैट चलाते हैं, तो आप HTTP 429 देखेंगे जिसमें त्रुटि कोड concurrency या rate_limited होगा। एक स्ट्रीम किए गए अनुरोध में स्ट्रीम समाप्त होने तक उसकी कॉन्करेंसी स्लॉट बनी रहती है, इसलिए ट्रायल कुंजी पर दो खुले स्ट्रीम्स उसे भर देते हैं।

$0.50 से कितना चल सकता है? कीमतें 1M इनपुट टोकन के लिए $0.15 और 1M आउटपुट टोकन के लिए $0.50 हैं। एक सामान्य चैट टर्न लें जिसमें 1,500 टोकन का इतिहास और पर्सोना अंदर जा रहा हो और 300 टोकन बाहर आ रहे हों:

  • इनपुट: 1,500 टोकन x $0.15 / 1,000,000 = $0.000225
  • आउटपुट: 300 टोकन x $0.50 / 1,000,000 = $0.00015
  • एक टर्न: $0.000375
  • $0.50 / $0.000375 लगभग 1,333 टर्न हैं

यह कई कैरेक्टरों को ठीक से परीक्षण करने के लिए पर्याप्त है। विफल या अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता है, इसलिए एक त्रुटि वाला अनुरोध आपका क्रेडिट नहीं खाता। ट्रायल 7 दिनों के बाद समाप्त हो जाता है; आप बाद में जो क्रेडिट खरीदते हैं, वह समाप्त नहीं होता।

सेटिंग्स जो पर्सोना को सही महसूस कराती हैं

एक कुंजी आपको कनेक्शन देती है; एक कैरेक्टर की गुणवत्ता प्रॉम्प्ट और सैम्पलिंग सेटिंग्स से आती है। कुछ आदतें चालाक चालों से ज़्यादा मदद करती हैं।

सिस्टम संदेश को एक छोटे कैरेक्टर शीट के रूप में सादे वाक्यों में लिखें: कैरेक्टर कौन है, वे कैसे बात करते हैं, वे क्या चाहते हैं, और उनके जवाब कितने लंबे होने चाहिए। यदि आवाज़ मायने रखती है तो संवाद की एक या दो उदाहरण पंक्तियाँ दें। मॉडल विशेषणों की तुलना में ठोस उदाहरणों का बेहतर अनुसरण करते हैं, इसलिए "मारा छोटी, सूखी पंक्तियों में जवाब देती है और घबराहट में मज़ाक करती है" जैसी पंक्ति "मारा चतुर और आकर्षक है" से बेहतर काम करती है।

temperature का उपयोग जीवंतता सेट करने के लिए करें। 0.9 के करीब मान अधिक विविध वाक्य रचना देते हैं, जबकि 0.5 के करीब मान कैरेक्टर को अधिक स्थिर रखते हैं। यदि आपकी एप्लिकेशन "User:" जैसे स्पीकर लेबल का उपयोग करती है और आप चाहते हैं कि मॉडल संवाद के दूसरे पक्ष को न लिखे, तो एक stop सीक्वेंस जोड़ें। फ्रीक्वेंसी और प्रेजेंस पेनाल्टी लंबी चैट में दोहराए गए वाक्यों को कम कर सकती हैं, लेकिन इन्हें धीरे-धीरे बढ़ाएँ, क्योंकि उच्च मान संवाद को अजीब बना सकते हैं।

याद रखें कि मॉडल केवल अनुरोध में मौजूद चीज़ें जानता है। यदि कैरेक्टर को 200 संदेश पहले खिलाड़ी के नाम को याद रखना चाहिए, या तो उस संदेश को विंडो में रखें या सिस्टम संदेश में मुख्य तथ्यों को स्टोर करें। यही कारण है कि एक मेमोरी लिस्ट जो आप स्वयं अपडेट करते हैं, वह विशाल इतिहास भेजने से अक्सर बेहतर साबित होती है।

टॉप-अप करना जब मुफ़्त ट्रायल क्रेडिट खत्म हो जाए

कोई सब्सक्रिप्शन नहीं है। आप प्रीपेड करते हैं और टोकन के हिसाब से खर्च करते हैं। टॉप-अप $20 से $500 तक किसी भी पूर्ण राशि पर होते हैं, और बड़ी राशियों पर बोनस मिलता है: $50 से +5%, $100 से +10% और $200 से +15%। इसलिए $50, $52.50 क्रेडिट बन जाता है, $100, $110 बन जाता है, और $200, $230 बन जाता है। आप क्रिप्टो (TRC20 पर USDT, Base पर USDC) से भुगतान कर सकते हैं।

मूल्य निर्धारण पृष्ठ पर पूर्ण तालिका है। योजना बनाने के लिए, 1,500 इनपुट और 300 आउटपुट वाले उसी टर्न का खर्च $0.000375 है, इसलिए $20 लगभग 53,000 ऐसे टर्न कवर करता है। लंबे समय तक चलने वाले रोलप्ले प्रति टर्न अधिक खर्च करते हैं क्योंकि इतिहास बढ़ता है, इसलिए इसे फिर से भेजने की मात्रा को सीमित करें। कॉन्टेक्स्ट विंडो 100,000 टोकन है, प्रॉम्प्ट और कंप्लीशन मिलाकर, लेकिन आप इसे भरना दुर्लभ रूप से चाहेंगे।

एक वास्तविक ऐप में कुंजी को सुरक्षित रखना

चैट प्रोजेक्ट के साथ सबसे आम गलती ब्राउज़र कोड से सीधे API को कॉल करना है। ब्राउज़र में भेजा गया कुछ भी हर विज़िटर द्वारा पढ़ा जा सकता है, जिसमें कुंजी भी शामिल है। अपने फ्रंट एंड और API के बीच एक छोटा सर्वर रखें। ब्राउज़र आपके रूट से बात करता है, आपका रूट Authorization: Bearer हेडर जोड़ता है और अनुरोध आगे बढ़ाता है।

  • कुंजी को रिपॉज़िटरी में नहीं, बल्कि एक एनवायरनमेंट वेरिएबल या सीक्रेट्स मैनेजर में स्टोर करें।
  • अपने पहले कमिट से पहले .env एंट्री .gitignore में जोड़ें।
  • प्रत्येक एनवायरनमेंट के लिए एक अलग कुंजी का उपयोग करें ताकि डेवलपमेंट में लीक होने पर प्रोडक्शन प्रभावित न हो।
  • रनअवे लूप्स को जल्दी पकड़ने के लिए X-Balance-USD हेडर की निगरानी करें।
  • HTTP 429 पर थोड़ी देर रुककर दोबारा कोशिश करें। एक अस्थायी ओवरलोड रिस्पॉन्स में Retry-After: 5 शामिल होता है।

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

प्रश्न और उत्तर

क्या मुझे Character.ai API कुंजी मिलती है?

नहीं। यह एक अलग, स्वतंत्र सेवा है। आपको एक OpenAI-संगत एंडपॉइंट के लिए एक कुंजी मिलती है जिसका मॉडल ID uncensored है, जिसे आप अपने खुद के कैरेक्टर ऐप्स के लिए बैकएंड के रूप में उपयोग कर सकते हैं।

क्या कुंजी पाने के लिए कार्ड की आवश्यकता है?

नहीं। आप Google या ईमेल और पासवर्ड से साइन इन करते हैं, फिर API कुंजी पृष्ठ पर एक क्लिक से $0.50 का ट्रायल क्रेडिट प्राप्त करते हैं। ट्रायल 7 दिनों के लिए मान्य है।

क्या मैं SillyTavern या अन्य चैट फ्रंट एंड में कुंजी का उपयोग कर सकता हूँ?

जो कस्टम OpenAI-संगत एंडपॉइंट स्वीकार करते हैं, वे उसे उपयोग कर सकते हैं। बेस URL, अपनी कुंजी और मॉडल नाम uncensored दर्ज करें।

रेट लिमिट पर पहुँचने पर क्या होता है?

API HTTP 429 कोड rate_limited या concurrency के साथ लौटाता है। कुछ क्षण प्रतीक्षा करें और पुनः प्रयास करें। एक ट्रायल कुंजी 2 समानांतर अनुरोध और प्रति मिनट 60 की अनुमति देती है।

क्या क्रेडिट खत्म होता है?

खरीदा गया क्रेडिट कभी समाप्त नहीं होता। केवल $0.50 का ट्रायल क्रेडिट 7 दिनों की वैधता अवधि होती है।

आपकी कुंजी बस एक फ़ॉर्म दूर है

एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।

API कुंजी पाएँ