പിശകുകൾ വരുന്നത് നിർത്തൂ! OpenAI അനുയോജ്യതയ്ക്കായി Cloudflare-ന്റെ അടിസ്ഥാന URL-ഉം API-യും എളുപ്പത്തിൽ കോൺഫിഗർ ചെയ്യുക.

ച്ലൊഉദ്ഫ്ലരെ AI എന്തുകൊണ്ടാണ് അടിസ്ഥാന URL എപ്പോഴും 404 പിശക് നൽകുന്നത്?

ക്ലൗഡ്ഫ്ലെയറുമായി പൊരുത്തപ്പെടുന്ന ഒരു ഓപ്പൺഎഐ ബേസ് URL എങ്ങനെ വേഗത്തിൽ നേടാമെന്നും കോൺഫിഗർ ചെയ്യാമെന്നും ഈ ലേഖനം നിങ്ങളെ പഠിപ്പിക്കുന്നു. ഔദ്യോഗിക REST API, AI ഗേറ്റ്‌വേ ഫോർമാറ്റ്, മൂന്നാം കക്ഷി ക്ലയന്റുകൾ (Dify/One-API) എന്നിവയ്‌ക്കുള്ള മികച്ച ടെംപ്ലേറ്റുകൾ ഇതിൽ ഉൾപ്പെടുന്നു, ഇത് ഒറ്റ ക്ലിക്കിൽ സൗജന്യ AI API-കൾ പ്രവർത്തിപ്പിക്കാൻ നിങ്ങളെ സഹായിക്കുന്നു!

കഴിഞ്ഞ ആഴ്ച, സ്വതന്ത്ര ഡെവലപ്‌മെന്റ് നടത്തുന്ന ഒരു സുഹൃത്ത് പെട്ടെന്ന് എന്നെ ബന്ധപ്പെടുകയും 401 പിശകുകൾ നിറഞ്ഞ ഒരു സ്‌ക്രീൻഷോട്ട് എനിക്ക് അയച്ചുതരികയും ചെയ്തു. അദ്ദേഹം പറഞ്ഞു, "സഹോദരാ, ഞാൻ ദിവസം മുഴുവൻ ക്ലൗഡ്‌ഫ്ലെയറിന്റെ AI API ഡീബഗ് ചെയ്യാൻ ശ്രമിച്ചു, പക്ഷേ അത് പ്രവർത്തിക്കുന്നില്ല."

ഞാൻ അവന്റെ കോഡിലേക്ക് ഒന്ന് കണ്ണോടിച്ചു. ബേസ് URL /ai/v1 ആയി സജ്ജീകരിച്ചിരുന്നു, പക്ഷേ റിക്വസ്റ്റ് ബോഡി ഔദ്യോഗിക REST API ആയി ഫോർമാറ്റ് ചെയ്‌തിരുന്നു, അതിനാൽ രണ്ടും ഒട്ടും പൊരുത്തപ്പെടുന്നില്ല.

വർക്കേഴ്‌സ് AI-യിലെ ഒരു മോഡൽ ഡീബഗ് ചെയ്യാൻ OpenAI-യുടെ SDK ഉപയോഗിക്കാൻ ആഗ്രഹിക്കുന്നുവെന്ന് അദ്ദേഹം പറഞ്ഞു, എന്തെങ്കിലും പ്രശ്‌നമുണ്ടോ?

ഇത് ഒരു വലിയ പ്രശ്നമാണ്.

സാഹചര്യത്തിനനുസരിച്ച് ക്ലൗഡ്ഫ്ലെയറിന്റെ 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 ബേസ് URL ഇതുപയോഗിച്ച് മാറ്റിസ്ഥാപിക്കുക, കൂടാതെ API കീ നിങ്ങളുടെ Cloudflare ടോക്കൺ ഉപയോഗിച്ച് മാറ്റിസ്ഥാപിക്കുക, അത് നേരിട്ട് പ്രവർത്തിക്കും. `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b`, `@cf/meta/llama-3.1-8b-instruct` പോലുള്ള മോഡലുകൾ ഞാൻ പരീക്ഷിച്ചുനോക്കിയിട്ടുണ്ട്, അവയെല്ലാം നന്നായി പ്രവർത്തിക്കുന്നു.

