Artikel Directory
Wêrom jout myn Cloudflare AI basis-URL altyd in 404-flater werom?
Dit artikel leart jo yn sekonden hoe't jo fluch in Cloudflare-kompatibele OpenAI-basis-URL krije en konfigurearje kinne. It befettet perfekte sjabloanen foar offisjele REST API, AI Gateway-formaat en kliïnten fan tredden (Dify/One-API), wêrtroch jo mei ien klik fergese AI API's kinne brûke!
Ferline wike naam in freon dy't ûnôfhinklike ûntwikkeling docht ynienen kontakt mei my op en stjoerde my in skermôfbylding mei in skerm fol mei 401-flaters. Hy sei: "Broer, ik haw de hiele dei besocht de AI API fan Cloudflare te debuggen, mar it wurket gewoan net."
Ik seach nei syn koade. De basis-URL wie ynsteld op /ai/v1, mar de oanfraachtekst wie opmakke as de offisjele REST API, dus de twa kamen hielendal net oerien.
Hy sei dat hy gewoan de SDK fan OpenAI brûke woe om in model op Workers AI te debuggen, is d'r in probleem?
Dit is in grut probleem.
De AI-tsjinsten fan Cloudflare brûke trije folslein ferskillende basis-URL's, ôfhinklik fan it senario. Elk hat syn eigen opmaak en tapasbere senario's. Hoewol d'r dokumintaasje is, is it ferspraat oer ferskate siden, wêrtroch it lestich is om te witten nei hokker jo moatte ferwize by jo earste besykjen. It brûken fan 'e ferkearde URL sil resultearje yn in 401- of 400-flater, wêrtroch jo gjin tagong hawwe ta de tsjinst.
Doe't ik dit probleem foar it earst tsjinkaam, haw ik it ferskate kearen besocht foardat ik it útfûn hie. Ik wie sprakeloos doe't ik nei it skerm fol mei flaterberjochten seach.
Hjoed sil ik dizze trije diken dúdlik foar jo tekenje, sadat jo nei it lêzen hjirfan gjin flaters mear meitsje.

Basis-URL foar OpenAI-kompatibele ynterface
Litte wy begjinne mei de meast brûkte.
As jo de OpenAI SDK brûke, of ark dy't oanpaste OpenAI-formaten stypje lykas LangChain, Dify, NextChat of One-API, dan is dit de juste oanpak.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
Dit is wat Cloudflare spesifyk ûntworpen hat om ôf te stimmen mei it OpenAI-ynterfaceformaat. Foegje `/chat/completions` ta nei it einpunt fan 'e folsleine dialooch. Ferfang jo orizjinele OpenAI Base URL hjirmei, en ferfang de API Key mei jo Cloudflare-token, en it moat direkt rinne. Ik haw modellen besocht lykas `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` en `@cf/meta/llama-3.1-8b-instruct`, en se wurkje allegear prima.
It moat lykwols opmurken wurde dat dit allinich tekstbasearre dialoochmodellen stipet.
Cloudflare's offisjele native REST API
As jo Stable Diffusion brûke moatte foar grafyk, Whisper foar audiotranskripsje, of in net-tekstmodel, nim dan de twadde rûte, dat is de offisjele native REST API fan Cloudflare.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
De modelnamme kin yn it paad skreaun wurde, lykas /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, of it kin pleatst wurde yn it `model`-fjild fan 'e oanfraachtekst. Ik set it leaver yn it fjild; it paad is koarter en skjinner. Ik wie earst ek yn 'e war oer dit detail. Guon modellen akseptearje beide metoaden, wylst oaren mar ien akseptearje. Jou hjir omtinken oan by it kontrolearjen fan 'e dokumintaasje.
Basis-URL fan AI Gateway
Der is in tredde manier: AI Gateway.
Dit senario is wat oars. As jo in AI Gateway ynsteld hawwe yn 'e Cloudflare-backend om API's fan tredden te proxyjen, lykas it trochstjoeren fan OpenAI-oanfragen fia de Cloudflare-gateway foar caching, monitoring en taryfbeheining, dan soe de basis-URL wêze...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
It tafoegjen fan `/chat/completions` nei it foltôge einpunt soarget derfoar dat al it ferkear troch de Cloudflare-gateway giet, en it logpaniel lit de latency en it resultaat fan elke oanfraach sjen. Dizze funksje is ongelooflijk nuttich as it team groeit mei mear projekten, wêrtroch't it net nedich is om ien foar ien troch gegevens fan ferskate leveransiers syn backends te sykjen.
Hoe te kiezen: Trije sets URL's útlein yn ien sin.
Okee, dat beslacht de trije paden. Gearfetsjend is der mar ien prinsipe.
It paad dat jo nimme hinget ôf fan 'e ark dy't jo brûke.
Om de OpenAI SDK te brûken om in dialoochmodel op te roppen, gean nei `/ai/v1`. Om in ôfbylding/audiomodel op te roppen, gean nei `/ai/run`. Foar ferienige behear fia in gateway, gean nei `/gateway/`. De autentikaasjemetoade is itselde: set `Authorization: Bearer` folge troch jo API Token yn 'e header. Meitsje de Token yn 'e Cloudflare-backend, en tink derom om de tastimming `Workers AI: Edit` te kontrolearjen.
Wêr kin ik de account_id fine? Meld jo oan by jo Cloudflare-behearpaniel, rôlje nei ûnderen nei de API-seksje yn 'e rjochter sydbalke, of kontrolearje de adresbalke fan jo browser; dy alfanumerike tekenrige fan 32 tekens is it.
Earlik sein, nei't ik myn freon dy dei holpen hie om it dien te krijen, sei er wat tsjin my dat ik tink hielendal kloppet: it wie net dat ik net wist hoe, it wie dat de dokumintaasje it my net dúdlik útlein hie.
In protte technyske konfiguraasjes binne sa. It is net dat se bysûnder lestich binne, mar d'r binne tefolle yngongspunten, wêrtroch it maklik is om by de earste poging ferlern te reitsjen. As jo ferskate ûnferklearbere flaters tsjinkommen binne by it konfigurearjen fan Cloudflare AI, komt it wierskynlik troch in ferkearde basis-URL of in ferkeard opmakke formaat. Hâld dizze trije sets URL's by de hân; jo kinne de folgjende kear maklik de juste fine.
Gjin dank.
Dus, om't jo oant no ta lêzen hawwe, as jo it nuttich fûnen, like en diel it dan asjebleaft. As jo earst updates ûntfange wolle, kinne jo my ek folgje! ⭐
Tankewol foar it lêzen fan myn artikel. Oant de folgjende kear.
Hopelik sil it artikel "Stop Reporting Errors! Easily Configure Cloudflare for OpenAI Compatibility: Base URL and Interface" dield op ' e blog fan Chen Weiliang ( https://www.chenweiliang.com/ ) jo nuttich wêze.
Fiel jo frij om de keppeling fan dit artikel te dielen: https://www.chenweiliang.com/cwl-34252.html
