Դադարեք սխալներ ստանալ: Հեշտությամբ կարգավորեք Cloudflare-ի հիմնական URL-ը և API-ը՝ OpenAI համատեղելիության համար:

CloudFlare AI Ինչո՞ւ է բազային URL-ը միշտ վերադարձնում 404 սխալ։

Այս հոդվածը վայրկյանների ընթացքում կսովորեցնի ձեզ, թե ինչպես արագորեն ստանալ և կարգավորել Cloudflare-ի հետ համատեղելի OpenAI բազային URL: Այն ներառում է կատարյալ ձևանմուշներ պաշտոնական REST API-ի, AI Gateway ձևաչափի և երրորդ կողմի հաճախորդների (Dify/One-API) համար, որոնք կօգնեն ձեզ մեկ սեղմումով գործարկել անվճար AI API-ները:

Անցյալ շաբաթ մի ընկեր, որը զբաղվում է անկախ մշակմամբ, հանկարծ կապվեց ինձ հետ և ուղարկեց էկրանի նկար, որը լի էր 401 սխալներով։ Նա ասաց. «Եղբայր, ես ամբողջ օրը փորձում էի Cloudflare-ի AI API-ը վրիպակել, բայց դա պարզապես չի աշխատում»։

Ես նայեցի նրա կոդին։ Հիմնական URL-ը սահմանված էր /ai/v1, բայց հարցման մարմինը ձևաչափված էր որպես պաշտոնական REST API, ուստի երկուսն էլ ընդհանրապես չէին համընկնում։

Նա ասաց, որ պարզապես ուզում է օգտագործել OpenAI-ի SDK-ն՝ աշխատողների արհեստական ​​բանականության մոդելը վրիպազերծելու համար, կա՞ որևէ խնդիր։

Սա մեծ խնդիր է։

Cloudflare-ի արհեստական ​​բանականության ծառայությունները օգտագործում են երեք բոլորովին տարբեր բազային 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

Սա 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-ը կամ որևէ ոչ տեքստային մոդել, ընտրեք երկրորդ ճանապարհը՝ Cloudflare-ի պաշտոնական բնիկ REST API-ը։

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

Մոդելի անունը կարող է գրվել ուղու մեջ, օրինակ՝ /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, կամ այն ​​կարող է տեղադրվել հարցման մարմնի `model` դաշտում: Ես նախընտրում եմ այն ​​տեղադրել դաշտում. ուղին ավելի կարճ է և ավելի պարզ: Սկզբում ես նույնպես շփոթվեցի այս մանրամասնության հետ: Որոշ մոդելներ ընդունում են երկու մեթոդներն էլ, մինչդեռ մյուսները՝ միայն մեկը: Ուշադրություն դարձրեք դրան փաստաթղթերը ստուգելիս:

AI Gateway Base URL

Կա երրորդ ճանապարհ՝ AI Gateway:

Այս սցենարը մի փոքր այլ է։ Եթե դուք Cloudflare-ի ներքին համակարգում կարգավորել եք AI Gateway՝ երրորդ կողմի API-ները պրոքսիով ուղարկելու համար, օրինակ՝ OpenAI հարցումները Cloudflare Gateway-ի միջոցով քեշավորման, մոնիթորինգի և արագության սահմանափակման համար փոխանցելու համար, ապա Base URL-ը կլինի...

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

Ավարտական ​​կետից հետո `/chat/completions` ավելացնելը ապահովում է, որ ամբողջ երթևեկությունն անցնի Cloudflare դարպասով, իսկ գրանցամատյանի վահանակը ցույց է տալիս յուրաքանչյուր հարցման լատենտությունը և արդյունքը: Այս գործառույթը աներևակայելի օգտակար է, քանի որ թիմը մեծանում է ավելի շատ նախագծերով, վերացնելով տարբեր մատակարարների backend-ներից տվյալները մեկ առ մեկ որոնելու անհրաժեշտությունը:

Ինչպես ընտրել. URL-ների երեք հավաքածու՝ բացատրված մեկ նախադասությամբ։

Լավ, դա ներառում է երեք ուղիները։ Ամփոփելով՝ կա միայն մեկ սկզբունք։

Ընտրած ուղին կախված է ձեր օգտագործած գործիքներից։

OpenAI SDK-ն երկխոսության մոդել կանչելու համար օգտագործեք `/ai/v1`: Պատկերի/ձայնի մոդել կանչելու համար անցեք `/ai/run`: Gateway-ի միջոցով միասնական կառավարման համար անցեք `/gateway/`: Նույնականացման մեթոդը նույնն է. վերնագրում տեղադրեք `Authorization: Bearer`, որին հաջորդում է ձեր API Token-ը: Ստեղծեք Token-ը Cloudflare-ի backend-ում և մի մոռացեք ստուգել `Workers AI: Edit` թույլտվությունը:

Որտե՞ղ գտնել account_id-ն։ Մուտք գործեք ձեր Cloudflare-ի կառավարման վահանակ, գլորեք ներքև՝ աջ կողային վահանակի API բաժինը, կամ ստուգեք ձեր դիտարկիչի հասցեի դաշտը. այդ 32 նիշանոց տառաթվային տողն է այն։

Անկեղծ ասած, այդ օրը ընկերոջս օգնելուց հետո նա ինձ մի բան ասաց, որը, կարծում եմ, բավականին ճիշտ է. խնդիրը նրանում չէր, որ ես չգիտեի՝ ինչպես, այլ նրանում, որ փաստաթղթերը ինձ համար դա հստակ չէին բացատրել։

Շատ տեխնիկական կարգավորումներ այսպիսին են։ Բանը նրանում չէ, որ դրանք հատկապես դժվար են, բայց կան չափազանց շատ մուտքի կետեր, ինչը հեշտացնում է առաջին փորձից մոլորվելը։ Եթե Cloudflare AI-ը կարգավորելիս հանդիպել եք տարբեր անհասկանալի սխալների, ապա, ամենայն հավանականությամբ, դա սխալ Base URL-ի կամ սխալ ձևաչափի պատճառով է։ Պահեք URL-ների այս երեք հավաքածուները ձեռքի տակ. հաջորդ անգամ հեշտությամբ կարող եք գտնել ճիշտը։

Խնդրեմ։

Այսպիսով, քանի որ կարդացել եք մինչև այս պահը, եթե այն օգտակար էր ձեզ համար, խնդրում եմ հավանեք և կիսվեք դրանով։ Եթե ուզում եք առաջինը ստանալ թարմացումներ, կարող եք նաև հետևել ինձ։ ⭐

Շնորհակալություն եմ հայտնում իմ հոդվածը կարդալու համար։ Կհանդիպենք հաջորդ անգամ։