എന്നിരുന്നാലും, ഇത് ടെക്സ്റ്റ് അധിഷ്ഠിത ഡയലോഗ് മോഡലുകളെ മാത്രമേ പിന്തുണയ്ക്കൂ എന്നത് ശ്രദ്ധിക്കേണ്ടതാണ്.

ക്ലൗഡ്ഫ്ലെയറിന്റെ ഔദ്യോഗിക നേറ്റീവ് 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 ഗേറ്റ്‌വേ വഴി OpenAI അഭ്യർത്ഥനകൾ ഫോർവേഡ് ചെയ്യുന്നത് പോലുള്ള മൂന്നാം കക്ഷി API-കളെ പ്രോക്സി ചെയ്യുന്നതിനായി Cloudflare ബാക്കെൻഡിൽ ഒരു AI ഗേറ്റ്‌വേ സജ്ജീകരിച്ചിട്ടുണ്ടെങ്കിൽ, ബേസ് URL ഇതായിരിക്കും...

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

പൂർണ്ണമായ എൻഡ്‌പോയിന്റിന് ശേഷം `/ചാറ്റ്/പൂർത്തീകരണങ്ങൾ` ചേർക്കുന്നത് എല്ലാ ട്രാഫിക്കും ക്ലൗഡ്‌ഫ്ലെയർ ഗേറ്റ്‌വേയിലൂടെ കടന്നുപോകുന്നുവെന്ന് ഉറപ്പാക്കുന്നു, കൂടാതെ ലോഗ് പാനൽ ഓരോ അഭ്യർത്ഥനയുടെയും കാലതാമസവും ഫലവും കാണിക്കുന്നു. കൂടുതൽ പ്രോജക്റ്റുകളുമായി ടീം വളരുമ്പോൾ ഈ സവിശേഷത അവിശ്വസനീയമാംവിധം ഉപയോഗപ്രദമാണ്, വിവിധ വെണ്ടർമാരുടെ ബാക്കെൻഡുകളിൽ നിന്നുള്ള ഡാറ്റ ഓരോന്നായി തിരയേണ്ടതിന്റെ ആവശ്യകത ഇല്ലാതാക്കുന്നു.

എങ്ങനെ തിരഞ്ഞെടുക്കാം: ഒരു വാക്യത്തിൽ മൂന്ന് സെറ്റ് URL-കൾ വിശദീകരിച്ചിരിക്കുന്നു.

ശരി, അത് മൂന്ന് വഴികളെയും ഉൾക്കൊള്ളുന്നു. ചുരുക്കത്തിൽ, ഒരു തത്വമേയുള്ളൂ.

നിങ്ങൾ ഉപയോഗിക്കുന്ന ഉപകരണങ്ങളെ ആശ്രയിച്ചിരിക്കും നിങ്ങൾ സ്വീകരിക്കുന്ന പാത.

ഒരു ഡയലോഗ് മോഡൽ വിളിക്കാൻ OpenAI SDK ഉപയോഗിക്കാൻ, `/ai/v1` എന്നതിലേക്ക് പോകുക. ഒരു ഇമേജ്/ഓഡിയോ മോഡൽ വിളിക്കാൻ, `/ai/run` എന്നതിലേക്ക് പോകുക. ഒരു ഗേറ്റ്‌വേ വഴിയുള്ള ഏകീകൃത മാനേജ്‌മെന്റിനായി, `/gateway/` എന്നതിലേക്ക് പോകുക. പ്രാമാണീകരണ രീതി ഒന്നുതന്നെയാണ്: `Authorization: Bearer` എന്നതിന് ശേഷം നിങ്ങളുടെ API ടോക്കൺ ഹെഡറിൽ ഇടുക. Cloudflare ബാക്കെൻഡിൽ ടോക്കൺ സൃഷ്ടിക്കുക, കൂടാതെ `Workers AI: Edit` അനുമതി പരിശോധിക്കാൻ ഓർമ്മിക്കുക.

