ලිපි නාමාවලිය
මගේ Cloudflare AI පාදක URL එක සැමවිටම 404 දෝෂයක් ලබා දෙන්නේ ඇයි?
මෙම ලිපියෙන් ඔබට Cloudflare-අනුකූල OpenAI පාදක URL එකක් ඉක්මනින් ලබා ගන්නේ කෙසේද සහ වින්යාස කරන්නේ කෙසේද යන්න තත්පර කිහිපයකින් උගන්වනු ලැබේ. එහි නිල REST API, AI Gateway ආකෘතිය සහ තෙවන පාර්ශවීය සේවාලාභීන් (Dify/One-API) සඳහා පරිපූර්ණ සැකිලි ඇතුළත් වන අතර, ඔබට නොමිලේ AI API එක ක්ලික් එකකින් ක්රියාත්මක කිරීමට උපකාරී වේ!
ගිය සතියේ, ස්වාධීන සංවර්ධන කටයුතු කරන මිතුරෙකු හදිසියේම මට කතා කර, දෝෂ 401 කින් පිරුණු තිරයක් පෙන්වන තිර රුවක් මට එව්වා. ඔහු කිව්වා, "සහෝදරයා, මම දවස පුරාම Cloudflare හි AI API එක debug කරන්න උත්සාහ කළා, නමුත් ඒක වැඩ කරන්නේ නැහැ."
මම ඔහුගේ කේතය දෙස බැලුවෙමි. මූලික URL එක /ai/v1 ලෙස සකසා ඇත, නමුත් ඉල්ලීම් අන්තර්ගතය නිල REST API ලෙස සංයුති කර ඇත, එබැවින් දෙකම කිසිසේත්ම නොගැලපේ.
ඔහු කිව්වා Workers AI එකේ මොඩලයක් දෝශ නිරාකරණය කරන්න OpenAI එකේ SDK එක පාවිච්චි කරන්න ඕන කියලා, මොකක් හරි ප්රශ්නයක් තියෙනවද?
මේක ලොකු ප්රශ්නයක්.
Cloudflare හි AI සේවාවන් අවස්ථාව අනුව සම්පූර්ණයෙන්ම වෙනස් මූලික URL තුනක් භාවිතා කරයි. ඒ සෑම එකක්ම තමන්ගේම ආකෘතියක් සහ අදාළ අවස්ථා ඇත. ලියකියවිලි තිබුණත්, එය විවිධ පිටු පුරා විසිරී ඇති අතර, ඔබේ පළමු උත්සාහයේදී කුමන එක වෙත යොමු විය යුතු දැයි දැන ගැනීමට අපහසු වේ. වැරදි URL භාවිතා කිරීමෙන් 401 හෝ 400 දෝෂයක් ඇති වන අතර එමඟින් ඔබට සේවාවට ප්රවේශ වීම වළක්වයි.
මට මේ ගැටලුව මුලින්ම හමු වූ විට, එය සොයා ගැනීමට පෙර මම කිහිප වතාවක්ම උත්සාහ කළෙමි. දෝෂ පණිවිඩවලින් පිරුණු තිරය දෙස බලා මම ගොළු වී සිටියෙමි.
අද මම ඔබට මේ මාර්ග තුන පැහැදිලිව අඳින්නම්, ඒ නිසා මෙය කියවීමෙන් පසු ඔබ තවත් වැරදි නොකරනු ඇත.

