कस्टम एंडपॉइंट और Base URL

Custom API endpoint: OpenAI-compatible API कैसे जोड़ें

कस्टम API एंडपॉइंट और Base URL क्या होते हैं, और सिर्फ़ एक पते और एक key से OpenAI-compatible API, रिले, प्रॉक्सी या गेटवे कैसे जोड़ें।

अपडेट
  • कस्टम API एंडपॉइंट (custom API endpoint) किसी ऐसी AI सर्विस का वेब पता, यानी Base URL, होता है जो आपके ऐप में पहले से नहीं जुड़ी, जैसे कोई OpenAI-compatible API, रिले, प्रॉक्सी या गेटवे। Oriveo में इसे जोड़ने के लिए आम तौर पर दो चीज़ें चाहिए: वह पता और एक API key।
  • Oriveo प्रोटोकॉल ख़ुद पहचान लेता है (OpenAI Chat Completions, OpenAI Responses, Anthropic Messages या Gemini), और आप सिर्फ़ मूल पता डालें तो /v1 जैसा वर्ज़न पाथ ख़ुद जोड़ देता है।
  • सार्वजनिक पतों पर HTTPS ज़रूरी है। थर्ड-पार्टी सर्विस अपने से होकर जाने वाली हर चीज़ देख सकती है, इसलिए उसे खर्च-सीमा वाली अलग key दें, और अपने आधिकारिक प्रोवाइडर की key उसे कभी न दें।
iPhone पर Oriveo: प्रोवाइडर स्क्रीन, जहाँ आपके जोड़े हुए प्रोवाइडर और इस महीने का खर्च दिखता है।

Base URL या API endpoint क्या है?

हर AI सर्विस का एक वेब पता होता है, जिस पर ऐप रिक्वेस्ट भेजते हैं। डेवलपर इसे Base URL, API endpoint या request URL कहते हैं; यहाँ तीनों का मतलब एक ही है। यह आम वेब पते जैसा दिखता है। जैसे, OpenAI का पता https://api.openai.com/v1 है।

Oriveo में 15 बिल्ट-इन प्रोवाइडरों के पते पहले से भरे होते हैं, इसलिए वहाँ बस key पेस्ट करनी होती है। कस्टम एंडपॉइंट बाक़ी सब के लिए है: कोई सर्विस जो OpenAI-compatible API देती है, किसी कंपनी का चलाया रिले या गेटवे, या आपके अपने सर्वर पर चलने वाला गेटवे।

"OpenAI-compatible" का मतलब है कि सर्विस उसी फ़ॉर्मैट में रिक्वेस्ट लेती है जिसमें OpenAI का API लेता है, इसलिए OpenAI के लिए बने ऐप उससे बात कर पाते हैं। कई प्रोवाइडर और गेटवे यह फ़ॉर्मैट देते हैं।

रिले, प्रॉक्सी, गेटवे: इनमें क्या फ़र्क़ है?

लोग ये शब्द ढीले-ढाले ढंग से इस्तेमाल करते हैं, और किसी ऐप को जोड़ने के लिहाज़ से तीनों एक जैसे काम करते हैं: एक सर्विस आपके ऐप और मॉडल प्रोवाइडरों के बीच बैठती है, आपकी रिक्वेस्ट लेती है और आगे भेज देती है। कुछ सर्विसें कई प्रोवाइडरों को एक key और एक बिल के पीछे रखती हैं; कुछ टीम के लिए इस्तेमाल पर कंट्रोल जोड़ती हैं; कुछ ऐसे सॉफ़्टवेयर हैं जिन्हें आप अपने सर्वर पर चलाते हैं।

Oriveo इनमें से किसी की सिफ़ारिश या रैंकिंग नहीं करता। आप जो भी इस्तेमाल करें, नीचे के कदम वही रहते हैं।

कस्टम एंडपॉइंट जोड़ने के लिए क्या चाहिए?

