OpenAI-संगत API कुंजी: एक प्राप्त करें और कॉल भेजें
एक OpenAI संगत API कुंजी एक सामान्य bearer टोकन है जो किसी भी OpenAI SDK के साथ काम करता है, एक बार जब आप क्लाइंट को एक अलग बेस URL पर निर्देशित कर देते हैं। यह पेज दिखाता है कि इस साइट पर होस्टेड टेक्स्ट API के लिए एक कैसे प्राप्त करें और कुछ मिनटों में एक काम करने वाला कॉल बनाएं।
अपडेटेडSpeech To Text API

कुंजी वास्तव में क्या है
"OpenAI compatible" HTTP API के आकार का वर्णन करता है, इसके पीछे कंपनी का नहीं। सेवा POST /v1/chat/completions पर समान JSON बॉडी स्वीकार करती है जो OpenAI SDKs भेजते हैं, और यह समान Authorization: Bearer हेडर पढ़ती है। उसी कारण से, इस सेवा से एक कुंजी किसी भी टूल में फिट हो जाती है जो आपको एक कस्टम बेस URL और API कुंजी सेट करने की अनुमति देता है: आधिकारिक Python और Node लाइब्रेरी, LangChain, साधारण curl, और अधिकांश डेस्कटॉप चैट क्लाइंट।
कुंजी एक OpenAI कुंजी नहीं है, और यह api.openai.com पर काम नहीं करेगी। इसके विपरीत भी सच है: एक OpenAI कुंजी यहाँ काम नहीं करेगी। प्रत्येक कुंजी एक सेवा से संबंधित है, और यह एक ओपन-वेट मॉडल चलाती है, कानूनी वयस्कों के उपयोग के लिए बिना सामग्री अस्वीकृति के उत्तर देने के लिए ट्यून्ड, एक स्वतंत्र प्रदाता द्वारा होस्ट की गई। यह किसी मॉडल विक्रेता की आधिकारिक API नहीं है और यह अन्य विक्रेताओं की ओर रूट नहीं करती।
आपको याद रखने की आवश्यकता है। इस साइट के लिए बेस URL है https://api.speechtotextapis.com/v1। मॉडल ID है uncensored। कुंजी वह स्ट्रिंग है जो आप साइन इन करने के बाद प्राप्त करते हैं। नीचे दिया गया सब कुछ उन तीन मानों का एक विविध है।
सेवा केवल टेक्स्ट है। यह चैट कंप्लीशन्स, स्ट्रीमिंग, फ़ंक्शन कॉलिंग और JSON मोड को संभालता है। यह छवियाँ या ऑडियो उत्पन्न नहीं करता, यह एम्बेडिंग्स नहीं देता, और यह मॉडल को फाइन-ट्यून नहीं करता। यदि आप एक स्पीच पाइपलाइन से यहाँ आए हैं, तो सामान्य कार्य ट्रांसक्रिप्शन के बाद टेक्स्ट स्टेप है: एक ट्रांसक्रिप्ट को साफ़ करना, इसे दृश्यों में विभाजित करना, संवाद को फिर से लिखना, या संरचित डेटा निकालना। वॉयस स्क्रिप्ट प्रोसेसिंग गाइड उस पक्ष को अधिक विस्तार से कवर करता है।
चार चरणों में अपनी कुंजी प्राप्त करें
- साइन अप करें। Google का उपयोग करें, या एक ईमेल पता और पासवर्ड के साथ रजिस्टर करें।
- API कुंजी पेज खोलें। यह इस साइट पर कुंजी पेज पर रहता है। आपकी कुंजी वहाँ बनाई और दिखाई जाती है।
- ट्रायल क्रेडिट दावा करें। उसी पेज पर एक बटन आपको एक क्लिक से $0.50 का ट्रायल क्रेडिट देता है। यह प्रति व्यक्ति एक है, 7 दिनों के लिए मान्य है, और इसे किसी कार्ड की आवश्यकता नहीं है।
- कुंजी को एक सीक्रेट स्टोर में कॉपी करें। एक लोकल टेस्ट के लिए एक एनवायरनमेंट वेरिएबल पर्याप्त है। किसी भी डिप्लॉयमेंट के लिए, अपने होस्ट के सीक्रेट मैनेजर का उपयोग करें।
ट्रायल इस बात को साबित करने के लिए है कि इंटीग्रेशन काम करता है, इससे पहले कि आप कुछ भी भुगतान करें। वर्तमान कीमत पर, यह कई छोटे अनुरोधों के लिए पर्याप्त है, और नीचे दी गई लागत अनुभाग अंकगणित दिखाता है। जब आप आगे बढ़ने के लिए तैयार हों, तो मूल्य निर्धारण पेज टॉप-अप राशियाँ सूचीबद्ध करता है। क्रेडिट प्रीपेड है, कोई सब्सक्रिप्शन नहीं है, और क्रेडिट कभी नहीं समाप्त होता, इसलिए किसी भी टॉप-अप को किसी डेडलाइन से पहले खर्च करने का कोई दबाव नहीं है।
ट्रायल कुंजियाँ पूर्ण कुंजियों की तुलना में अधिक कठोरता से सीमित हैं: 2 समानांतर अनुरोध और प्रति मिनट 60 अनुरोध। यह एक पहली स्क्रिप्ट के लिए पर्याप्त है। यदि आप कई ट्रांसक्रिप्ट चंक को समानांतर में फैलाने की योजना बनाते हैं, तो एक फंडेड खाते में जाने तक रेट लिमिट तक पहुँचने की उम्मीद करें।
हर क्लाइंट द्वारा माँगे जाने वाले तीन सेटिंग्स
कोई भी सॉफ्टवेयर जो आप उपयोग करते हैं, सेटअप स्क्रीन समान तीन चीज़ें थोड़े अलग नामों के तहत पूछती है।
| सेटिंग | सामान्य फ़ील्ड नाम | मान |
|---|---|---|
| एंडपॉइंट | बेस URL, API बेस, होस्ट | https://api.speechtotextapis.com/v1 |
| क्रेडेंशियल | API कुंजी, टोकन, सीक्रेट | आपकी कुंजी कुंजी पेज से |
| मॉडल | मॉडल, मॉडल नाम, इंजन | uncensored |
एक विवरण लोगों को उलझाता है: बेस URL पहले से ही /v1 पर समाप्त होता है। SDKs स्वयं /chat/completions जोड़ते हैं, इसलिए आपको इसे जोड़ने की आवश्यकता नहीं है। यदि आपका क्लाइंट बेस URL के बजाय चैट एंडपॉइंट का पूर्ण URL पूछता है, तो मान है https://api.speechtotextapis.com/v1/chat/completions।
यदि कोई टूल केवल एक "OpenAI" प्रीसेट प्रदान करता है जिसमें एक हार्ड-कोडेड होस्ट होता है और उसे संपादित करने का कोई तरीका नहीं है, तो वह इस सेवा से बात नहीं कर सकता। बेस URL फ़ील्ड को एक्सपोज़ करने वाले "कस्टम", "OpenAI-compatible" या "एडवांस्ड" विकल्प की खोज करें।
आपका पहला अनुरोध
curl से शुरू करें, क्योंकि यह आपको और API के बीच हर परत हटा देता है। YOUR_KEY को उस कुंजी से बदलें जिसे आपने कॉपी किया है।
curl https://api.speechtotextapis.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"}
]
}'
एक सफल प्रतिक्रिया एक JSON ऑब्जेक्ट है जिसमें choices सरणी है। टेक्स्ट choices[0].message.content में है, और एक usage ब्लॉक टोकन रिपोर्ट करता है जिनके लिए आपको चार्ज किया गया था।
आधिकारिक Python लाइब्रेरी के साथ वही कॉल इस प्रकार दिखती है। केवल base_url और api_key एक स्टॉक OpenAI सेटअप से अलग हैं।
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.speechtotextapis.com/v1",
api_key=os.environ["API_KEY"],
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You clean up raw transcripts. Keep the meaning, fix punctuation."},
{"role": "user", "content": "so um we shipped the the beta on tuesday and uh nobody complained"},
],
)
print(resp.choices[0].message.content)
और Node में, उसी पैकेज का उपयोग करते हुए:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.speechtotextapis.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "user", content: "Rewrite this in plain English: the beta shipped on Tuesday." },
],
});
console.log(resp.choices[0].message.content);
आपको max_tokens सेट करने की आवश्यकता नहीं है। जब इसे छोड़ दिया जाता है, तो पूर्णता आपके प्रॉम्प्ट के बाद 100,000-टोकन विंडो में बची हुई किसी भी चीज़ का उपयोग कर सकती है। यदि आप प्रत्येक कॉल पर लागत के लिए कठोर छत चाहते हैं, तो इसे स्वयं सेट करें।
जांचें कि कुंजी टोकन खर्च किए बिना काम करती है
एक कुंजी को बड़े सिस्टम में जोड़ने से पहले, मॉडल एंडपॉइंट पर एक सस्ता कॉल करें। यह पुष्टि करता है कि कुंजी स्वीकार की गई है और बेस URL सही है।
curl -i https://api.speechtotextapis.com/v1/models \
-H "Authorization: Bearer YOUR_KEY"
-i फ़्लैग प्रतिक्रिया हेडर प्रिंट करता है, जहाँ यह API उपयोगी स्थिति रिपोर्ट करता है:
X-Request-Idअनुरोध की पहचान करता है। यदि आप किसी विशिष्ट कॉल के बारे में सहायता से संपर्क करते हैं, तो इसे शामिल करें।X-Balance-USDखाते पर शेष क्रेडिट दिखाता है।X-RateLimit-Limit-RequestsऔरX-RateLimit-Limit-Concurrencyआपके कुंजी पर लागू सीमाएँ दिखाते हैं, ताकि आप एक नज़र में बता सकें कि क्या कुंजी में ट्रायल या पूर्ण सीमाएँ हैं।
अपने स्वयं के कोड में X-Balance-USD पढ़ना क्रेडिट खत्म होने से पहले स्वयं को सचेत करने का एक सस्ता तरीका है। यदि आप शोर वाली आउटपुट नहीं चाहते हैं, तो प्रत्येक अनुरोध के बजाय प्रत्येक कार्य के लिए एक बार इसे लॉग करें।
एक कुंजी का उपयोग करने की लागत
एक कुंजी रखने का कोई खर्च नहीं है। आप टोकन के लिए भुगतान करते हैं: $0.15 प्रति 1M इनपुट टोकन और $0.50 प्रति 1M आउटपुट टोकन, जो प्रीपेड क्रेडिट से काटे जाते हैं। विफल या अस्वीकृत अनुरोधों के लिए चार्ज नहीं किया जाता है।
ऊपर दिए गए ट्रांसक्रिप्ट क्लीनअप कॉल के साथ एक कार्य उदाहरण। मान लीजिए कि एक प्रॉम्प्ट 1,000 टोकन है और क्लीन की गई प्रतिक्रिया 500 टोकन है।
- इनपुट: 1,000 / 1,000,000 x $0.15 = $0.00015
- आउटपुट: 500 / 1,000,000 × $0.50 = $0.00025
- कुल: कॉल प्रति $0.0004
$0.50 ट्रायल इस आकार की लगभग 1,250 कॉल को कवर करता है ($0.50 / $0.0004)। आपकी अपनी संख्याएँ अलग होंगी, क्योंकि ट्रांसक्रिप्ट की लंबाई भिन्न होती है, लेकिन विधि वही है: इनपुट टोकन गिनें, आउटपुट टोकन गिनें, गुणा करें।
जब आप टॉप-अप करते हैं, तो $20 से $500 तक कोई भी पूर्ण राशि स्वीकार की जाती है। बड़े टॉप-अप एक बोनस लाते हैं: $50 से +5%, $100 से +10% और $200 से +15%। उदाहरण के लिए, $100 का टॉप-अप आपको $110 का क्रेडिट देता है। आप क्रिप्टो (TRC20 पर USDT, Base पर USDC) से भुगतान कर सकते हैं।
कुंजी को सुरक्षित रखना
एक API कुंजी आपके बैलेंस के लिए एक पासवर्ड है। जिसके पास वह है, वह आपका क्रेडिट खर्च कर सकता है, इसलिए इसे उसी तरह मानें।
- इसे स्रोत नियंत्रण से बाहर रखें। इसे एक एनवायरनमेंट वेरिएबल या सीक्रेट मैनेजर से पढ़ें।
- इसे ब्राउज़र JavaScript या मोबाइल ऐप बंडल में शिप न करें। जो कुछ भी यूजर के डिवाइस पर चलता है, उसे इन्स्पेक्ट किया जा सकता है। अपने फ्रंट एंड और API के बीच एक छोटा सर्वर रखें और सर्वर को हेडर जोड़ने दें।
- इसे स्क्रीनशॉट, टिकट या चैट संदेशों में पेस्ट न करें।
- यदि आपको लगता है कि एक कुंजी लीक हो गई है, तो प्रतीक्षा करने के बजाय कि कुछ होता है या नहीं, तुरंत इसे उपयोग करना बंद करें और सपोर्ट से संपर्क करें।
गोपनीयता पर: API को भेजे गए प्रॉम्प्ट प्रशिक्षण के लिए उपयोग नहीं किए जाते हैं। यह सेवा के बारे में एक बयान है, यह कारण नहीं है कि आपको वे सीक्रेट भेजें जिनकी आपको आवश्यकता नहीं है। जब कार्य के लिए आवश्यक न हो, तो ट्रांसक्रिप्ट से व्यक्तिगत डेटा हटा दें।
जब कॉल विफल हो जाती है
पहले दिन की अधिकांश समस्याएँ चार कारणों में से किसी एक से आती हैं।
बेस URL गलत है
दो आम गलतियाँ एक गायब /v1 और एक दोहराया गया /chat/completions हैं। अपने मान की तुलना ऊपर दी गई तालिका के साथ अक्षर-दर-अक्षर करें।
कुंजी में एक अतिरिक्त अक्षर है
पेज से कॉपी करने से अक्सर एक ट्रेलिंग स्पेस या नई लाइन भी आ जाती है। अपने कोड में मान को ट्रिम करें और जांचें कि हेडर Bearer पढ़ता है, एक स्पेस के साथ, फिर कुंजी।
मॉडल का नाम uncensored नहीं है
क्लाइंट अक्सर किसी अन्य मॉडल नाम पर डिफ़ॉल्ट हो जाते हैं। हर कॉल पर मॉडल को स्पष्ट रूप से सेट करें।
HTTP 429
दो प्रकार हैं, और एरर कोड उन्हें अलग करता है। rate_limited का अर्थ है कि आपने प्रति मिनट बहुत सारे अनुरोध भेजे हैं। concurrency का अर्थ है कि एक साथ बहुत सारे चल रहे थे। एक स्ट्रीम किए गए अनुरोध में कॉन्करेंसी स्लॉट स्ट्रीम समाप्त होने तक बना रहता है, इसलिए एक धीमी रीडर कम अनुरोध दर पर भी इस त्रुटि का कारण बन सकता है। Retry-After: 5 हेडर के साथ 429 का अर्थ है कि सेवा अस्थायी रूप से ओवरलोड है; पाँच सेकंड प्रतीक्षा करें और पुनः प्रयास करें। आपके क्लाइंट में एक छोटा एक्सपोनेंशियल बैकऑफ़ तीनों मामलों को संभाल लेता है।
पूर्ण पैरामीटर सूची, स्ट्रीमिंग प्रारूप और टूल कॉलिंग विवरण के लिए, API दस्तावेज़ीकरण देखें।
अधिक गाइड
प्रश्न और उत्तर
क्या यह एक OpenAI कुंजी के समान है?
नहीं। यह उसी अनुरोध फ़ॉर्मेट का पालन करता है, इसलिए OpenAI SDK इससे काम करते हैं, लेकिन इसे इस सेवा द्वारा जारी किया गया है और यह केवल इस सेवा के बेस URL के खिलाफ काम करता है।
क्या कुंजी प्राप्त करने के लिए मुझे क्रेडिट कार्ड की आवश्यकता है?
नहीं। Google या ईमेल के साथ साइन अप करें, फिर कुंजी पेज पर एक क्लिक के साथ $0.50 का ट्रायल क्रेडिट क्लेम करें। ट्रायल के लिए कार्ड की आवश्यकता नहीं है और यह 7 दिनों के लिए मान्य है।
मुझे किस मॉडल नाम का उपयोग करना चाहिए?
मॉडल फ़ील्ड में uncensored का उपयोग करें। GET /v1/models के लिए एक कॉल सूची करेगा कि कुंजी किस तक पहुँच सकती है।
क्या मैं एक ही कुंजी का उपयोग कई सर्वरों पर कर सकता हूँ?
हाँ, लेकिन सीमाएँ कुंजी के रूप में पूरी तरह से लागू होती हैं: एक पूर्ण कुंजी के लिए 8 सहसंचालित अनुरोध और प्रति मिनट 300 अनुरोध, और एक ट्रायल कुंजी के लिए 2 और 60।
क्या कुंजी छवियों या वॉइस के लिए काम करती है?
नहीं। API केवल टेक्स्ट के लिए है। यह ऑडियो या छवियाँ जनरेट या ट्रांसक्राइब नहीं करता है, और इसमें एम्बेडिंग्स या फाइन-ट्यूनिंग नहीं है।
आपकी कुंजी बस एक फ़ॉर्म दूर है
एक खाता बनाएँ, कुंजी कॉपी करें, बेस URL बदलें। सेटअप यही है।