Ieqaf tirċevi żbalji! Ikkonfigura faċilment il-URL Bażi u l-API ta' Cloudflare għall-kompatibilità mal-OpenAI.

Għaliex il-URL bażi tal-Cloudflare AI tiegħi dejjem qed jirritorna żball 404?

Dan l-artiklu jgħallmek f'sekondi kif tikseb u tikkonfigura malajr URL bażi tal-OpenAI kompatibbli ma' Cloudflare. Jinkludi mudelli perfetti għal REST API uffiċjali, format AI Gateway, u klijenti ta' partijiet terzi (Dify/One-API), u jgħinek tibda taħdem AI APIs b'xejn b'klikk waħda!

Il-ġimgħa li għaddiet, ħabib li jagħmel żvilupp indipendenti f'daqqa waħda kkuntattjani u bagħatli screenshot li juri skrin mimli żbalji 401. Huwa qalli, "Ħija, ilni nipprova niddibaggja l-API tal-AI ta' Cloudflare il-ġurnata kollha, imma sempliċement ma jaħdimx."

Tajt ħarsa lejn il-kodiċi tiegħu. Il-Base URL kien issettjat għal /ai/v1, iżda l-korp tat-talba kien ifformattjat bħala r-REST API uffiċjali, għalhekk it-tnejn ma kinux jaqblu xejn.

Huwa qal li ried biss juża l-SDK tal-OpenAI biex isib debug fuq mudell fuq il-Workers AI, hemm xi problema?

Din hija problema kbira.

Is-servizzi tal-AI ta' Cloudflare jużaw tliet URLs bażi kompletament differenti skont ix-xenarju. Kull wieħed għandu l-format u x-xenarji applikabbli tiegħu. Għalkemm hemm dokumentazzjoni, din hija mxerrda fuq paġni differenti, u dan jagħmilha diffiċli li tkun taf liema waħda għandek tirreferi għaliha fl-ewwel tentattiv tiegħek. L-użu tal-URL żbaljat jirriżulta fi żball 401 jew 400, li ma jħallikx taċċessa s-servizz.

Meta ltqajt ma' din il-problema għall-ewwel darba, ippruvajt diversi drabi qabel ma sibt is-soluzzjoni. Bqajt bla kliem inħares lejn l-iskrin mimli messaġġi ta' żball.

Illum se npinġi dawn it-tliet toroq b'mod ċar għalik, sabiex ma tagħmilx aktar żbalji wara li taqra dan.

Ieqaf tirċevi żbalji! Ikkonfigura faċilment il-URL Bażi u l-API ta' Cloudflare għall-kompatibilità mal-OpenAI.

URL Bażi tal-Interfaċċja Kompatibbli mal-OpenAI

Nibdew bl-aktar waħda użata komunement.

Jekk qed tuża l-OpenAI SDK, jew għodod li jappoġġjaw formati OpenAI personalizzati bħal LangChain, Dify, NextChat, jew One-API, allura dan huwa l-approċċ korrett.

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

Din hija xi ħaġa li Cloudflare iddisinjat speċifikament biex tallinja mal-format tal-interfaċċja OpenAI. Żid `/chat/completions` wara l-endpoint tad-djalogu komplut. Ibdel il-URL tal-Bażi OpenAI oriġinali tiegħek b'dan, u ibdel l-API Key bit-token Cloudflare tiegħek, u għandu jaħdem direttament. Ippruvajt mudelli bħal `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` u `@cf/meta/llama-3.1-8b-instruct`, u kollha jaħdmu tajjeb.

Madankollu, għandu jiġi nnutat li dan jappoġġja biss mudelli ta' djalogu bbażati fuq test.

L-API REST nattiva uffiċjali ta' Cloudflare

Jekk teħtieġ li tuża Stable Diffusion għall-grafika, Whisper għat-traskrizzjoni tal-awdjo, jew kwalunkwe mudell mhux testwali, ħu t-tieni rotta, li hija l-API REST nattiva uffiċjali ta' Cloudflare.

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