आम तौर पर दो चीज़ें, दोनों सर्विस के अपने डैशबोर्ड या दस्तावेज़ों से:

  • अनुरोध URL (Base URL), जैसे https://api.example.com/v1 वाला पता। अगर सर्विस सार्वजनिक इंटरनेट पर है, तो पता https:// से शुरू होना चाहिए।
  • वह API key जो सर्विस ने आपको दी है। "एक और कुंजी जोड़ें" से और key भी जोड़ी जा सकती हैं।
  • वैकल्पिक: कनेक्शन का एक नाम, ताकि उसे दूसरों से अलग पहचाना जा सके।

Oriveo में कस्टम एंडपॉइंट कैसे जोड़ें?

iPhone, Android और वेब पर कदम एक जैसे हैं।

  • प्रोवाइडर खोलें और + बटन (प्रोवाइडर जोड़ें) दबाएँ।
  • कस्टम चिप चुनें, फिर कस्टम रिले ("अपनी मॉडल सेवा से कनेक्ट करें")।
  • "कस्टम रिले कनेक्ट करें" पेज पर अनुरोध URL और API key पेस्ट करें। "अनुरोध यहाँ जाएगा: …" वाली लाइन वह पूरा पता दिखाती है जिसे Oriveo इस्तेमाल करेगा। अगला दबाएँ।
  • Oriveo कनेक्शन जाँचता है, मॉडल सूची पढ़ता है और हर मॉडल का प्रोटोकॉल तय करता है। इस कदम में सिर्फ़ सूची पढ़ी जाती है, कोई चैट संदेश नहीं भेजा जाता।
  • जो मॉडल चाहिए उन पर टिक करें और "सहेजें (N चुने गए)" दबाएँ। अगर सर्विस अपने मॉडलों की सूची नहीं देती, तो "मॉडल ID मैन्युअल रूप से जोड़ें" इस्तेमाल करें।
  • सेव करने से पहले Oriveo, चुने गए पहले मॉडल को एक छोटी-सी रिक्वेस्ट भेजता है। यह टेस्ट पास होने पर कनेक्शन सेव होता है; फ़ेल हो, तो आप उसी कदम पर रहते हैं और उसे ठीक कर सकते हैं।
iPhone पर Oriveo की प्रोवाइडर स्क्रीन: ऊपर दाईं ओर + बटन और जुड़े हुए प्रोवाइडरों की सूची
प्रोवाइडर स्क्रीन पर + दबाएँ और कस्टम चुनें, ताकि बिल्ट-इन प्रोवाइडरों के साथ आपका एंडपॉइंट भी जुड़ जाए।

सब कुछ ख़ुद सेट करना है? मैन्युअल सेटअप इस्तेमाल करें

मैन्युअल सेटअप में सब कुछ एक ही पेज पर होता है: पता, key, एक मॉडल ID, कनेक्शन का वैकल्पिक नाम, और डिफ़ॉल्ट प्रोटोकॉल, जो शुरू में ऑटोमैटिक पर रहता है। "सत्यापित करें और सहेजें" दबाएँ। जाँच फ़ेल हो, तो अभी कुछ सेव नहीं होता, और एरर वाले कार्ड पर "फिर भी सहेजें (असत्यापित)" का विकल्प मिलता है, अगर आप कनेक्शन रखकर बाद में टेस्ट करना चाहें।

क्या Oriveo प्रोटोकॉल अपने-आप पहचान लेता है?

ज़्यादातर हाँ। AI सर्विसें गिने-चुने रिक्वेस्ट फ़ॉर्मैट में से किसी एक में बात करती हैं, जिन्हें प्रोटोकॉल कहते हैं। Oriveo चार प्रोटोकॉल सपोर्ट करता है: OpenAI Chat Completions, OpenAI Responses, Anthropic Messages और Gemini generateContent।

यह फ़ैसला मॉडल-दर-मॉडल होता है। जहाँ सर्विस किसी मॉडल के बारे में जानकारी देती है, वहाँ Oriveo उसी का इस्तेमाल करता है; नहीं तो मॉडल के परिवार के हिसाब से संभावित विकल्प चुनता है। सेव करते समय चुने गए पहले मॉडल को असली रिक्वेस्ट से टेस्ट किया जाता है; बाक़ी मॉडल बाद में, जब आप उन्हें इस्तेमाल करना शुरू करते हैं, तब जाँचे जाते हैं।

