Artikelkatalog
Varför returnerar min Cloudflare AI- bas-URL alltid ett 404-fel?
Den här artikeln lär dig på några sekunder hur du snabbt hämtar och konfigurerar en Cloudflare-kompatibel OpenAI-bas-URL. Den innehåller perfekta mallar för officiella REST API, AI Gateway-format och tredjepartsklienter (Dify/One-API), vilket hjälper dig att få igång gratis AI API:er med ett enda klick!
Förra veckan kontaktade en vän som sysslar med oberoende utveckling mig plötsligt och skickade en skärmdump som visade en skärm full av 401-fel. Han sa: "Broder, jag har försökt felsöka Cloudflares AI-API hela dagen, men det fungerar bara inte."
Jag tittade på hans kod. Bas-URL:en var inställd på /ai/v1, men förfrågningstexten var formaterad som det officiella REST API:et, så de två matchade inte alls.
Han sa att han bara ville använda OpenAI:s SDK för att felsöka en modell på Workers AI, finns det några problem?
Detta är ett stort problem.
Cloudflares AI-tjänster använder tre helt olika bas-URL:er beroende på scenario. Var och en har sitt eget format och tillämpliga scenarier. Även om det finns dokumentation är den utspridd över olika sidor, vilket gör det svårt att veta vilken man ska hänvisa till vid första försöket. Om du använder fel URL kommer det att resultera i ett 401- eller 400-fel, vilket hindrar dig från att komma åt tjänsten.
När jag först stötte på det här problemet försökte jag flera gånger innan jag löste det. Jag var mållös när jag tittade på skärmen full av felmeddelanden.
Idag ska jag tydligt rita upp dessa tre vägar för dig, så att du inte gör fler misstag efter att ha läst detta.

Bas-URL för OpenAI-kompatibelt gränssnitt
Låt oss börja med den vanligaste.
Om du använder OpenAI SDK, eller verktyg som stöder anpassade OpenAI-format som LangChain, Dify, NextChat eller One-API, är detta rätt tillvägagångssätt.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
Detta är något som Cloudflare specifikt utformat för att anpassa sig till OpenAI-gränssnittsformatet. Lägg till `/chat/completions` efter slutpunkten för den fullständiga dialogen. Ersätt din ursprungliga OpenAI-bas-URL med detta och ersätt API-nyckeln med din Cloudflare-token, så borde den köras direkt. Jag har provat modeller som `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` och `@cf/meta/llama-3.1-8b-instruct`, och de fungerar alla bra.
Det bör dock noteras att detta endast stöder textbaserade dialogmodeller.
Cloudflares officiella inbyggda REST API
Om du behöver använda Stable Diffusion för grafisk framställning, Whisper för ljudtranskription eller någon annan modell som inte är text, ta den andra vägen, vilket är Cloudflares officiella inbyggda REST API.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
Modellnamnet kan skrivas i sökvägen, till exempel /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, eller så kan det placeras i fältet `model` i begäran. Jag föredrar att skriva det i fältet; sökvägen är kortare och renare. Jag var också förvirrad över denna detalj till en början. Vissa modeller accepterar båda metoderna, medan andra bara accepterar en. Var uppmärksam på detta när du kontrollerar dokumentationen.
Bas-URL för AI-gateway
Det finns ett tredje sätt: AI-gateway.
Det här scenariot är något annorlunda. Om du har konfigurerat en AI-gateway i Cloudflare-backend för att proxyservera tredjeparts-API:er, till exempel vidarebefordra OpenAI-förfrågningar via Cloudflare-gatewayen för cachning, övervakning och hastighetsbegränsning, då skulle bas-URL:en vara...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
Genom att lägga till `/chat/completions` efter slutpunkten för slutförande säkerställs att all trafik går via Cloudflare-gatewayen, och loggpanelen visar latens och resultat för varje begäran. Den här funktionen är otroligt användbar allt eftersom teamet växer med fler projekt, vilket eliminerar behovet av att söka igenom data från olika leverantörers backends en efter en.
Hur man väljer: Tre uppsättningar webbadresser förklarade i en mening.
Okej, det täcker de tre vägarna. Sammanfattningsvis finns det bara en princip.
Vilken väg du tar beror på vilka verktyg du använder.
För att använda OpenAI SDK för att anropa en dialogmodell, gå till `/ai/v1`. För att anropa en bild-/ljudmodell, gå till `/ai/run`. För enhetlig hantering via en gateway, gå till `/gateway/`. Autentiseringsmetoden är densamma: skriv `Authorization: Bearer` följt av din API-token i headern. Skapa token i Cloudflare-backend och kom ihåg att markera behörigheten `Workers AI: Edit`.
Var hittar jag account_id? Logga in på din Cloudflare-administratörspanel, scrolla ner till API-sektionen i den högra sidofältet eller kontrollera din webbläsares adressfält; den där alfanumeriska strängen på 32 tecken är det.
Ärligt talat, efter att jag hjälpt min vän att få det gjort den dagen, sa han något till mig som jag tror är helt rätt: det var inte så att jag inte visste hur, det var att dokumentationen inte hade förklarat det tydligt för mig.
Många tekniska konfigurationer är så här. Det är inte så att de är särskilt svåra, men det finns för många ingångspunkter, vilket gör det lätt att gå vilse på första försöket. Om du har stött på olika oförklarliga fel när du konfigurerar Cloudflare AI beror det troligtvis på en felaktig bas-URL eller ett felformaterat format. Ha dessa tre uppsättningar URL:er till hands; du kan enkelt hitta den korrekta nästa gång.
Varsågod.
Så, eftersom du har läst så här långt, om du tyckte att det var hjälpsamt, gilla och dela det gärna. Om du vill få uppdateringar först kan du också följa mig! ⭐
Tack för att du läste min artikel. Vi ses nästa gång.
Förhoppningsvis kommer artikeln "Sluta rapportera fel! Konfigurera Cloudflare enkelt för OpenAI-kompatibilitet" som delas på Chen Weiliangs blogg ( https://www.chenweiliang.com/ ) att vara till hjälp för dig.
Dela gärna länken till den här artikeln: https://www.chenweiliang.com/cwl-34252.html