L-isem tal-mudell jista' jinkiteb fil-mogħdija, bħal /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, jew jista' jitqiegħed fil-qasam `model` tal-korp tar-rikjesta. Nippreferi npoġġih fil-qasam; il-mogħdija hija iqsar u aktar nadifa. Għall-ewwel kont konfuż dwar dan id-dettall ukoll. Xi mudelli jaċċettaw iż-żewġ metodi, filwaqt li oħrajn jaċċettaw wieħed biss. Oqgħod attent għal dan meta tiċċekkja d-dokumentazzjoni.

URL Bażi tal-AI Gateway

Hemm it-tielet mod: AI Gateway.

Dan ix-xenarju huwa kemxejn differenti. Jekk waqqaft AI Gateway fil-backend ta' Cloudflare biex tipproxyja APIs ta' partijiet terzi, bħal pereżempju t-trażmissjoni ta' talbiet OpenAI permezz tal-Cloudflare gateway għall-caching, il-monitoraġġ, u l-limitazzjoni tar-rata, allura l-Base URL tkun...

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

Iż-żieda ta' `/chat/completions` wara l-endpoint komplut tiżgura li t-traffiku kollu jgħaddi mill-gateway ta' Cloudflare, u l-pannell tal-log juri l-latenza u r-riżultat ta' kull talba. Din il-karatteristika hija utli ħafna hekk kif it-tim jikber b'aktar proġetti, u telimina l-ħtieġa li wieħed ifittex id-dejta mill-backends ta' diversi bejjiegħa wieħed wieħed.

Kif tagħżel: Tliet settijiet ta' URLs spjegati f'sentenza waħda.

Okay, dan ikopri t-tliet mogħdijiet. Fil-qosor, hemm prinċipju wieħed biss.

It-triq li tieħu tiddependi mill-għodda li tuża.

Biex tuża l-OpenAI SDK biex issejjaħ mudell ta' djalogu, mur fuq `/ai/v1`. Biex issejjaħ mudell ta' immaġni/awdjo, mur fuq `/ai/run`. Għal ġestjoni unifikata permezz ta' gateway, mur fuq `/gateway/`. Il-metodu ta' awtentikazzjoni huwa l-istess: poġġi `Authorization: Bearer` segwit mit-Token tal-API tiegħek fil-header. Oħloq it-Token fil-backend ta' Cloudflare, u ftakar li tiċċekkja l-permess `Workers AI: Edit`.

Fejn issib l-account_id? Idħol fil-pannell tal-amministrazzjoni ta' Cloudflare tiegħek, skrollja 'l isfel sas-sezzjoni tal-API fil-ġenb tal-lemin, jew iċċekkja l-address bar tal-browser tiegħek; dik l-istring alfanumerika ta' 32 karattru hija dik.

Onestament, wara li għent lil sieħbi jlestiha dakinhar, qalli xi ħaġa li naħseb li hija pjuttost korretta: ma kienx li ma kontx naf kif, iżda li d-dokumentazzjoni ma kinitx spjegatli b'mod ċar.

Ħafna konfigurazzjonijiet tekniċi huma bħal dawn. Mhux li huma partikolarment diffiċli, iżda hemm wisq punti tad-dħul, u dan jagħmilha faċli li tintilef fl-ewwel tentattiv tiegħek. Jekk iltqajt ma' diversi żbalji inspjegabbli meta kkonfigurajt Cloudflare AI, x'aktarx li dan huwa minħabba URL Bażi mhux korrett jew format ifformattjat ħażin. Żomm dawn it-tliet settijiet ta' URLs fil-qrib; tista' faċilment issib dak korrett id-darba li jmiss.

Ta' xejn.

Mela, ladarba qrajt s'hawn, jekk sibtha utli, jekk jogħġbok agħti like u aqsamha. Jekk trid tirċievi aġġornamenti l-ewwel, tista' wkoll issegwini! ⭐

Grazzi talli qrajt l-artiklu tiegħi. Narak id-darba li jmiss.

发表 评论

您的邮箱地址不会被公开。必填项已用*标注

Skrollja Top