آرٹیکل ڈائرکٹری
CloudFlare کے AI بیس یو آر ایل ہمیشہ 404 غلطی کیوں لوٹاتا ہے؟
یہ مضمون آپ کو سیکنڈوں میں سکھاتا ہے کہ Cloudflare سے مطابقت رکھنے والے OpenAI بیس یو آر ایل کو فوری طور پر کیسے حاصل کیا جائے اور کنفیگر کیا جائے۔ اس میں آفیشل REST API، AI گیٹ وے فارمیٹ، اور تھرڈ پارٹی کلائنٹس (Dify/One-API) کے لیے بہترین ٹیمپلیٹس شامل ہیں، جو آپ کو ایک کلک کے ساتھ مفت AI APIs حاصل کرنے اور چلانے میں مدد فراہم کرتے ہیں!
پچھلے ہفتے، ایک دوست جو آزادانہ ترقی کرتا ہے، اچانک مجھ سے رابطہ کیا اور مجھے ایک اسکرین شاٹ بھیجا جس میں 401 غلطیوں سے بھری اسکرین دکھائی گئی۔ اس نے کہا، "بھائی، میں سارا دن Cloudflare کے AI API کو ڈیبگ کرنے کی کوشش کرتا رہا، لیکن یہ کام نہیں کرے گا۔"
میں نے اس کے کوڈ پر نظر ڈالی۔ بیس یو آر ایل کو /ai/v1 پر سیٹ کیا گیا تھا، لیکن درخواست کے باڈی کو آفیشل REST API کے طور پر فارمیٹ کیا گیا تھا، اس لیے دونوں بالکل مماثل نہیں تھے۔
انہوں نے کہا کہ وہ صرف OpenAI کے SDK کو ورکرز AI پر ایک ماڈل ڈیبگ کرنے کے لیے استعمال کرنا چاہتے ہیں، کیا کوئی مسئلہ ہے؟
یہ ایک بڑا مسئلہ ہے۔
Cloudflare کی AI سروسز منظر نامے کے لحاظ سے تین بالکل مختلف بیس یو آر ایل استعمال کرتی ہیں۔ ہر ایک کا اپنا فارمیٹ اور قابل اطلاق منظرنامے ہیں۔ اگرچہ دستاویزات موجود ہیں، لیکن یہ مختلف صفحات پر بکھری ہوئی ہے، جس سے یہ جاننا مشکل ہو جاتا ہے کہ آپ کی پہلی کوشش میں کس کا حوالہ دینا ہے۔ غلط یو آر ایل استعمال کرنے کے نتیجے میں 401 یا 400 خرابی ہوگی، جو آپ کو سروس تک رسائی سے روکے گی۔
جب مجھے پہلی بار اس مسئلے کا سامنا کرنا پڑا، میں نے اس کا پتہ لگانے سے پہلے کئی بار کوشش کی۔ میں غلطی کے پیغامات سے بھری سکرین کو دیکھ کر بے آواز تھا۔
آج میں آپ کے لیے یہ تین سڑکیں واضح طور پر کھینچوں گا، تاکہ آپ اسے پڑھنے کے بعد مزید غلطیاں نہ کریں۔
OpenAI ہم آہنگ انٹرفیس بیس یو آر ایل
آئیے سب سے زیادہ استعمال ہونے والے کے ساتھ شروع کریں۔
اگر آپ OpenAI SDK، یا ٹولز استعمال کر رہے ہیں جو اپنی مرضی کے OpenAI فارمیٹس جیسے LangChain، Dify، NextChat، یا One-API کو سپورٹ کرتے ہیں، تو یہ صحیح طریقہ ہے۔
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
یہ Cloudflare خاص طور پر OpenAI انٹرفیس فارمیٹ کے ساتھ سیدھ میں لانے کے لیے ڈیزائن کیا گیا ہے۔ مکمل مکالمے کے اختتامی نقطہ کے بعد `/chat/completions` شامل کریں۔ اپنے اصل OpenAI Base URL کو اس سے بدلیں، اور API Key کو اپنے Cloudflare ٹوکن سے تبدیل کریں، اور اسے براہ راست چلنا چاہیے۔ میں نے `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` اور `@cf/meta/llama-3.1-8b-instruct` جیسے ماڈلز آزمائے ہیں، اور وہ سب ٹھیک کام کرتے ہیں۔
تاہم، یہ واضح رہے کہ یہ صرف ٹیکسٹ پر مبنی ڈائیلاگ ماڈلز کی حمایت کرتا ہے۔
Cloudflare کا سرکاری مقامی REST API
اگر آپ کو گرافنگ کے لیے Stable Diffusion، Whisper for Audio ٹرانسکرپشن، یا کوئی غیر متنی ماڈل استعمال کرنے کی ضرورت ہے، تو دوسرا راستہ اختیار کریں، جو Cloudflare کا آفیشل مقامی REST API ہے۔
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
ماڈل کا نام راستے میں لکھا جا سکتا ہے، جیسے /ai/run/@cf/bytedance/stable-diffusion-xl-lightning، یا اسے درخواست کے باڈی کے `ماڈل` فیلڈ میں رکھا جا سکتا ہے۔ میں اسے میدان میں ڈالنے کو ترجیح دیتا ہوں؛ راستہ چھوٹا اور صاف ہے۔ میں بھی پہلے اس تفصیل کے بارے میں الجھن میں تھا۔ کچھ ماڈل دونوں طریقوں کو قبول کرتے ہیں، جبکہ دوسرے صرف ایک کو قبول کرتے ہیں۔ دستاویزات کی جانچ پڑتال کرتے وقت اس پر توجہ دیں۔
AI گیٹ وے بیس یو آر ایل
ایک تیسرا راستہ ہے: AI گیٹ وے۔
یہ منظر نامہ قدرے مختلف ہے۔ اگر آپ نے پراکسی تھرڈ پارٹی APIs کے لیے Cloudflare بیک اینڈ میں ایک AI گیٹ وے ترتیب دیا ہے، جیسے کیشنگ، مانیٹرنگ، اور ریٹ محدود کرنے کے لیے Cloudflare گیٹ وے کے ذریعے OpenAI کی درخواستوں کو آگے بڑھانا، تو بنیادی URL ہو گا...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
مکمل اختتامی نقطہ کے بعد `/chat/completions` کو شامل کرنا یقینی بناتا ہے کہ تمام ٹریفک Cloudflare گیٹ وے سے گزرتی ہے، اور لاگ پینل ہر درخواست کی تاخیر اور نتیجہ دکھاتا ہے۔ یہ خصوصیت ناقابل یقین حد تک مفید ہے کیونکہ ٹیم مزید پروجیکٹس کے ساتھ ترقی کرتی ہے، ایک ایک کرکے مختلف دکانداروں کے بیک اینڈ سے ڈیٹا تلاش کرنے کی ضرورت کو ختم کرتی ہے۔
منتخب کرنے کا طریقہ: یو آر ایل کے تین سیٹ ایک جملے میں بیان کیے گئے ہیں۔
ٹھیک ہے، یہ تین راستوں کا احاطہ کرتا ہے۔ خلاصہ میں، صرف ایک اصول ہے.
آپ جو راستہ اختیار کرتے ہیں اس کا انحصار آپ کے استعمال کردہ ٹولز پر ہوتا ہے۔
ڈائیلاگ ماڈل کو کال کرنے کے لیے OpenAI SDK استعمال کرنے کے لیے، `/ai/v1` پر جائیں۔ تصویر/آڈیو ماڈل کو کال کرنے کے لیے، `/ai/run` پر جائیں۔ گیٹ وے کے ذریعے متحد انتظام کے لیے، `/گیٹ وے/` پر جائیں۔ تصدیق کا طریقہ وہی ہے: ہیڈر میں اپنا API ٹوکن کے بعد `Authorization: Bearer` ڈالیں۔ Cloudflare بیک اینڈ میں ٹوکن بنائیں، اور `Workers AI: Edit` کی اجازت چیک کرنا یاد رکھیں۔
اکاؤنٹ_آئی ڈی کہاں تلاش کریں؟ اپنے Cloudflare ایڈمن پینل میں لاگ ان کریں، دائیں سائڈبار میں API سیکشن تک نیچے سکرول کریں، یا اپنے براؤزر کا ایڈریس بار چیک کریں۔ وہ 32 حروف کی حروف عددی تار ہے۔
سچ میں، اس دن میں نے اپنے دوست کی مدد کرنے کے بعد، اس نے مجھ سے کچھ کہا جو میرے خیال میں بالکل درست ہے: ایسا نہیں تھا کہ میں نہیں جانتا تھا کہ کیسے، یہ تھا کہ دستاویزات نے مجھے واضح طور پر اس کی وضاحت نہیں کی تھی۔
بہت سے تکنیکی ترتیب اس طرح ہیں. ایسا نہیں ہے کہ وہ خاص طور پر مشکل ہیں، لیکن داخلے کے بہت سارے پوائنٹس ہیں، جو آپ کی پہلی کوشش میں کھو جانا آسان بنا دیتے ہیں۔ اگر آپ کو Cloudflare AI کو کنفیگر کرتے وقت مختلف ناقابل فہم غلطیوں کا سامنا کرنا پڑا ہے، تو اس کا زیادہ تر امکان غلط Base URL یا غلط فارمیٹ کی وجہ سے ہے۔ یو آر ایل کے ان تین سیٹوں کو ہاتھ میں رکھیں۔ آپ اگلی بار آسانی سے صحیح تلاش کر سکتے ہیں۔
آپ کا استقبال ہے۔
لہذا، چونکہ آپ نے یہ پڑھا ہے، اگر آپ کو یہ مفید لگا، تو براہ کرم اسے لائک اور شیئر کریں۔ اگر آپ پہلے اپ ڈیٹس حاصل کرنا چاہتے ہیں، تو آپ مجھے بھی فالو کر سکتے ہیں! ⭐
میرا مضمون پڑھنے کے لیے آپ کا شکریہ۔ اگلی بار ملتے ہیں۔
ہوپ چن ویلیانگ بلاگ ( https://www.chenweiliang.com/ مضمون "غلطیوں کی اطلاع دینا بند کریں! بنیادی URLs اور انٹرفیس کے ساتھ OpenAI مطابقت کے لیے Cloudflare کو آسانی سے ترتیب دیں،" آپ کے لیے مددگار ثابت ہو سکتا ہے۔
اس مضمون کا لنک شیئر کرنے میں خوش آمدید:https://www.chenweiliang.com/cwl-34252.html