लेख निर्देशिका
मेरे Cloudflare AI बेस URL पर हमेशा 404 एरर क्यों आ रहा है?
यह लेख आपको कुछ ही सेकंडों में क्लाउडफ्लेयर-संगत ओपनएआई बेस यूआरएल प्राप्त करने और कॉन्फ़िगर करने का तरीका सिखाता है। इसमें आधिकारिक REST API, AI गेटवे प्रारूप और तृतीय-पक्ष क्लाइंट (Dify/One-API) के लिए उपयुक्त टेम्पलेट शामिल हैं, जो आपको एक क्लिक में निःशुल्क AI API को तुरंत शुरू करने में मदद करते हैं!
पिछले हफ्ते, स्वतंत्र रूप से डेवलपमेंट करने वाले एक दोस्त ने अचानक मुझसे संपर्क किया और मुझे 401 त्रुटियों से भरी स्क्रीन का स्क्रीनशॉट भेजा। उसने कहा, "भाई, मैं पूरे दिन क्लाउडफ्लेयर के एआई एपीआई को डीबग करने की कोशिश कर रहा हूं, लेकिन यह काम ही नहीं कर रहा है।"
मैंने उसके कोड पर एक नज़र डाली। बेस यूआरएल को /ai/v1 पर सेट किया गया था, लेकिन रिक्वेस्ट बॉडी को आधिकारिक REST API के प्रारूप में तैयार किया गया था, इसलिए दोनों में कोई मेल नहीं था।
उन्होंने कहा कि वे केवल वर्कर्स एआई पर एक मॉडल को डीबग करने के लिए ओपनएआई के एसडीके का उपयोग करना चाहते हैं, क्या इसमें कोई समस्या है?
यह बहुत बड़ी समस्या है।
क्लाउडफ्लेयर की एआई सेवाएं अलग-अलग परिस्थितियों के आधार पर तीन पूरी तरह से भिन्न बेस यूआरएल का उपयोग करती हैं। प्रत्येक यूआरएल का अपना प्रारूप और लागू होने वाली परिस्थितियां हैं। हालांकि दस्तावेज़ उपलब्ध हैं, लेकिन वे अलग-अलग पृष्ठों पर बिखरे हुए हैं, जिससे पहली बार में यह जानना मुश्किल हो जाता है कि किस यूआरएल का उपयोग करना है। गलत यूआरएल का उपयोग करने पर 401 या 400 त्रुटि आएगी, जिससे आप सेवा का उपयोग नहीं कर पाएंगे।
जब मुझे पहली बार इस समस्या का सामना करना पड़ा, तो मैंने इसे समझने से पहले कई बार कोशिश की। त्रुटि संदेशों से भरी स्क्रीन को देखकर मैं अवाक रह गया।
आज मैं आपके लिए इन तीनों रास्तों को स्पष्ट रूप से चित्रित करूँगा, ताकि इसे पढ़ने के बाद आप कोई और गलती न करें।
OpenAI संगत इंटरफ़ेस बेस URL
चलिए सबसे अधिक उपयोग किए जाने वाले से शुरू करते हैं।
यदि आप OpenAI SDK का उपयोग कर रहे हैं, या LangChain, Dify, NextChat, या One-API जैसे कस्टम OpenAI प्रारूपों का समर्थन करने वाले टूल का उपयोग कर रहे हैं, तो यह सही तरीका है।
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
यह क्लाउडफ्लेयर द्वारा विशेष रूप से ओपनएआई इंटरफ़ेस प्रारूप के अनुरूप बनाया गया है। पूर्ण संवाद एंडपॉइंट के बाद `/chat/completions` जोड़ें। अपने मूल ओपनएआई बेस यूआरएल को इससे बदलें, और एपीआई कुंजी को अपने क्लाउडफ्लेयर टोकन से बदलें, और यह सीधे चलना चाहिए। मैंने `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` और `@cf/meta/llama-3.1-8b-instruct` जैसे मॉडल आज़माए हैं, और वे सभी ठीक काम करते हैं।
हालांकि, यह ध्यान रखना महत्वपूर्ण है कि यह केवल टेक्स्ट-आधारित संवाद मॉडल का समर्थन करता है।
क्लाउडफ्लेयर का आधिकारिक नेटिव REST API
यदि आपको ग्राफ़िंग के लिए स्टेबल डिफ्यूजन, ऑडियो ट्रांसक्रिप्शन के लिए व्हिस्पर, या किसी भी गैर-टेक्स्ट मॉडल का उपयोग करने की आवश्यकता है, तो दूसरा तरीका अपनाएं, जो क्लाउडफ्लेयर का आधिकारिक नेटिव रेस्ट एपीआई है।
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
मॉडल का नाम पाथ में लिखा जा सकता है, जैसे कि /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, या इसे रिक्वेस्ट बॉडी के `model` फ़ील्ड में रखा जा सकता है। मैं इसे फ़ील्ड में रखना पसंद करता हूँ; इससे पाथ छोटा और साफ़-सुथरा रहता है। मुझे भी पहले इस बात को लेकर थोड़ी उलझन थी। कुछ मॉडल दोनों तरीकों को स्वीकार करते हैं, जबकि कुछ केवल एक को। दस्तावेज़ देखते समय इस बात का ध्यान रखें।
एआई गेटवे बेस यूआरएल
एक तीसरा तरीका भी है: एआई गेटवे।
यह परिदृश्य थोड़ा अलग है। यदि आपने क्लाउडफ्लेयर बैकएंड में तृतीय-पक्ष एपीआई को प्रॉक्सी करने के लिए एक एआई गेटवे स्थापित किया है, जैसे कि कैशिंग, मॉनिटरिंग और रेट लिमिटिंग के लिए क्लाउडफ्लेयर गेटवे के माध्यम से ओपनएआई अनुरोधों को अग्रेषित करना, तो बेस यूआरएल यह होगा...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
कंप्लीट एंडपॉइंट के बाद `/chat/completions` जोड़ने से यह सुनिश्चित होता है कि सारा ट्रैफ़िक क्लाउडफ्लेयर गेटवे से होकर गुज़रे, और लॉग पैनल प्रत्येक अनुरोध की लेटेंसी और परिणाम दिखाता है। जैसे-जैसे टीम में प्रोजेक्ट्स की संख्या बढ़ती है, यह सुविधा बेहद उपयोगी साबित होती है, क्योंकि इससे विभिन्न वेंडर्स के बैकएंड से डेटा को एक-एक करके खोजने की ज़रूरत खत्म हो जाती है।
कैसे चुनें: तीन प्रकार के यूआरएल को एक वाक्य में समझाया गया है।
ठीक है, इससे तीनों रास्ते कवर हो गए। संक्षेप में, केवल एक ही सिद्धांत है।
आप जो रास्ता अपनाते हैं, वह आपके द्वारा उपयोग किए जाने वाले उपकरणों पर निर्भर करता है।
डायलॉग मॉडल को कॉल करने के लिए OpenAI SDK का उपयोग करने हेतु `/ai/v1` पर जाएं। इमेज/ऑडियो मॉडल को कॉल करने के लिए `/ai/run` पर जाएं। गेटवे के माध्यम से एकीकृत प्रबंधन के लिए `/gateway/` पर जाएं। प्रमाणीकरण विधि समान है: हेडर में `Authorization: Bearer` के बाद अपना API टोकन डालें। Cloudflare बैकएंड में टोकन बनाएं और `Workers AI: Edit` अनुमति को चेक करना न भूलें।
account_id कहाँ मिलेगा? अपने Cloudflare एडमिन पैनल में लॉग इन करें, दाईं ओर के साइडबार में API सेक्शन तक स्क्रॉल करें, या अपने ब्राउज़र के एड्रेस बार को देखें; वह 32 अक्षरों वाली अल्फ़ान्यूमेरिक स्ट्रिंग ही है।
सच कहूँ तो, उस दिन जब मैंने अपने दोस्त को यह काम पूरा करने में मदद की, तो उसने मुझसे कुछ ऐसा कहा जो मुझे बिल्कुल सही लगता है: बात यह नहीं थी कि मुझे यह करना नहीं आता था, बल्कि यह थी कि दस्तावेज़ में इसे स्पष्ट रूप से समझाया नहीं गया था।
कई तकनीकी कॉन्फ़िगरेशन इसी तरह के होते हैं। ऐसा नहीं है कि वे बहुत मुश्किल होते हैं, लेकिन उनमें प्रवेश के कई रास्ते होते हैं, जिससे पहली बार में भ्रमित होना आसान हो जाता है। यदि आपको Cloudflare AI को कॉन्फ़िगर करते समय कई अस्पष्ट त्रुटियाँ मिली हैं, तो इसकी सबसे संभावित वजह गलत बेस URL या गलत फॉर्मेटिंग है। इन तीन URL सेटों को संभाल कर रखें; अगली बार आप आसानी से सही URL ढूंढ पाएंगे।
आपका स्वागत है।
तो, चूंकि आपने इसे यहाँ तक पढ़ लिया है, अगर आपको यह उपयोगी लगा हो, तो कृपया इसे लाइक और शेयर करें। अगर आप सबसे पहले अपडेट पाना चाहते हैं, तो आप मुझे फॉलो भी कर सकते हैं! ⭐
मेरा लेख पढ़ने के लिए धन्यवाद। फिर मिलेंगे।
आशा है कि चेन वेइलियांग के ब्लॉग ( https://www.chenweiliang.com/ ) पर साझा किया गया लेख "त्रुटियों की रिपोर्टिंग बंद करें! ओपनएआई संगतता के लिए क्लाउडफ्लेयर को आसानी से कॉन्फ़िगर करें: बेस यूआरएल और इंटरफ़ेस" आपके लिए उपयोगी होगा।
इस लेख का लिंक साझा करने में संकोच न करें: https://www.chenweiliang.com/cwl-34252.html