Sispann jwenn erè! Konfigire URL debaz ak API Cloudflare a fasilman pou konpatibilite ak OpenAI.

Poukisa URL baz Cloudflare AI mwen an toujou retounen yon erè 404?

Atik sa a anseye w an kèk segond kijan pou w jwenn epi konfigire yon URL baz OpenAI konpatib ak Cloudflare byen rapid. Li gen ladan l modèl pafè pou API REST ofisyèl la, fòma AI Gateway la, ak kliyan twazyèm pati yo (Dify/One-API), pou ede w mete API AI gratis yo an fonksyon ak yon sèl klike!

Semèn pase a, yon zanmi ki fè devlopman endepandan te kontakte m sibitman epi li te voye yon kopi ekran ki montre yon ekran plen ak erè 401. Li te di, "Frè m, mwen te ap eseye debogaj API IA Cloudflare a tout jounen an, men li pa vle mache."

Mwen te voye yon je sou kòd li a. URL baz la te fikse sou /ai/v1, men kò demann lan te fòmate kòm API REST ofisyèl la, kidonk de yo pa t koresponn ditou.

Li te di li te jis vle itilize SDK OpenAI a pou debogaj yon modèl sou Workers AI, èske gen nenpòt pwoblèm?

Sa a se yon gwo pwoblèm.

Sèvis IA Cloudflare yo itilize twa URL debaz konplètman diferan selon senaryo a. Chak gen pwòp fòma li ak senaryo ki aplikab li yo. Malgre ke gen dokimantasyon, li gaye sou diferan paj, sa ki fè li difisil pou konnen kilès pou w al gade nan premye tantativ ou a. Sèvi ak move URL la ap lakòz yon erè 401 oswa 400, ki anpeche w jwenn aksè nan sèvis la.

Lè m te rankontre pwoblèm sa a pou premye fwa, mwen te eseye plizyè fwa anvan m te jwenn yon solisyon. Mwen te rete san pawòl lè m t ap gade ekran an plen mesaj erè.

Jodi a m ap trase twa wout sa yo byen klè pou ou, pou ou pa fè okenn erè ankò apre ou fin li sa.

URL baz entèfas konpatib OpenAI a

Ann kòmanse ak sa ki pi souvan itilize a.

Si w ap itilize OpenAI SDK a, oubyen zouti ki sipòte fòma OpenAI pèsonalize tankou LangChain, Dify, NextChat, oubyen One-API, alò sa a se bon apwòch la.

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

Sa a se yon bagay Cloudflare te espesyalman kreye pou l aliyen ak fòma koòdone OpenAI a. Ajoute `/chat/completions` apre pwen final dyalòg konplè a. Ranplase URL baz OpenAI orijinal ou a ak sa a, epi ranplase kle API a ak jeton Cloudflare ou a, epi li ta dwe fonksyone dirèkteman. Mwen te eseye modèl tankou `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` ak `@cf/meta/llama-3.1-8b-instruct`, epi yo tout fonksyone byen.

Sepandan, li enpòtan pou note ke sa a sèlman sipòte modèl dyalòg ki baze sou tèks.

API REST natif ofisyèl Cloudflare a

Si ou bezwen itilize Stable Diffusion pou fè graf, Whisper pou transkripsyon odyo, oubyen nenpòt modèl ki pa tèks, pran dezyèm wout la, ki se API REST natif natal ofisyèl Cloudflare la.

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

Ou ka ekri non modèl la nan chemen an, tankou /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, oubyen ou ka mete l nan chan `model` nan kò demann lan. Mwen prefere mete l nan chan an; chemen an pi kout e pi pwòp. Okòmansman, mwen te konfonn sou detay sa a tou. Gen kèk modèl ki aksepte tou de metòd yo, alòske gen lòt ki aksepte youn sèlman. Fè atansyon ak sa lè w ap tcheke dokimantasyon an.

URL baz IA Gateway la

Gen yon twazyèm fason: AI Gateway.

Senaryo sa a yon ti jan diferan. Si ou te mete kanpe yon AI Gateway nan backend Cloudflare la pou sèvi kòm proxy pou API twazyèm pati yo, tankou voye demann OpenAI atravè Cloudflare gateway la pou caching, siveyans, ak limitasyon vitès, alò URL debaz la ta dwe...

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

Ajoute `/chat/completions` apre pwen final konplè a asire tout trafik la pase nan pòtay Cloudflare a, epi panèl jounal la montre latans ak rezilta chak demann. Fonksyonalite sa a vrèman itil pandan ekip la ap grandi ak plis pwojè, sa elimine nesesite pou fouye nan done ki soti nan backend divès vandè yo youn pa youn.

Kijan pou chwazi: Twa seri URL eksplike nan yon sèl fraz.

Oke, sa kouvri twa chemen yo. An rezime, gen yon sèl prensip.

Chemen ou pran an depann de zouti ou itilize yo.

Pou itilize OpenAI SDK a pou rele yon modèl dyalòg, ale nan `/ai/v1`. Pou rele yon modèl imaj/odyo, ale nan `/ai/run`. Pou yon jesyon inifye atravè yon pòtay, ale nan `/gateway/`. Metòd otantifikasyon an se menm bagay la: mete `Authorization: Bearer` ki te swiv pa jeton API ou a nan header la. Kreye jeton an nan backend Cloudflare la, epi sonje tcheke pèmisyon `Workers AI: Edit` la.

Ki kote pou jwenn account_id la? Konekte sou panèl administrasyon Cloudflare ou a, desann nan seksyon API a nan ba bò dwat la, oubyen tcheke ba adrès navigatè w la; se chèn alfanimerik 32 karaktè sa a ki li.

Onètman, apre m te fin ede zanmi m nan fè l jou sa a, li te di m yon bagay ke m panse ki byen kòrèk: se pa t paske m pa t konnen kijan pou m fè l, se paske dokiman yo pa t eksplike m sa byen klè.

Anpil konfigirasyon teknik se konsa. Se pa paske yo patikilyèman difisil, men gen twòp pwen antre, sa ki fè li fasil pou ou pèdi nan premye esè ou a. Si ou te rankontre plizyè erè eneksplikab lè w ap konfigire Cloudflare AI, gen plis chans pou se akòz yon URL debaz ki pa kòrèk oswa yon fòma ki mal fòmate. Kenbe twa seri URL sa yo sou la men; ou ka fasilman jwenn youn ki kòrèk la pwochen fwa.

De rien.

Kidonk, piske ou fin li tout sa, si ou te twouve l itil, tanpri like li epi pataje li. Si ou vle resevwa dènye nouvèl yo an premye, ou ka swiv mwen tou! ⭐

Mèsi paske ou li atik mwen an. N a wè pita.