Adresár článkov
Prečo moja základná URL adresa Cloudflare AI vždy vracia chybu 404?
Tento článok vás v priebehu niekoľkých sekúnd naučí, ako rýchlo získať a nakonfigurovať základnú URL adresu OpenAI kompatibilnú s Cloudflare. Obsahuje perfektné šablóny pre oficiálne REST API, formát AI Gateway a klientov tretích strán (Dify/One-API), ktoré vám pomôžu spustiť a spustiť bezplatné rozhrania AI API jediným kliknutím!
Minulý týždeň ma zrazu kontaktoval kamarát, ktorý sa venuje nezávislému vývoju, a poslal mi snímku obrazovky plnú chýb 401. Povedal: „Brat, celý deň sa snažím ladiť AI API od Cloudflare, ale jednoducho to nefunguje.“
Pozrel som sa na jeho kód. Základná URL adresa bola nastavená na /ai/v1, ale telo požiadavky bolo naformátované ako oficiálne REST API, takže sa tieto dve adresy vôbec nezhodovali.
Povedal, že chce len použiť SDK od OpenAI na ladenie modelu na Workers AI, je s tým nejaký problém?
Toto je veľký problém.
Služby umelej inteligencie od Cloudflare používajú tri úplne odlišné základné adresy URL v závislosti od scenára. Každá má svoj vlastný formát a príslušné scenáre. Hoci existuje dokumentácia, je roztrúsená na rôznych stránkach, takže je ťažké na prvý pokus zistiť, na ktorú sa odvolať. Použitie nesprávnej adresy URL bude mať za následok chybu 401 alebo 400, ktorá vám zabráni v prístupe k službe.
Keď som sa s týmto problémom stretol prvýkrát, skúšal som to niekoľkokrát, kým som to vyriešil. Pri pohľade na obrazovku plnú chybových hlásení som onemel.
Dnes vám tieto tri cesty jasne nakreslím, aby ste po prečítaní tohto článku neurobili žiadne ďalšie chyby.

Základná URL adresa rozhrania kompatibilného s OpenAI
Začnime s tým najčastejšie používaným.
Ak používate OpenAI SDK alebo nástroje, ktoré podporujú vlastné formáty OpenAI, ako napríklad LangChain, Dify, NextChat alebo One-API, potom je toto správny prístup.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
Toto je niečo, čo Cloudflare špeciálne navrhol tak, aby zosúladilo s formátom rozhrania OpenAI. Za koncový bod kompletného dialógu pridajte `/chat/completions`. Nahraďte pôvodnú základnú URL adresu OpenAI týmto a kľúč API nahraďte tokenom Cloudflare a malo by to bežať priamo. Vyskúšal som modely ako `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` a `@cf/meta/llama-3.1-8b-instruct` a všetky fungujú dobre.
Treba však poznamenať, že to podporuje iba textové dialógové modely.
Oficiálne natívne REST API od Cloudflare
Ak potrebujete použiť Stable Diffusion na grafické znázornenie, Whisper na prepis zvuku alebo akýkoľvek netextový model, zvoľte druhú cestu, ktorou je oficiálne natívne REST API od Cloudflare.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
Názov modelu je možné zapísať do cesty, napríklad /ai/run/@cf/bytandance/stable-diffusion-xl-lightning, alebo ho možno umiestniť do poľa `model` v tele požiadavky. Ja ho radšej zadávam do poľa; cesta je kratšia a prehľadnejšia. Aj ja som bol spočiatku z tohto detailu zmätený. Niektoré modely akceptujú obe metódy, zatiaľ čo iné iba jednu. Pri kontrole dokumentácie venujte tomu pozornosť.
Základná URL adresa brány AI
Existuje aj tretí spôsob: AI Gateway.
Tento scenár je mierne odlišný. Ak ste v backende Cloudflare nastavili bránu AI na proxy API tretích strán, ako je napríklad presmerovanie požiadaviek OpenAI cez bránu Cloudflare na ukladanie do vyrovnávacej pamäte, monitorovanie a obmedzovanie rýchlosti, základná URL adresa by bola...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
Pridanie `/chat/completions` za kompletný koncový bod zabezpečí, že všetka prevádzka prechádza cez bránu Cloudflare a panel protokolov zobrazuje latenciu a výsledok každej požiadavky. Táto funkcia je neuveriteľne užitočná, keď tím rastie s viacerými projektmi, čím sa eliminuje potreba prehľadávať údaje z backendov rôznych dodávateľov jeden po druhom.
Ako si vybrať: Tri sady URL adries vysvetlené v jednej vete.
Dobre, to pokrýva tri cesty. Stručne povedané, existuje len jeden princíp.
Cesta, ktorou sa vydáte, závisí od nástrojov, ktoré použijete.
Ak chcete použiť OpenAI SDK na volanie modelu dialógu, prejdite na `/ai/v1`. Ak chcete volať model obrázka/zvuku, prejdite na `/ai/run`. Pre jednotnú správu prostredníctvom brány prejdite na `/gateway/`. Metóda autentifikácie je rovnaká: do hlavičky vložte `Authorization: Bearer` a za ním váš API Token. Vytvorte token v backende Cloudflare a nezabudnite zaškrtnúť povolenie `Workers AI: Edit`.
Kde nájdem account_id? Prihláste sa do administrátorského panela Cloudflare, prejdite nadol do sekcie API v pravom bočnom paneli alebo skontrolujte adresný riadok prehliadača; je to ten 32-miestny alfanumerický reťazec.
Úprimne povedané, keď som v ten deň pomohol kamarátovi s tým, povedal mi niečo, čo si myslím, že je úplne správne: nebolo to tým, že by som nevedel ako, ale tým, že mi to v dokumentácii nebolo jasne vysvetlené.
Mnohé technické konfigurácie sú takéto. Nie je to tak, že by boli nijako zvlášť zložité, ale majú príliš veľa vstupných bodov, takže sa ľahko stratíte pri prvom pokuse. Ak ste sa pri konfigurácii Cloudflare AI stretli s rôznymi nevysvetliteľnými chybami, s najväčšou pravdepodobnosťou je to spôsobené nesprávnou základnou URL adresou alebo nesprávne naformátovaným formátom. Majte tieto tri sady URL adres po ruke; nabudúce ľahko nájdete tú správnu.
不用谢。
Takže, keďže ste sa dočítali až sem, ak vám to pomohlo, dajte to lajk a zdieľajte. Ak chcete dostávať novinky ako prví, môžete ma tiež sledovať! ⭐
Ďakujem za prečítanie môjho článku. Dovidenia nabudúce.
Dúfame, že článok „Prestaňte hlásiť chyby! Jednoducho nakonfigurujte Cloudflare pre kompatibilitu s OpenAI: Základná URL adresa a rozhranie“ zdieľaný na blogu Chen Weilianga ( https://www.chenweiliang.com/ ) bude pre vás užitočný.
Neváhajte a zdieľajte odkaz na tento článok: https://www.chenweiliang.com/cwl-34252.html
