ስህተቶችን ማግኘት አቁም! የCloudflare's Base URL እና API ለ OpenAI ተኳሃኝነት በቀላሉ ያዋቅሩ።

የCloudflare AI መሰረታዊ ዩአርኤልዬ ሁልጊዜ የ404 ስህተት የሚመልሰው ለምንድን ነው?

ይህ ጽሑፍ በሰከንዶች ውስጥ ከCloudflare ጋር ተኳሃኝ የሆነ የ OpenAI መሰረታዊ ዩአርኤል እንዴት በፍጥነት ማግኘት እና ማዋቀር እንደሚችሉ ያስተምርዎታል። ለኦፊሴላዊ የ REST API፣ የ AI Gateway ቅርጸት እና ለሶስተኛ ወገን ደንበኞች (Dify/One-API) ፍጹም አብነቶችን ያካትታል፣ ይህም በአንድ ጠቅታ ነፃ የ AI APIዎችን እንዲያገኙ እና እንዲያሄዱ ያግዝዎታል!

ባለፈው ሳምንት፣ አንድ ገለልተኛ ልማት የሚያደርግ ጓደኛዬ በድንገት አነጋግሮኝ 401 ስህተቶችን የሚያሳይ ስክሪን የሚያሳይ ቅጽበታዊ ገጽ እይታ ላከልኝ። "ወንድሜ፣ ቀኑን ሙሉ የCloudflareን AI API ለማረም እየሞከርኩ ነበር፣ ግን አይሰራም" አለኝ።

ኮዱን ተመለከትኩ። የመሠረት ዩአርኤሉ ወደ /ai/v1 ተቀናብሯል፣ ነገር ግን የጥያቄው አካል እንደ ኦፊሴላዊ የREST API ቅርጸት ስለተሰራ ሁለቱ ጨርሶ አይዛመዱም።

በዎርደርስ አይአይ ላይ ሞዴል ለማረም የኦፕንአይ ኤስዲኬን መጠቀም ብቻ እንደፈለገ ተናግሯል፣ ችግር አለ?

ይህ ትልቅ ችግር ነው።

የክላውድፍላር የAI አገልግሎቶች እንደ ሁኔታው ​​​​ሶስት ሙሉ በሙሉ የተለያዩ መሰረታዊ ዩአርኤሎችን ይጠቀማሉ። እያንዳንዳቸው የራሳቸው ቅርጸት እና ተግባራዊ ሁኔታዎች አሏቸው። ምንም እንኳን ሰነዶች ቢኖሩም፣ በተለያዩ ገጾች ላይ ተበታትኖ የሚገኝ ሲሆን ይህም በመጀመሪያው ሙከራዎ ላይ የትኛውን ማመልከት እንዳለቦት ለማወቅ አስቸጋሪ ያደርገዋል። የተሳሳተ ዩአርኤል መጠቀም 401 ወይም 400 ስህተት ያስከትላል፣ ይህም አገልግሎቱን እንዳያገኙ ይከለክላል።

ይህንን ችግር ለመጀመሪያ ጊዜ ሳጋጥመኝ፣ ከማወቄ በፊት ብዙ ጊዜ ሞክሬ ነበር። በስህተት መልዕክቶች የተሞላውን ማያ ገጹን እየተመለከትኩ ዝም አልኩ።

ዛሬ እነዚህን ሶስት መንገዶች በግልፅ እሳልላችኋለሁ፣ ስለዚህ ይህንን ካነበቡ በኋላ ምንም አይነት ስህተት አይሰሩም።

ከ OpenAI ጋር ተኳሃኝ የሆነ የበይነገጽ መሰረት ዩአርኤል

በብዛት ጥቅም ላይ በዋለው እንጀምር።

የOpenAI SDK ወይም እንደ LangChain፣ Dify፣ NextChat ወይም One-API ያሉ ብጁ የOpenAI ቅርጸቶችን የሚደግፉ መሳሪያዎችን የሚጠቀሙ ከሆነ ይህ ትክክለኛው አካሄድ ነው።

https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1

ይህ Cloudflare ከOpenAI በይነገጽ ቅርጸት ጋር እንዲጣጣም በተለይ የተነደፈ ነገር ነው። ሙሉውን የውይይት መጨረሻ ነጥብ ካጠናቀቁ በኋላ `/chat/completions` ያክሉ። የመጀመሪያውን የOpenAI Base URLዎን በዚህ ይተኩት፣ እና የAPI ቁልፉን በCloudflare tokenዎ ይተኩት፣ እና በቀጥታ መስራት አለበት። እንደ `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` እና `@cf/meta/llama-3.1-8b-instruct` ያሉ ሞዴሎችን ሞክሬያለሁ፣ እና ሁሉም በጥሩ ሁኔታ ይሰራሉ።

ሆኖም፣ ይህ የሚደግፈው በጽሑፍ ላይ የተመሰረቱ የውይይት ሞዴሎችን ብቻ መሆኑን ልብ ሊባል ይገባል።

የCloudflare ኦፊሴላዊ ተወላጅ REST API

ለግራፊክስ Stable Diffusion፣ ለድምጽ ግልባጭ ዊስፐር ወይም ለማንኛውም ጽሑፍ-ያልሆነ ሞዴል መጠቀም ከፈለጉ፣ ሁለተኛውን መንገድ ይጠቀሙ፣ ይህም የCloudflare ኦፊሴላዊ ተወላጅ REST API ነው።

https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run

