Drejtoria e artikujve
Pse URL-ja ime bazë e inteligjencës artificiale në Cloudflare kthen gjithmonë një gabim 404?
Ky artikull ju mëson brenda sekondash se si të merrni dhe konfiguroni shpejt një URL bazë OpenAI të pajtueshme me Cloudflare. Ai përfshin shabllone perfekte për API-në zyrtare REST, formatin AI Gateway dhe klientët e palëve të treta (Dify/One-API), duke ju ndihmuar të vini në punë API-të falas të AI-së me një klikim të vetëm!
Javën e kaluar, një mik që merret me zhvillim të pavarur më kontaktoi papritur dhe më dërgoi një pamje të ekranit që tregonte një ekran plot me gabime 401. Ai tha: "Vëlla, kam provuar gjithë ditën të debugoj API-n e inteligjencës artificiale të Cloudflare, por thjesht nuk funksionon."
I hodha një sy kodit të tij. URL-ja bazë ishte vendosur në /ai/v1, por trupi i kërkesës ishte formatuar si API-ja zyrtare REST, kështu që të dyja nuk përputheshin fare.
Ai tha se donte vetëm të përdorte SDK-në e OpenAI-t për të debuguar një model në IA-në e Punëtorëve, a ka ndonjë problem?
Ky është një problem i madh.
Shërbimet e inteligjencës artificiale të Cloudflare përdorin tre URL bazë krejtësisht të ndryshme në varësi të skenarit. Secila ka formatin e vet dhe skenarët e zbatueshëm. Edhe pse ka dokumentacion, ai është i shpërndarë nëpër faqe të ndryshme, duke e bërë të vështirë të dish se cilës t'i referohesh në përpjekjen e parë. Përdorimi i URL-së së gabuar do të rezultojë në një gabim 401 ose 400, duke ju penguar të hyni në shërbim.
Kur hasa për herë të parë këtë problem, u përpoqa disa herë para se ta zgjidhja. Mbeta pa fjalë duke parë ekranin plot me mesazhe gabimi.
Sot do t'i vizatoj qartë këto tre rrugë për ju, në mënyrë që të mos bëni gabime të tjera pasi ta lexoni këtë.

URL-ja bazë e ndërfaqes së pajtueshme me OpenAI
Le të fillojmë me atë që përdoret më shpesh.
Nëse po përdorni OpenAI SDK ose mjete që mbështesin formate të personalizuara të OpenAI si LangChain, Dify, NextChat ose One-API, atëherë kjo është qasja e saktë.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
Kjo është diçka që Cloudflare e ka projektuar posaçërisht për t'u përshtatur me formatin e ndërfaqes OpenAI. Shtoni `/chat/completions` pas pikës fundore të dialogut të plotë. Zëvendësoni URL-në tuaj origjinale të OpenAI Bazë me këtë dhe zëvendësoni Çelësin API me token-in tuaj Cloudflare dhe duhet të funksionojë direkt. Kam provuar modele si `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` dhe `@cf/meta/llama-3.1-8b-instruct`, dhe të gjitha funksionojnë mirë.
Megjithatë, duhet theksuar se kjo mbështet vetëm modelet e dialogut të bazuara në tekst.
API-ja zyrtare vendase REST e Cloudflare-it
Nëse ju duhet të përdorni Stable Diffusion për grafikë, Whisper për transkriptim audio ose ndonjë model jo-tekst, merrni rrugën e dytë, e cila është API-ja zyrtare native REST e Cloudflare.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
Emri i modelit mund të shkruhet në shteg, si p.sh. /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, ose mund të vendoset në fushën `model` të trupit të kërkesës. Unë preferoj ta vendos në fushë; shtegu është më i shkurtër dhe më i qartë. Edhe unë u ngatërrova me këtë detaj në fillim. Disa modele pranojnë të dyja metodat, ndërsa të tjerë pranojnë vetëm njërën. Kushtojini vëmendje kësaj kur kontrolloni dokumentacionin.
URL-ja bazë e portës AI
Ekziston një mënyrë e tretë: AI Gateway.
Ky skenar është paksa i ndryshëm. Nëse keni konfiguruar një AI Gateway në backend-in e Cloudflare për të ndërmjetësuar API-të e palëve të treta, siç është përcjellja e kërkesave OpenAI përmes Cloudflare Gateway për ruajtjen në memorje, monitorimin dhe kufizimin e shpejtësisë, atëherë URL-ja Bazë do të ishte...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
Shtimi i `/chat/completions` pas pikës fundore të plotë siguron që i gjithë trafiku të kalojë nëpër portën Cloudflare, dhe paneli i regjistrit tregon vonesën dhe rezultatin e secilës kërkesë. Kjo veçori është jashtëzakonisht e dobishme ndërsa ekipi rritet me më shumë projekte, duke eliminuar nevojën për të kërkuar të dhëna nga backend-et e shitësve të ndryshëm një nga një.
Si të zgjidhni: Tre grupe URL-sh të shpjeguara në një fjali.
Në rregull, kjo mbulon të treja rrugët. Si përmbledhje, ekziston vetëm një parim.
Rruga që ndiqni varet nga mjetet që përdorni.
Për të përdorur OpenAI SDK për të thirrur një model dialogu, shkoni te `/ai/v1`. Për të thirrur një model imazhi/audio, shkoni te `/ai/run`. Për menaxhim të unifikuar nëpërmjet një porte hyrëse, shkoni te `/gateway/`. Metoda e autentifikimit është e njëjtë: vendosni `Authorization: Bearer` të ndjekur nga API Token tuaj në kokë. Krijoni Tokenin në backend-in e Cloudflare dhe mos harroni të kontrolloni lejen `Workers AI: Edit`.
Ku mund ta gjej account_id? Hyni në panelin e administratorit të Cloudflare, shkoni poshtë te seksioni API në shiritin anësor të djathtë ose kontrolloni shiritin e adresës së shfletuesit tuaj; ai varg alfanumerik me 32 karaktere është ai.
Sinqerisht, pasi e ndihmova mikun tim ta përfundonte atë ditë, ai më tha diçka që mendoj se është mjaft e saktë: nuk ishte se nuk dija si, por se dokumentacioni nuk ma kishte shpjeguar qartë.
Shumë konfigurime teknike janë të tilla. Nuk është se janë veçanërisht të vështira, por ka shumë pika hyrëse, duke e bërë të lehtë të humbasësh në përpjekjen e parë. Nëse keni hasur gabime të ndryshme të pashpjegueshme gjatë konfigurimit të Cloudflare AI, ka shumë të ngjarë që kjo të jetë për shkak të një URL-je Bazë të gabuar ose një formati të keqformuar. Mbani këto tre grupe URL-sh afër; herën tjetër mund ta gjeni lehtësisht atë të saktë.
不用谢.
Pra, meqë e keni lexuar deri këtu, nëse e keni gjetur të dobishme, ju lutem pëlqeni dhe shpërndajeni. Nëse doni të merrni përditësime të parat, mund të më ndiqni edhe mua! ⭐
Faleminderit që lexuat artikullin tim. Shihemi herën tjetër.
Shpresojmë që artikulli "Ndalo raportimin e gabimeve! Konfiguro lehtësisht Cloudflare për kompatibilitetin OpenAI: URL-ja bazë dhe ndërfaqja" i ndarë në blogun e Chen Weiliang ( https://www.chenweiliang.com/ ) do t'ju jetë i dobishëm.
Ndihuni të lirë të ndani lidhjen e këtij artikulli: https://www.chenweiliang.com/cwl-34252.html
