Stop med at få fejl! Konfigurer nemt Cloudflares basis-URL og API til OpenAI-kompatibilitet.

Hvorfor returnerer min Cloudflare AI- basis-URL altid en 404-fejl?

Denne artikel lærer dig på få sekunder, hvordan du hurtigt finder og konfigurerer en Cloudflare-kompatibel OpenAI-basis-URL. Den indeholder perfekte skabeloner til officiel REST API, AI Gateway-format og tredjepartsklienter (Dify/One-API), så du kan få gratis AI API'er op at køre med et enkelt klik!

I sidste uge kontaktede en ven, der laver uafhængig udvikling, mig pludselig og sendte mig et skærmbillede, der viste en skærm fuld af 401-fejl. Han sagde: "Broder, jeg har prøvet at debugge Cloudflares AI API hele dagen, men det virker bare ikke."

Jeg kiggede på hans kode. Basis-URL'en var indstillet til /ai/v1, men anmodningsteksten var formateret som den officielle REST API, så de to matchede slet ikke.

Han sagde, at han bare ville bruge OpenAIs SDK til at fejlfinde en model på Workers AI, er der noget problem?

Dette er et stort problem.

Cloudflares AI-tjenester bruger tre helt forskellige basis-URL'er afhængigt af scenariet. Hver har sit eget format og anvendelige scenarier. Selvom der er dokumentation, er den spredt ud over forskellige sider, hvilket gør det svært at vide, hvilken man skal henvise til i første forsøg. Brug af den forkerte URL vil resultere i en 401- eller 400-fejl, der forhindrer dig i at få adgang til tjenesten.

Da jeg først stødte på dette problem, prøvede jeg flere gange, før jeg fandt ud af det. Jeg var målløs, da jeg så på skærmen fuld af fejlmeddelelser.

I dag vil jeg tydeligt tegne disse tre veje for dig, så du ikke laver flere fejl efter at have læst dette.

Basis-URL for OpenAI-kompatibel grænseflade

Lad os starte med den mest almindeligt anvendte.

Hvis du bruger OpenAI SDK eller værktøjer, der understøtter brugerdefinerede OpenAI-formater, såsom LangChain, Dify, NextChat eller One-API, så er dette den rigtige fremgangsmåde.

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

Dette er noget, Cloudflare specifikt har designet til at tilpasse sig OpenAI-grænsefladeformatet. Tilføj `/chat/completions` efter slutpunktet for den komplette dialog. Erstat din originale OpenAI-basis-URL med dette, og erstat API-nøglen med din Cloudflare-token, og den burde køre direkte. Jeg har prøvet modeller som `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` og `@cf/meta/llama-3.1-8b-instruct`, og de fungerer alle fint.

Det skal dog bemærkes, at dette kun understøtter tekstbaserede dialogmodeller.

Cloudflares officielle native REST API

Hvis du har brug for at bruge Stable Diffusion til graftegning, Whisper til lydtranskription eller en hvilken som helst ikke-tekstmodel, skal du vælge den anden vej, som er Cloudflares officielle native REST API.

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

Modelnavnet kan skrives i stien, f.eks. /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, eller det kan placeres i `model`-feltet i anmodningens brødtekst. Jeg foretrækker at placere det i feltet; stien er kortere og mere overskuelig. Jeg var også forvirret over denne detalje i starten. Nogle modeller accepterer begge metoder, mens andre kun accepterer én. Vær opmærksom på dette, når du tjekker dokumentationen.

Basis-URL for AI-gateway

Der er en tredje vej: AI Gateway.

Dette scenarie er en smule anderledes. Hvis du har konfigureret en AI-gateway i Cloudflare-backend'en til at proxy tredjeparts-API'er, f.eks. videresendelse af OpenAI-anmodninger via Cloudflare-gatewayen til caching, overvågning og hastighedsbegrænsning, så ville basis-URL'en være...

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

Tilføjelse af `/chat/completions` efter det komplette slutpunkt sikrer, at al trafik går gennem Cloudflare-gatewayen, og logpanelet viser latenstid og resultat af hver anmodning. Denne funktion er utrolig nyttig, efterhånden som teamet vokser med flere projekter, hvilket eliminerer behovet for at søge gennem data fra forskellige leverandørers backends én efter én.

Sådan vælger du: Tre sæt URL'er forklaret i én sætning.

Okay, det dækker de tre veje. Kort sagt er der kun ét princip.

Den vej, du tager, afhænger af de værktøjer, du bruger.

For at bruge OpenAI SDK'et til at kalde en dialogmodel skal du gå til `/ai/v1`. For at kalde en billed-/lydmodel skal du gå til `/ai/run`. For samlet administration via en gateway skal du gå til `/gateway/`. Godkendelsesmetoden er den samme: skriv `Authorization: Bearer` efterfulgt af din API-token i headeren. Opret tokenet i Cloudflare-backend'en, og husk at markere tilladelsen `Workers AI: Edit`.

Hvor finder jeg account_id'et? Log ind på dit Cloudflare-administrationspanel, rul ned til API-sektionen i højre sidebjælke, eller tjek din browsers adresselinje; det er den alfanumeriske streng på 32 tegn.

Helt ærligt, efter jeg hjalp min ven med at få det gjort den dag, sagde han noget til mig, som jeg synes er helt rigtigt: det var ikke fordi jeg ikke vidste hvordan, det var fordi dokumentationen ikke havde forklaret det tydeligt for mig.

Mange tekniske konfigurationer er sådan her. Det er ikke fordi de er særligt vanskelige, men der er for mange indgangspunkter, hvilket gør det nemt at fare vild i første forsøg. Hvis du er stødt på forskellige uforklarlige fejl, når du konfigurerer Cloudflare AI, skyldes det højst sandsynligt en forkert basis-URL eller et forkert format. Hav disse tre sæt URL'er ved hånden; du kan nemt finde den korrekte næste gang.

Velbekomme.

Så nu du har læst så langt, så synes du meget godt om og del det, hvis du fandt det nyttigt. Hvis du vil modtage opdateringer først, kan du også følge mig! ⭐

Tak fordi du læste min artikel. Vi ses næste gang.