የሞዴል ስሙ በ/ai/run/@cf/bytedance/stable-diffusion-xl-lightning ውስጥ ሊጻፍ ይችላል፣ ወይም በጥያቄው አካል `ሞዴል` መስክ ውስጥ ሊቀመጥ ይችላል። በመስክ ላይ ማስቀመጥ እመርጣለሁ፤ መንገዱ አጭር እና ንፁህ ነው። መጀመሪያ ላይ ስለዚህ ዝርዝር ጉዳይም ግራ ተጋብቼ ነበር። አንዳንድ ሞዴሎች ሁለቱንም ዘዴዎች ይቀበላሉ፣ ሌሎች ደግሞ አንዱን ብቻ ይቀበላሉ። ሰነዶቹን ሲፈትሹ ለዚህ ትኩረት ይስጡ።

የAI ጌትዌይ ቤዝ ዩአርኤል

ሦስተኛው መንገድ አለ፡ የAI ጌትዌይ።

ይህ ሁኔታ ትንሽ የተለየ ነው። በCloudflare backend ውስጥ የAI Gateway ን ወደ ፕሮክሲ የሶስተኛ ወገን ኤፒአይዎች ካዋቀሩ፣ ለምሳሌ የOpenAI ጥያቄዎችን በCloudflare gateway በኩል ለመሸጎጫ፣ ለክትትል እና ለደረጃ ገደብ ማስተላለፍ፣ የመሠረት ዩአርኤሉ... ይሆናል

https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai

ሙሉውን የመጨረሻ ነጥብ ከጨረሱ በኋላ `/chat/completions` ን ማከል ሁሉም ትራፊክ በCloudflare ጌትዌይ በኩል እንዲያልፍ ያረጋግጣል፣ እና የምዝግብ ማስታወሻ ፓነሉ የእያንዳንዱን ጥያቄ መዘግየት እና ውጤት ያሳያል። ይህ ባህሪ ቡድኑ ተጨማሪ ፕሮጀክቶችን በማሳደግ ረገድ እጅግ በጣም ጠቃሚ ነው፣ ይህም ከተለያዩ አቅራቢዎች የኋላ ክፍሎች የተገኙ መረጃዎችን አንድ በአንድ የመፈለግ አስፈላጊነትን ያስወግዳል።

እንዴት መምረጥ እንደሚቻል፡ በአንድ ዓረፍተ ነገር ውስጥ የተብራሩ ሦስት የዩአርኤል ስብስቦች።

እሺ፣ ያ ሦስቱን መንገዶች ይሸፍናል። ባጭሩ፣ አንድ መርህ ብቻ አለ።

የምትወስደው መንገድ የሚወሰነው በምትጠቀምባቸው መሳሪያዎች ላይ ነው።

የንግግር ሞዴል ለመጥራት የOpenAI SDK ን ለመጠቀም ወደ `/ai/v1` ይሂዱ። የምስል/ኦዲዮ ሞዴል ለመጥራት ወደ `/ai/run` ይሂዱ። በጌትዌይ በኩል የተዋሃደ አስተዳደር ለማግኘት ወደ `/gateway/` ይሂዱ። የማረጋገጫ ዘዴው ተመሳሳይ ነው፡ `Authorization: Bearer`ን ከዚያ በኋላ የኤፒአይ ቶከንዎን በአርዕስቱ ላይ ያስቀምጡ። በCloudflare ጀርባው ውስጥ ቶከን ይፍጠሩ እና የ`Workers AI: Edit` ፈቃድን ያረጋግጡ።

የአካውንት_መታወቂያውን የት ማግኘት ይቻላል? ወደ Cloudflare የአስተዳዳሪ ፓነልዎ ይግቡ፣ በቀኝ የጎን አሞሌ ላይ ወዳለው የኤፒአይ ክፍል ወደታች ይሸብልሉ፣ ወይም የአሳሽዎን የአድራሻ አሞሌ ያረጋግጡ፤ ያ 32-ቁምፊ ፊደል-ቁጥራዊ ሕብረቁምፊ ነው።

እውነቱን ለመናገር፣ በዚያ ቀን ጓደኛዬ እንዲያጠናቅቀው ከረዳሁት በኋላ፣ በጣም ትክክል ነው ብዬ የማስበውን አንድ ነገር ነገረኝ፤ እንዴት እንደሆነ አላውቅም ነበር፣ ሰነዱ በግልጽ ስላላስረዳኝ ነበር።

ብዙ ቴክኒካዊ ውቅሮች እንደዚህ ናቸው። በተለይ አስቸጋሪ አይደሉም፣ ነገር ግን በጣም ብዙ የመግቢያ ነጥቦች ስላሉ፣ በመጀመሪያው ሙከራዎ ላይ ለመጥፋት ቀላል ያደርጉታል። Cloudflare AI ን ሲያዋቅሩ የተለያዩ ለመረዳት የማይቻሉ ስህተቶች ካጋጠሙዎት፣ ምናልባት የተሳሳተ የመሠረት ዩአርኤል ወይም የተሳሳተ ቅርጸት በመኖሩ ሊሆን ይችላል። እነዚህን ሶስት የዩአርኤል ስብስቦች በእጅዎ ያስቀምጡ፤ ትክክለኛውን በሚቀጥለው ጊዜ በቀላሉ ማግኘት ይችላሉ።

ምንም አይደል።

ስለዚህ፣ እስካሁን ድረስ ስላነበቡት፣ ጠቃሚ ሆኖ ካገኙት፣ እባክዎን ላይክ እና ሼር ያድርጉ። መጀመሪያ ዝማኔዎችን መቀበል ከፈለጉ፣ እኔንም መከተል ይችላሉ! ⭐

ጽሑፌን ስላነበባችሁልኝ አመሰግናለሁ። በሚቀጥለው ጊዜ እንገናኝ።