അക്കൗണ്ട്_ഐഡി എവിടെ കണ്ടെത്താം? നിങ്ങളുടെ ക്ലൗഡ്ഫ്ലെയർ അഡ്മിൻ പാനലിൽ ലോഗിൻ ചെയ്യുക, വലത് സൈഡ്ബാറിലെ API വിഭാഗത്തിലേക്ക് താഴേക്ക് സ്ക്രോൾ ചെയ്യുക, അല്ലെങ്കിൽ നിങ്ങളുടെ ബ്രൗസറിന്റെ വിലാസ ബാർ പരിശോധിക്കുക; 32 പ്രതീകങ്ങളുള്ള ആൽഫാന്യൂമെറിക് സ്ട്രിംഗ് അതാണ്.

സത്യം പറഞ്ഞാൽ, ആ ദിവസം ഞാൻ എന്റെ സുഹൃത്തിനെ അത് പൂർത്തിയാക്കാൻ സഹായിച്ചപ്പോൾ, അവൻ എന്നോട് ഒരു കാര്യം പറഞ്ഞു, അത് വളരെ ശരിയാണെന്ന് ഞാൻ കരുതുന്നു: അത് എങ്ങനെയെന്ന് എനിക്കറിയില്ലായിരുന്നു എന്നല്ല, ഡോക്യുമെന്റേഷൻ എനിക്ക് അത് വ്യക്തമായി വിശദീകരിച്ചിരുന്നില്ല എന്നതായിരുന്നു.

പല സാങ്കേതിക കോൺഫിഗറേഷനുകളും ഇതുപോലെയാണ്. അവ പ്രത്യേകിച്ച് ബുദ്ധിമുട്ടുള്ളതല്ല, പക്ഷേ വളരെയധികം എൻട്രി പോയിന്റുകൾ ഉള്ളതിനാൽ നിങ്ങളുടെ ആദ്യ ശ്രമത്തിൽ തന്നെ വഴിതെറ്റിപ്പോകുന്നത് എളുപ്പമാണ്. Cloudflare AI കോൺഫിഗർ ചെയ്യുമ്പോൾ നിങ്ങൾക്ക് വിശദീകരിക്കാനാകാത്ത വിവിധ പിശകുകൾ നേരിട്ടിട്ടുണ്ടെങ്കിൽ, അത് മിക്കവാറും തെറ്റായ ബേസ് URL അല്ലെങ്കിൽ തെറ്റായി ഫോർമാറ്റ് ചെയ്ത ഫോർമാറ്റ് മൂലമാകാം. ഈ മൂന്ന് സെറ്റ് URL-കളും എളുപ്പത്തിൽ സൂക്ഷിക്കുക; അടുത്ത തവണ നിങ്ങൾക്ക് ശരിയായത് എളുപ്പത്തിൽ കണ്ടെത്താനാകും.

不用谢.

അതുകൊണ്ട്, ഇതുവരെ വായിച്ചതിനാൽ, ഇത് സഹായകരമാണെന്ന് തോന്നിയാൽ, ദയവായി ലൈക്ക് ചെയ്ത് ഷെയർ ചെയ്യുക. ആദ്യം അപ്‌ഡേറ്റുകൾ ലഭിക്കണമെങ്കിൽ, നിങ്ങൾക്ക് എന്നെ പിന്തുടരാനും കഴിയും! ⭐

എന്റെ ലേഖനം വായിച്ചതിന് നന്ദി. അടുത്ത തവണ കാണാം.