Acestep पाइपलाइन्स के लिए क्विकस्टार्ट

पूर्वशर्त: अपनी API कुंजी प्राप्त करें

अनुरोध करने से पहले, आपको एक वैध API कुंजी की आवश्यकता है। acestep.cc पर Get API key पृष्ठ पर जाएं। आप Continue with Google का उपयोग करके या ईमेल और पासवर्ड खाता बनाकर साइन अप कर सकते हैं। फ़ोन नंबर की आवश्यकता नहीं है। पंजीकरण के बाद, आपकी API कुंजी तुरंत प्रदर्शित होती है। इस कुंजी को कॉपी करें; आप इसका उपयोग सभी बाद के अनुरोधों के लिए प्रमाणीकरण के लिए करेंगे। यदि आपके पास क्रेडिट नहीं है, तो आपको टॉप-अप करना होगा। हम $10 और $500 के बीच की राशि के लिए केवल क्रिप्टो भुगतान (TRC20 पर USDT या Base पर USDC) स्वीकार करते हैं। नए खातों को $0.50 का मुफ़्त ट्रायल क्रेडिट मिलता है जो 7 दिनों के लिए मान्य होता है, शुरू करने के लिए कार्ड की आवश्यकता नहीं होती है। अपनी कुंजी को सुरक्षित रखें, क्योंकि यह रेट लिमिट और टोकन खपत के खिलाफ आपके उपयोग की प्रमाणीकरण करती है।

स्थापना

API मानक OpenAI-संगत प्रोटोकॉल का उपयोग करता है। आप इसे अपनी पसंदीदा भाषा के आधिकारिक OpenAI SDKs या किसी भी HTTP क्लाइंट का उपयोग करके संपर्क कर सकते हैं। Python के लिए, openai पैकेज इंस्टॉल करें। Node.js के लिए, openai इंस्टॉल करें। सुनिश्चित करें कि आप एक हालिया SDK संस्करण का उपयोग कर रहे हैं जो कस्टम बेस URLs का समर्थन करता है। हमारे सेवा के लिए बेस URL https://api.acestep.cc/v1 है। यह आपको मौजूदा पाइपलाइन कोड को पुन: उपयोग करने की अनुमति देता है जो OpenAI एंडपॉइंट की उम्मीद करता है, बस बेस URL और API कुंजी को बदलकर। आपके अनुरोधों में जो मॉडल ID निर्दिष्ट करने की आवश्यकता है वह uncensored है। यह मॉडल एक ओपन-वेट मॉडल है जो कानूनी वयस्क, काल्पनिक या विवादास्पद विषयों पर न्यूनतम अस्वीकार्यताओं के लिए ट्यून्ड है, जिससे यह उन रचनात्मक पाइपलाइनों के लिए आदर्श है जहां सामग्री फ़िल्टर वैध रचनात्मक आउटपुट को अवरुद्ध कर सकते हैं।

मूलभूत अनुरोध: टेक्स्ट जनरेट करें

अपने सिस्टम प्रॉम्प्ट और उपयोगकर्ता संदेशों के साथ /v1/chat/completions पर एक POST अनुरोध भेजें। मॉडल जनरेटेड टेक्स्ट लौटाएगा। सुनिश्चित करें कि आप model पैरामीटर को uncensored पर सेट करें। आप temperature और top_p के साथ रचनात्मकता को नियंत्रित कर सकते हैं। कॉन्टेक्स्ट विंडो कुल 100,000 टोकन (प्रॉम्प्ट + पूर्णता) का समर्थन करती है। प्रति अनुरोध अधिकतम आउटपुट 32,000 टोकन है, या 2,048 यदि आप max_tokens निर्दिष्ट नहीं करते हैं। त्रुटियां और अस्वीकृतियां क्रेडिट खपत नहीं करती हैं, लेकिन सफल टोकन जनरेशन करती है। स्क्रिप्ट जनरेट करने, कैप्शन बनाने, या अन्य मॉडेलिटीज जैसे स्पीच या इमेज जनरेशन APIs को पास करने से पहले टेक्स्ट डेटा प्रोसेस करने के लिए इस एंडपॉइंट का उपयोग करें।

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

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

फ़ंक्शन कॉलिंग

API फ़ंक्शन कॉलिंग का समर्थन करता है, जिससे मॉडल आपके परिभाषित टूल्स के आधार पर संरचित डेटा आउटपुट कर सकता है। अपने फ़ंक्शंस को tools पैरामीटर में परिभाषित करें। tool_choice को auto या एक विशिष्ट फ़ंक्शन नाम पर सेट करें। यदि उपयुक्त हो, तो मॉडल एक फ़ंक्शन कॉल ऑब्जेक्ट के साथ प्रतिक्रिया देगा। यह टेक्स्ट से संरचित डेटा निकालने या डाउनस्ट्रीम API कॉल्स के लिए इनपुट तैयार करने के लिए मूल्यवान है। आप response_format को {"type": "json_object"} पर सेट करके JSON आउटपुट को भी लागू कर सकते हैं। यह सुनिश्चित करता है कि मॉडल मान्य JSON लौटाता है, जो आपके स्वचालित पाइपलाइन में विश्वसनीय इंटीग्रेशन के लिए महत्वपूर्ण है। अपने टेक्स्ट प्रोसेसिंग चरणों की विश्वसनीयता को बढ़ाने के लिए इन सुविधाओं का उपयोग करें।

मूल्य निर्धारण और सीमाएं

मूल्य $0.25 प्रति 1M इनपुट टोकन और $1.00 प्रति 1M आउटपुट टोकन है। क्रेडिट प्रीपेड है और कभी समाप्त नहीं होता। त्रुटियां मुफ़्त हैं। रेट लिमिट प्रति कुंजी प्रति मिनट 300 अनुरोध और प्रति कुंजी एक ही समय पर 8 समानांतर अनुरोध हैं। अधिकतम अनुरोध बॉडी साइज 8 MB है। यदि आप रेट लिमिट को पार करते हैं, तो आपको 429 त्रुटि मिलती है। 401 त्रुटि एक अमान्य या समाप्त हो चुकी कुंजी को दर्शाती है। 402 त्रुटि का अर्थ है कि आपके पास अपर्याप्त क्रेडिट है। क्रेडिट के लिए रिफंड जारी नहीं किए जाते हैं; विवाद सपोर्ट पृष्ठ के माध्यम से हैंडल किए जाते हैं। प्रति खाता एक सक्रिय कुंजी की अनुमति है; एक नई कुंजी जनरेट करने से पुरानी कुंजी बदल जाती है। अपनी पाइपलाइन के पुनःप्रयास तर्क को डिज़ाइन करते समय इन सीमाओं को ध्यान में रखें।

cURL

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

Python

Copyfrom openai import OpenAI

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

स्ट्रीमिंग

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)