مقالې لارښود
ولې زما د Cloudflare AI اساس URL تل 404 تېروتنه راګرځوي؟
دا مقاله تاسو ته په څو ثانیو کې درس درکوي چې څنګه د کلاوډ فلیر سره مطابقت لرونکی OpenAI اساس URL په چټکۍ سره ترلاسه او تنظیم کړئ. دا د رسمي REST API، AI ګیټ وے فارمیټ، او دریمې ډلې مراجعینو (Dify/One-API) لپاره مناسب ټیمپلیټونه لري، چې تاسو سره مرسته کوي چې وړیا AI APIs په یو کلیک سره فعال او فعال کړئ!
تېره اونۍ، یو ملګری چې خپلواک پرمختګ کوي ناڅاپه له ما سره اړیکه ونیوله او ماته یې یو سکرین شاټ واستاوه چې د 401 غلطیو څخه ډک سکرین ښیې. هغه وویل، "وروره، زه ټوله ورځ د کلاوډ فلیر AI API ډیبګ کولو هڅه کوم، مګر دا به کار ونکړي."
ما د هغه کوډ ته وکتل. د اساس URL /ai/v1 ته ټاکل شوی و، مګر د غوښتنې بدن د رسمي REST API په توګه فارمیټ شوی و، نو دواړه په هیڅ ډول سره سمون نه خوري.
هغه وویل چې هغه یوازې غوښتل چې د OpenAI SDK څخه کار واخلي ترڅو د کارګرانو AI ماډل ډیبګ کړي، ایا کومه ستونزه شته؟
دا یوه لویه ستونزه ده.
د کلاوډ فلیر د مصنوعي ذهانت خدمتونه د سناریو پورې اړه لري درې په بشپړه توګه مختلف اساس URLونه کاروي. هر یو یې خپل بڼه او د تطبیق وړ سناریوګانې لري. که څه هم اسناد شتون لري، دا په مختلفو پاڼو کې خپاره شوي، چې دا ستونزمن کوي چې پوه شئ چې ستاسو په لومړۍ هڅه کې کوم یو ته مراجعه وکړئ. د غلط URL کارول به د 401 یا 400 غلطۍ پایله ولري، چې تاسو به خدماتو ته د لاسرسي مخه ونیسي.
کله چې زه د لومړي ځل لپاره له دې ستونزې سره مخ شوم، ما څو ځله هڅه وکړه مخکې له دې چې دا معلومه کړم. زه بې غږه وم او د تېروتنې پیغامونو څخه ډک سکرین ته مې کتل.
نن به زه ستاسو لپاره دا درې لارې په روښانه ډول رسم کړم، نو تاسو به د دې لوستلو وروسته نور غلطۍ ونه کړئ.
د OpenAI مطابقت لرونکی انٹرفیس اساس URL
راځئ چې د تر ټولو عام کارول شوي سره پیل وکړو.
که تاسو د OpenAI SDK کاروئ، یا هغه وسایل چې د دودیز OpenAI فارمیټونو ملاتړ کوي لکه LangChain، Dify، NextChat، یا One-API، نو دا سمه لاره ده.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
دا هغه څه دي چې کلاوډ فلیر په ځانګړي ډول د OpenAI انٹرفیس فارمیټ سره سمون لپاره ډیزاین شوي. د بشپړ ډیالوګ پای ټکی وروسته `/chat/completions` اضافه کړئ. خپل اصلي OpenAI بیس URL د دې سره بدل کړئ، او د API کیلي د خپل کلاوډ فلیر ټوکن سره بدل کړئ، او دا باید مستقیم چلیږي. ما د `@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، یا دا د غوښتنې د بدن په "ماډل" ساحه کې کیښودل کیدی شي. زه غوره ګڼم چې دا په ساحه کې واچوم؛ لاره لنډه او پاکه ده. زه په لومړي سر کې د دې توضیحاتو په اړه هم مغشوش وم. ځینې ماډلونه دواړه میتودونه مني، پداسې حال کې چې نور یوازې یو مني. د اسنادو چک کولو پر مهال دې ته پام وکړئ.
د AI ګیټ وی اساس URL
دریمه لاره هم شته: د مصنوعي ذهانت دروازه.
دا سناریو یو څه توپیر لري. که تاسو د کلاوډ فلیر بیک اینډ کې د دریمې ډلې پراکسي APIs ته د AI ګیټ وے تنظیم کړی وي، لکه د کیچ کولو، څارنې، او نرخ محدودولو لپاره د کلاوډ فلیر ګیټ وے له لارې د OpenAI غوښتنې لیږل، نو د اساس URL به وي ...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
د بشپړ پای ټکي وروسته د `/chat/completions` اضافه کول ډاډ ورکوي چې ټول ټرافیک د Cloudflare دروازې له لارې ځي، او د لاګ پینل د هرې غوښتنې ځنډ او پایله ښیې. دا ځانګړتیا خورا ګټوره ده ځکه چې ټیم د ډیرو پروژو سره وده کوي، د مختلفو پلورونکو د بیک اینډونو څخه د معلوماتو له لارې یو په یو لټون کولو اړتیا له منځه وړي.
څنګه انتخاب وکړو: د URLs درې سیټونه په یوه جمله کې تشریح شوي.
سمه ده، دا درې لارې پوښي. په لنډه توګه، یوازې یو اصل شتون لري.
هغه لاره چې تاسو یې اخلئ د هغو وسایلو پورې اړه لري چې تاسو یې کاروئ.
د ډیالوګ ماډل زنګ وهلو لپاره د OpenAI SDK کارولو لپاره، `/ai/v1` ته لاړ شئ. د عکس/آډیو ماډل زنګ وهلو لپاره، `/ai/run` ته لاړ شئ. د ګیټ وی له لارې د متحد مدیریت لپاره، `/gateway/` ته لاړ شئ. د تصدیق کولو طریقه ورته ده: `Authorization: Bearer` ولیکئ او وروسته په سرلیک کې خپل API ټوکن ولیکئ. په کلاوډ فلیر بیک اینډ کې ټوکن جوړ کړئ، او په یاد ولرئ چې د `Workers AI: Edit` اجازه وګورئ.
د account_id چیرته ومومئ؟ خپل Cloudflare اډمین پینل ته ننوځئ، په ښي اړخ کې د API برخې ته ښکته شئ، یا د خپل براوزر د پتې بار وګورئ؛ دا د 32 حروفو الفانومیریک تار دی.
په ریښتیا سره، وروسته له هغه چې ما په هغه ورځ له خپل ملګري سره د کار په ترسره کولو کې مرسته وکړه، هغه ماته یو څه وویل چې زه فکر کوم سم دي: دا داسې نه وه چې زه نه پوهیدم چې څنګه، دا دا وه چې اسنادو دا ماته په روښانه توګه نه وو تشریح کړي.
ډیری تخنیکي تشکیلات داسې دي. دا داسې نه ده چې دوی په ځانګړي ډول ستونزمن دي، مګر د ننوتلو ډیر ټکي شتون لري، چې ستاسو په لومړۍ هڅه کې له لاسه ورکول اسانه کوي. که تاسو د Cloudflare AI تنظیم کولو پرمهال له مختلفو نه تشریح کیدونکو غلطیو سره مخ شوي یاست، نو دا ډیری احتمال د غلط اساس URL یا غلط فارمیټ له امله وي. د URLونو دا درې سیټونه په لاس کې وساتئ؛ تاسو کولی شئ په اسانۍ سره بل ځل سم ومومئ.
تاسو ښه راغلاست.
نو، څرنګه چې تاسو تر دې دمه لوستلي دي، که تاسو ګټور وموندل، مهرباني وکړئ خوښ یې کړئ او شریک یې کړئ. که تاسو غواړئ لومړی تازه معلومات ترلاسه کړئ، تاسو کولی شئ ما هم تعقیب کړئ! ⭐
زما د مقالې د لوستلو لپاره مننه. بل ځل به سره ګورو.
هیله ده، د چن وییلینګ په بلاګ ( https://www.chenweiliang.com/ ) کې شریک شوی مقاله "د غلطیو راپور ورکول بند کړئ! د OpenAI مطابقت لپاره په اسانۍ سره کلاوډ فلیر تنظیم کړئ" به ستاسو لپاره ګټوره وي.
د دې مقالې لینک شریکولو لپاره وړیا احساس وکړئ: https://www.chenweiliang.com/cwl-34252.html