OpenAI අනුකූල අතුරුමුහුණත් පාදක URL
වඩාත් බහුලව භාවිතා වන එකකින් පටන් ගනිමු.
ඔබ OpenAI SDK හෝ LangChain, Dify, NextChat, හෝ One-API වැනි අභිරුචි OpenAI ආකෘති සඳහා සහය දක්වන මෙවලම් භාවිතා කරන්නේ නම්, මෙය නිවැරදි ප්රවේශයයි.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
මෙය OpenAI අතුරුමුහුණත් ආකෘතිය සමඟ පෙළගැස්වීමට Cloudflare විශේෂයෙන් නිර්මාණය කර ඇති දෙයකි. සම්පූර්ණ සංවාද අන්ත ලක්ෂ්යයෙන් පසුව `/chat/completions` එක් කරන්න. ඔබේ මුල් OpenAI Base URL එක මේ සමඟ ප්රතිස්ථාපනය කර, API යතුර ඔබේ Cloudflare ටෝකනය සමඟ ප්රතිස්ථාපනය කරන්න, එවිට එය කෙලින්ම ක්රියාත්මක විය යුතුය. මම `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` සහ `@cf/meta/llama-3.1-8b-instruct` වැනි මාදිලි උත්සාහ කර ඇති අතර, ඒවා සියල්ලම හොඳින් ක්රියාත්මක වේ.
කෙසේ වෙතත්, මෙය පෙළ-පාදක සංවාද ආකෘති සඳහා පමණක් සහාය දක්වන බව සැලකිල්ලට ගත යුතුය.
Cloudflare හි නිල ස්වදේශීය REST API
ඔබට ග්රැෆිං සඳහා ස්ථායී විසරණය, ශ්රව්ය පිටපත් කිරීම සඳහා විස්පර් හෝ ඕනෑම පෙළ නොවන ආකෘතියක් භාවිතා කිරීමට අවශ්ය නම්, දෙවන මාර්ගය ගන්න, එය Cloudflare නිල ස්වදේශීය REST API වේ.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
ආකෘති නාමය /ai/run/@cf/bytedance/stable-diffusion-xl-lightning වැනි මාර්ගයක ලිවිය හැකිය, නැතහොත් එය ඉල්ලීම් ශරීරයේ `model` ක්ෂේත්රයේ තැබිය හැකිය. මම එය ක්ෂේත්රයේ තැබීමට කැමැත්තෙමි; මාර්ගය කෙටි හා පිරිසිදුයි. මුලදී මට මෙම විස්තරය ගැනද ව්යාකූලත්වයක් ඇති විය. සමහර ආකෘති දෙකම ක්රම දෙකම පිළිගන්නා අතර අනෙක් ඒවා එකක් පමණක් පිළිගනී. ලියකියවිලි පරීක්ෂා කිරීමේදී මේ පිළිබඳව අවධානය යොමු කරන්න.
AI ද්වාර පාදක URL එක
තුන්වන ක්රමයක් තිබේ: AI ද්වාරය.
මෙම අවස්ථාව තරමක් වෙනස් ය. ඔබ Cloudflare පසු අන්තයේ තෙවන පාර්ශවීය API ප්රොක්සි කිරීමට AI Gateway එකක් සකසා ඇත්නම්, උදාහරණයක් ලෙස Claudflare ද්වාරය හරහා OpenAI ඉල්ලීම් Caching, Monitoring සහ rate Limiting සඳහා යොමු කිරීම, එවිට Base URL එක...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
සම්පූර්ණ අන්ත ලක්ෂ්යයෙන් පසුව `/කතාබස්/සම්පූර්ණ කිරීම්` එකතු කිරීමෙන් සියලුම ගමනාගමනය Cloudflare ද්වාරය හරහා ගමන් කරන බව සහතික කරන අතර, ලොග් පැනලය එක් එක් ඉල්ලීමේ ප්රමාදය සහ ප්රතිඵලය පෙන්වයි. කණ්ඩායම තවත් ව්යාපෘති සමඟ වර්ධනය වන විට මෙම විශේෂාංගය ඇදහිය නොහැකි තරම් ප්රයෝජනවත් වන අතර, විවිධ වෙළෙන්දන්ගේ පසුබිම් වලින් දත්ත එකින් එක සෙවීමේ අවශ්යතාවය ඉවත් කරයි.
තෝරා ගන්නේ කෙසේද: එක් වාක්යයකින් පැහැදිලි කරන ලද URL කට්ටල තුනක්.
හරි, ඒක මාර්ග තුන ආවරණය කරනවා. සාරාංශයක් ලෙස, ඇත්තේ එක් මූලධර්මයක් පමණයි.
ඔබ තෝරා ගන්නා මාර්ගය ඔබ භාවිතා කරන මෙවලම් මත රඳා පවතී.
සංවාද ආකෘතියක් ඇමතීමට OpenAI SDK භාවිතා කිරීමට, `/ai/v1` වෙත යන්න. රූප/ශ්රව්ය ආකෘතියක් ඇමතීමට, `/ai/run` වෙත යන්න. ද්වාරයක් හරහා ඒකාබද්ධ කළමනාකරණය සඳහා, `/gateway/` වෙත යන්න. සත්යාපන ක්රමය සමාන වේ: `Authorization: Bearer` සහ ඔබේ API ටෝකනය ශීර්ෂයේ තබන්න. Cloudflare පසුබිමේ ටෝකනය සාදන්න, සහ `Workers AI: Edit` අවසරය පරීක්ෂා කිරීමට මතක තබා ගන්න.
account_id එක කොහෙන්ද හොයාගන්නේ? ඔයාගේ Cloudflare පරිපාලක පැනලයට ලොග් වෙලා, දකුණු පැත්තේ තියෙන API කොටසට පහළට අනුචලනය කරන්න, නැත්නම් ඔයාගේ බ්රවුසරයේ ලිපින තීරුව පරීක්ෂා කරන්න; ඒ අකුරු 32 කින් යුත් අක්ෂරාංක නූල තමයි ඒක.
අවංකවම, මම ඒ දවසෙ මගේ යාළුවට ඒක කරන්න උදව් කළාට පස්සේ, එයා මට කිව්ව දෙයක් හරිම නිවැරදියි කියලා මම හිතනවා: මම ඒක කරන්නේ කොහොමද කියලා දැනගෙන හිටියේ නැති නිසා නෙවෙයි, ලියකියවිලි මට ඒක පැහැදිලිව පැහැදිලි කරලා තිබුණේ නැති නිසා.
බොහෝ තාක්ෂණික වින්යාසයන් මේ වගේ. ඒවා විශේෂයෙන් අපහසු බව නොවේ, නමුත් ප්රවේශ ස්ථාන ඕනෑවට වඩා ඇති බැවින් ඔබේ පළමු උත්සාහයේදීම නැති වී යාම පහසුය. Cloudflare AI වින්යාස කිරීමේදී ඔබට විවිධ පැහැදිලි කළ නොහැකි දෝෂ හමු වී ඇත්නම්, එය බොහෝ විට වැරදි මූලික URL එකක් හෝ වැරදි ලෙස ආකෘතිගත කරන ලද ආකෘතියක් නිසා විය හැකිය. මෙම URL කට්ටල තුන පහසුවෙන් තබා ගන්න; ඊළඟ වතාවේ ඔබට නිවැරදි එක පහසුවෙන් සොයාගත හැකිය.
不用谢.
ඉතින්, ඔබ මෙතෙක් කියවා ඇති බැවින්, එය ඔබට ප්රයෝජනවත් යැයි හැඟේ නම්, කරුණාකර එයට කැමති වී බෙදා ගන්න. ඔබට පළමුව යාවත්කාලීන කිරීම් ලබා ගැනීමට අවශ්ය නම්, ඔබට මා අනුගමනය කළ හැකිය! ⭐
මගේ ලිපිය කියෙව්වට ස්තූතියි. ඊළඟ වතාවේ හමුවෙමු.
චෙන් වෙයිලියැන්ග්ගේ බ්ලොග් අඩවියේ ( https://www.chenweiliang.com/ ) බෙදාගත් "දෝෂ වාර්තා කිරීම නවත්වන්න! OpenAI අනුකූලතාව සඳහා Cloudflare පහසුවෙන් වින්යාස කරන්න: මූලික URL සහ අතුරුමුහුණත" යන ලිපිය ඔබට ප්රයෝජනවත් වනු ඇතැයි අපි බලාපොරොත්තු වෙමු.
මෙම ලිපියේ සබැඳිය බෙදා ගැනීමට නිදහස් වන්න: https://www.chenweiliang.com/cwl-34252.html