इसलिए ज़्यादातर मामलों में पता और key काफ़ी हैं। अगर सर्विस के दस्तावेज़ किसी ख़ास प्रोटोकॉल का नाम लेते हैं, या कोई मॉडल जाँच में फ़ेल होता है, तो मैन्युअल सेटअप में प्रोटोकॉल ख़ुद चुनें।

क्या पते में /v1 जोड़ना ज़रूरी है?

आम तौर पर नहीं। अगर आप सिर्फ़ मूल पता डालें, जैसे https://api.example.com, तो Oriveo प्रोटोकॉल के हिसाब से स्टैंडर्ड वर्ज़न पाथ जोड़ देता है: OpenAI और Anthropic फ़ॉर्मैट के लिए /v1, Gemini के लिए /v1beta।

अगर पते में पहले से वर्ज़न है, जैसे /api/paas/v4, तो Oriveo उसे वैसा ही रखता है। अगर आप /chat/completions, /responses, /messages या :generateContent पर ख़त्म होने वाला पूरा एंडपॉइंट पेस्ट करें, तो Oriveo वह आख़िरी हिस्सा हटा देता है और उसी से पहचानता है कि सर्विस कौन-सा प्रोटोकॉल बोलती है।

अगला दबाने से पहले "अनुरोध यहाँ जाएगा: …" वाली लाइन देख लें। अगर जाँच में लिखा आए "हो सकता है पता किसी वेब पेज पर जा रहा हो। देखें कि /v1 छूट तो नहीं गया।", तो अपने पते को सर्विस के दस्तावेज़ों से मिलाएँ।

क्या पते में /v1 जोड़ना ज़रूरी है?
आप डालते हैंOriveo यहाँ रिक्वेस्ट भेजता है (OpenAI फ़ॉर्मैट)
https://api.example.comhttps://api.example.com/v1
https://api.example.com/v1https://api.example.com/v1
https://api.example.com/v1/chat/completionshttps://api.example.com/v1, Chat Completions के साथ
https://api.example.com/api/paas/v4https://api.example.com/api/paas/v4

कौन-से पते चलते हैं?

आपकी key की हिफ़ाज़त के लिए Oriveo कुछ नियम मानता है:

  • सार्वजनिक पते https:// से शुरू होने चाहिए। सार्वजनिक इंटरनेट पर http:// वाला पता न टेस्ट हो सकता है, न सेव।
  • जिन पतों के अंदर यूज़रनेम और पासवर्ड हो, या query parameters हों ("?" के बाद का कुछ भी), वे नहीं लिए जाते। Oriveo कभी query parameters में से API key नहीं आज़माता।
  • आपके घर के नेटवर्क या प्राइवेट VPN पर सादे http:// पते, जैसे आपके अपने कंप्यूटर पर चलता मॉडल सर्वर, कस्टम रिले की जगह अलग लोकल कंप्यूट एंट्री से जुड़ते हैं (iPhone पर इसका नाम "स्थानीय और LAN कंप्यूटिंग" है)।
  • iPhone और Android पर ऐप सीधे उस पते से जुड़ता है।
  • वेब ऐप में सार्वजनिक अनुरोध URL ब्राउज़र की CORS सीमाओं (ब्राउज़र का एक सुरक्षा नियम, जो कई सीधी रिक्वेस्ट रोक देता है) को पार करने के लिए Oriveo के सर्वर से होकर जाते हैं। आपकी API key केवल उसी अनुरोध के दौरान मेमोरी में रहती है, कभी संग्रहीत या लॉग नहीं की जाती। लोकल नेटवर्क के पते आपके डिवाइस से सीधे जुड़ते हैं, और दोनों ही स्थितियों में HTTPS आवश्यक है; घर के नेटवर्क पर सादे http:// पते के लिए iPhone या Android ऐप और उसकी लोकल कंप्यूट एंट्री चाहिए।
  • कुंजियाँ सिर्फ़ इसी डिवाइस पर रहती हैं और क्लाउड सिंक से अपलोड नहीं होतीं।

