API क्विकस्टार्ट और इंटीग्रेशन

बेस URL और प्रमाणीकरण

Heretic प्रोजेक्ट टेक्स्ट जनरेशन के लिए एकल, होस्टेड एंडपॉइंट प्रदान करता है। उपयोग करें https://api.hereticproject.com/v1 अपने बेस URL के रूप में। प्रमाणीकरण एक बियरर टोकन पर निर्भर करता है जो Authorization हेडर। Google या ईमेल से साइन इन करके डैशबोर्ड पर अपनी कुंजी बनाएं। सिस्टम प्रति खाता एक सक्रिय कुंजी जारी करता है; एक नई कुंजी जनरेट करने से पिछली कुंजी तुरंत अमान्य हो जाती है।

आपकेवल उपभुक्त टोकन के लिए भुगतान करते हैं। त्रुटियां और अस्वीकृतियां आपके प्रीपेड क्रेडिट पर चार्ज नहीं करतीं। एक नए खाते को सात दिनों के लिए मान्य $0.50 की ट्रायल क्रेडिट मिलती है। आप USDT (TRC20) या USDC (Base) का उपयोग करके $20 और $500 के बीच की राशि में टॉप अप करते हैं।

/v1/chat/completions एंडपॉइंट

मानक चैट पूर्णता एंडपॉइंट पर संदेश भेजें। मॉडल ID है uncensored. यह भूमिकाओं जैसे के साथ संदेश ऑब्जेक्ट्स की एक सूची स्वीकार करता है system, user, या assistant. मॉडल कानूनी वयस्क, काल्पनिक या विवादास्पद विषयों को अस्वीकार नहीं करता है। यह एक ओपन-वेइट मॉडल है जो सीधे उत्तरों के लिए ट्यून किया गया है।

अनुरोध उत्पन्न टेक्स्ट युक्त JSON ऑब्जेक्ट लौटाते हैं। संदर्भ विंडो प्रॉम्प्ट और पूर्णता के लिए संयुक्त 100,000 टोकन का समर्थन करती है। आउटपुट प्रति अनुरोध 16,000 टोकन तक सीमित है जब तक कि आप कम न निर्दिष्ट करें max_tokens मान।

Copycurl https://api.hereticproject.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list dependencies for node project"}]
  }'

Python SDK इंटीग्रेशन

कस्टम बेस URL के साथ आधिकारिक OpenAI Python लाइब्रेरी का उपयोग करें। सेट करें api_key अपने API स्ट्रिंग में। कॉन्फ़िगर करें base_url Heretic Project सर्वर के लिए इंगित करें। यह आपको परिचित विधियों जैसे chat.completions.create() अपने मौजूदा कोड स्ट्रक्चर को महत्वपूर्ण रूप से संशोधित किए बिना।

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

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.hereticproject.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 SDK एकीकरण

Node.js SDK Python वर्जन के समान ही काम करता है। अपनी API कुंजी और सही बेस URL के साथ क्लाइंट इनिशियलाइज़ करें। आप समान विधि हस्ताक्षरों का उपयोग करके समाप्ति अनुरोध भेज सकते हैं। यह आपके स्टैक के विभिन्न हिस्सों में स्थिरता सुनिश्चित करता है।

प्रतिक्रियाओं को एसेंक्रोनस रूप से हैंडल करें। यदि आप स्ट्रीमिंग विधि का उपयोग करते हैं, तो SDK डेटा स्ट्रीम करता है। अन्यथा, यह पूर्ण JSON प्रतिक्रिया लौटाता है। यह लचीलापन बैच प्रसंस्करण और रियल-टाइम इंटरफेस दोनों का समर्थन करता है। अपनी API कुंजी को एनवायरनमेंट वेरिएबल्स में सुरक्षित रखें।

Copyimport OpenAI from "openai";

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

स्ट्रीमिंग रिस्पॉन्सेस (SSE)

सेटिंग करके स्ट्रीमिंग सक्षम करें stream: true आपके अनुरोध में। सर्वर Server-Sent Events (SSE) भेजता है। प्रत्येक chunk में आंशिक पाठ अपडेट होते हैं। यह अंत-उपयोगकर्ताओं के लिए अनुभवजन्य विलंबता को कम करता है। टोकन उपयोग डेटा स्ट्रीम के अंतिम chunk में दिखाई देता है।

प्रत्येक डेल्टा ऑब्जेक्ट को पूरे उत्तर को जमा करने के लिए प्रक्रिया करें। जब स्ट्रीम बंद हो जाए या कोई त्रुटि हो तो सुनना बंद कर दें। यह विधि चैट इंटरफेस के लिए आदर्श है। यह उपयोगकर्ताओं को रियल-टाइम में विचारों को बनते हुए देखने की अनुमति देता है। ओवरहेड पूर्ण प्रतिक्रियाओं की तुलना में नगण्य है।

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)

सीमाएं, त्रुटियां, और संदर्भ

सेवा व्यवधान से बचने के लिए दर सीमाओं का सम्मान करें। आपको प्रति कुंजी प्रति मिनट 300 अनुरोध की अनुमति है। समवर्तिता 8 एक साथ अनुरोधों तक सीमित है। अनुरोध बॉडी 8 MB से अधिक नहीं हो सकती। इन सीमाओं को पार करने पर 429 स्टेटस कोड लौटाया जाता है। पुनः प्रयास करने से पहले थोड़ी प्रतीक्षा करें।

प्रमाणीकरण विफलताएं 401 त्रुटि लौटाती हैं। यह तब होता है यदि कुंजी अमान्य या समाप्त है। 402 त्रुटि अपर्याप्त पूर्व-भुगतान क्रेडिट को इंगित करती है। भुगतान की गलतियों को सहायता पृष्ठ के माध्यम से संभाला जाता है। क्रेडिट कभी समाप्त नहीं होता है। मॉडल किशोरों से संबंधित सामग्री को अस्वीकार करता है। अन्य सभी कानूनी सामग्री स्वीकार की जाती है।