बिल्ट-इन प्रोवाइडरों के Base URL

Oriveo में इनकी ज़रूरत नहीं: वहाँ प्रोवाइडर को नाम से चुन लें। ये यहाँ इसलिए दिए हैं कि लोग दूसरे टूल्स के लिए अक्सर इन्हें ढूँढते हैं। हर पता प्रोवाइडर के दस्तावेज़ों में दिया गया आधिकारिक OpenAI-compatible पता है, 18 नवंबर 2026 तक का।

  • Anthropic अपनी OpenAI-compatible लेयर को टेस्टिंग और तुलना के लिए बताता है, और Mistral की quickstart गाइड उसके API को OpenAI-compatible नहीं बताती। इन दोनों को बिल्ट-इन प्रोवाइडर के रूप में ही जोड़ें।
बिल्ट-इन प्रोवाइडरों के Base URL
प्रोवाइडरOpenAI-compatible Base URL
OpenAIhttps://api.openai.com/v1
Google Geminihttps://generativelanguage.googleapis.com/v1beta/openai/
OpenRouterhttps://openrouter.ai/api/v1
DeepSeekhttps://api.deepseek.com
xAI (Grok)https://api.x.ai/v1
Groqhttps://api.groq.com/openai/v1
Together AIhttps://api.together.ai/v1
Fireworks AIhttps://api.fireworks.ai/inference/v1
MiniMax (इंटरनेशनल)https://api.minimax.io/v1
Z.ai (इंटरनेशनल)https://api.z.ai/api/paas/v4/
Qwen (सिंगापुर रीजन)https://dashscope-intl.aliyuncs.com/compatible-mode/v1
Kimi (इंटरनेशनल)https://api.moonshot.ai/v1
SiliconFlow (इंटरनेशनल)https://api.siliconflow.com/v1

क्या रिले या थर्ड-पार्टी API इस्तेमाल करना सुरक्षित है?

सावधान रहें। आपके और मॉडल के बीच की कोई भी सर्विस आपके प्रॉम्प्ट, जोड़ी गई फ़ाइलें और जवाब पढ़ सकती है, और अपने दाम ख़ुद तय करती है। Oriveo उसके अंदर नहीं देख सकता, न उसकी गारंटी ले सकता है।

  • अपने आधिकारिक प्रोवाइडर अकाउंट की API key किसी थर्ड-पार्टी सर्विस को कभी न दें। वही key इस्तेमाल करें जो वह सर्विस आपको देती है।
  • Oriveo के लिए अलग key बनाएँ, और सर्विस इजाज़त दे तो उस पर खर्च-सीमा लगाएँ या उसमें बैलेंस कम रखें।
  • जिस सर्विस पर भरोसा न हो, उससे पासवर्ड, ID नंबर या दफ़्तर की गोपनीय जानकारी न भेजें।
  • अपना इस्तेमाल सर्विस के अपने डैशबोर्ड पर देखें। Oriveo के खर्च के आँकड़े अनुमान हैं; आख़िरी रिकॉर्ड सर्विस का होता है।
  • key लीक हो जाए, तो सर्विस के डैशबोर्ड पर उसे मिटाएँ और नई बनाएँ।

मेरा कस्टम एंडपॉइंट कनेक्ट क्यों नहीं हो रहा?

Oriveo एक लाइन में बता देता है कि क्या गड़बड़ हुई। हिंदी इंटरफ़ेस में ये मैसेज इस तरह दिखते हैं:

  • 401, 402 और 429 जैसे कोड का क्या मतलब है, यह हमारी API key एरर गाइड में है।
मेरा कस्टम एंडपॉइंट कनेक्ट क्यों नहीं हो रहा?
Oriveo में मैसेजक्या जाँचें
हो सकता है पता किसी वेब पेज पर जा रहा हो। देखें कि /v1 छूट तो नहीं गया।पते को सर्विस के दस्तावेज़ों से मिलाएँ; वर्ज़न पाथ जोड़ें या हटाएँ
कुंजी अमान्य है।सर्विस के डैशबोर्ड से key दोबारा कॉपी करें
इस कुंजी से मॉडल सूची नहीं देखी जा सकती। आप मॉडल मैन्युअल रूप से जोड़ सकते हैं।अगले कदम पर मॉडल ID ख़ुद जोड़ें
कनेक्ट नहीं हो पा रहा। अपना नेटवर्क या प्रॉक्सी जाँचें।अपना इंटरनेट कनेक्शन जाँचें, और देखें कि पता खुल रहा है या नहीं
इस पते पर मौजूद सेवा अभी अनुरोधों की दर सीमित कर रही है।थोड़ा रुककर दोबारा कोशिश करें
यह कनेक्शन अपने अपस्ट्रीम प्रोवाइडर तक नहीं पहुँच सका।इसके पीछे सर्विस का अपना अकाउंट अमान्य हो सकता है, उसके क्रेडिट ख़त्म हो सकते हैं या उस पर रेट लिमिट हो सकती है; सर्विस चलाने वाले से संपर्क करें

ऐप से जुड़े आम सवाल

कस्टम API एंडपॉइंट क्या है?
यह किसी ऐसी AI सर्विस का वेब पता है जो आपके ऐप में पहले से नहीं जुड़ी, जैसे OpenAI-compatible API, रिले या गेटवे। इसे जोड़ने के लिए आप वह पता (Base URL) और सर्विस से मिली API key डालते हैं।
OpenAI-compatible API क्या होती है?
ऐसी API जो OpenAI जैसे ही फ़ॉर्मैट में रिक्वेस्ट लेती है, इसलिए OpenAI के लिए बने ऐप उसे इस्तेमाल कर पाते हैं। कई प्रोवाइडर और गेटवे ऐसी API देते हैं, आम तौर पर /v1 पर ख़त्म होने वाले पते पर।
Base URL में क्या डालें?
वही, जो सर्विस के दस्तावेज़ों में दिया है। अगर वहाँ सिर्फ़ डोमेन दिया है, तो वही डालें; Oriveo /v1 (या Gemini फ़ॉर्मैट के लिए /v1beta) जोड़ देगा। आगे बढ़ने से पहले "अनुरोध यहाँ जाएगा: …" वाली लाइन जाँच लें।
क्या iPhone और Android पर कस्टम एंडपॉइंट इस्तेमाल हो सकता है?
हाँ। कस्टम रिले iPhone और Android के Oriveo ऐप में भी है और वेब ऐप में भी। iPhone और Android पर ऐप सीधे उस पते से जुड़ता है।
Oriveo में HTTPS क्यों ज़रूरी है?
HTTPS कनेक्शन को एन्क्रिप्ट करता है, ताकि आपकी key और संदेश इंटरनेट पर सादे टेक्स्ट में न जाएँ। घर के नेटवर्क पर चल रहे मॉडल सर्वर के लिए लोकल कंप्यूट एंट्री इस्तेमाल करें।
क्या API रिले या प्रॉक्सी इस्तेमाल करना सुरक्षित है?
आप उससे जो भी भेजते हैं, वह सब पढ़ सकता है, इसलिए भरोसा मायने रखता है। सर्विस की दी हुई key इस्तेमाल करें, अपनी आधिकारिक प्रोवाइडर key कभी नहीं; खर्च-सीमा लगाएँ, और संवेदनशील जानकारी उससे दूर रखें।

इनसे जुड़े आर्टिकल

ब्लॉग से

अपनी मॉडल सेवा से कनेक्ट करें

वेब ऐप खोलें या iPhone या Android के लिए Oriveo डाउनलोड करें, कस्टम रिले चुनें, और अपनी सर्विस का पता और key पेस्ट करें।

अभी API key नहीं है? Oriveo Free से बिना key के शुरू करें।