Eureunkeun kéngingkeun kasalahan! Konfigurasikeun URL Dasar sareng API Cloudflare kalayan gampang pikeun kompatibilitas OpenAI.

Cloudflare AI Naha URL dasar sok mulangkeun kasalahan 404?

Artikel ieu ngajarkeun anjeun dina sababaraha detik kumaha carana gancang kéngingkeun sareng ngonpigurasikeun URL dasar OpenAI anu cocog sareng Cloudflare. Artikel ieu ngawengku témplat anu sampurna pikeun REST API resmi, format AI Gateway, sareng klien pihak katilu (Dify/One-API), anu ngabantosan anjeun ngajalankeun AI API gratis ngan ukur ku hiji klik!

Minggu kamari, babaturan anu ngalakukeun pamekaran mandiri ujug-ujug ngahubungi kuring sareng ngirimkeun tangkapan layar anu nunjukkeun layar anu pinuh ku kasalahan 401. Anjeunna nyarios, "Dulur, kuring parantos nyobian nga-debug AI API Cloudflare sadinten, tapi teu tiasa dianggo."

Kuring ngarérét kodeu na. URL Dasarna disetel ka /ai/v1, tapi awak pamundutna diformat salaku REST API resmi, janten duanana henteu cocog pisan.

Cenah anjeunna ngan saukur hoyong nganggo SDK OpenAI pikeun ngadebug modél dina Workers AI, naha aya masalah?

Ieu masalah ageung.

Layanan AI Cloudflare nganggo tilu URL dasar anu béda pisan gumantung kana skénario. Masing-masing gaduh format sareng skénario anu tiasa dianggo. Sanaos aya dokumentasi, éta sumebar di sababaraha halaman anu béda, janten hésé terang anu mana anu kedah dirujuk dina usaha munggaran anjeun. Nganggo URL anu salah bakal nyababkeun kasalahan 401 atanapi 400, anu nyegah anjeun ngaksés layanan éta.

Waktu mimiti manggihan masalah ieu, kuring geus nyoba sababaraha kali samemeh manggihan jalan kaluarna. Kuring teu bisa ngomong naon-naon ningali layar nu pinuh ku pesen kasalahan.

Dinten ieu abdi bade ngagambar tilu jalan ieu kalawan jelas kanggo anjeun, supados anjeun moal ngadamel kasalahan deui saatos maca ieu.

URL Dasar Antarbeungeut Anu Cocog sareng OpenAI

Hayu urang mimitian ku anu paling sering dianggo.

Upami anjeun nganggo OpenAI SDK, atanapi alat-alat anu ngadukung format OpenAI khusus sapertos LangChain, Dify, NextChat, atanapi One-API, maka ieu mangrupikeun pendekatan anu leres.

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

Ieu hal anu dirancang khusus ku Cloudflare pikeun disaluyukeun sareng format antarmuka OpenAI. Tambahkeun `/chat/completions` saatos titik tungtung dialog anu lengkep. Ganti URL Dasar OpenAI asli anjeun ku ieu, teras ganti Konci API ku token Cloudflare anjeun, sareng éta kedahna langsung jalan. Abdi parantos nyobian modél sapertos `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` sareng `@cf/meta/llama-3.1-8b-instruct`, sareng sadayana tiasa dianggo kalayan saé.

Nanging, kedah dicatet yén ieu ngan ukur ngadukung modél dialog berbasis téks.

API REST asli resmi Cloudflare

Upami anjeun kedah nganggo Stable Diffusion pikeun nyieun grafik, Whisper pikeun transkripsi audio, atanapi modél non-téks naon waé, candak rute anu kadua, nyaéta REST API asli resmi Cloudflare.

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

Nami modél tiasa ditulis dina jalurna, sapertos /ai/run/@cf/bytedance/stable-diffusion-xl-lightning, atanapi tiasa disimpen dina kolom `modél` dina awak pamundut. Abdi langkung resep nempatkeun éta dina kolom; jalurna langkung pondok sareng langkung bersih. Abdi ogé bingung ngeunaan detil ieu mimitina. Sababaraha modél nampi duanana metode, sedengkeun anu sanésna ngan ukur nampi hiji. Perhatoskeun ieu nalika mariksa dokuméntasi.

URL Dasar Gerbang AI

Aya cara katilu: AI Gateway.

Skenario ieu rada béda. Upami anjeun parantos nyetél AI Gateway dina backend Cloudflare pikeun proxy API pihak katilu, sapertos ngirimkeun pamundut OpenAI ngalangkungan gateway Cloudflare pikeun caching, monitoring, sareng ngawatesan laju, maka URL Dasarna bakal...

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

Nambahkeun `/chat/completions` saatos titik tungtung anu lengkep mastikeun sadaya lalu lintas ngalangkungan gerbang Cloudflare, sareng panel log nunjukkeun latensi sareng hasil tina unggal pamundut. Fitur ieu mangpaat pisan nalika tim berkembang sareng langkung seueur proyék, ngaleungitkeun kabutuhan pikeun milarian data tina sababaraha backend vendor hiji-hiji.

Kumaha milihna: Tilu sét URL dijelaskeun dina hiji kalimah.

Muhun, éta ngawengku tilu jalur. Singkatna, ngan aya hiji prinsip.

Jalur anu anjeun pilih gumantung kana alat anu anjeun anggo.

Pikeun ngagunakeun OpenAI SDK pikeun nyauran modél dialog, buka `/ai/v1`. Pikeun nyauran modél gambar/audio, buka `/ai/run`. Pikeun manajemén terpadu via gateway, buka `/gateway/`. Métode auténtikasi sami: lebetkeun `Authorization: Bearer` dituturkeun ku Token API anjeun dina header. Jieun Token dina backend Cloudflare, sareng émut pikeun mariksa idin `Workers AI: Edit`.

Di mana mendakan account_id-na? Lebet ka panel admin Cloudflare anjeun, gulung ka handap ka bagian API dina bilah sisi katuhu, atanapi parios bilah alamat browser anjeun; éta string alfanumerik 32 karakter.

Jujur, saatos kuring ngabantosan sobat kuring ngerjakeun éta dinten éta, anjeunna nyarios hiji hal ka kuring anu kuring pikir leres pisan: sanés kusabab kuring henteu terang kumaha carana, tapi dokuméntasina henteu ngajelaskeunana kalayan jelas ka kuring.

Seueur konfigurasi téknis sapertos kieu. Sanés hartosna sesah pisan, tapi seueur teuing titik éntri, janten gampang leungit dina usaha munggaran anjeun. Upami anjeun mendakan rupa-rupa kasalahan anu teu tiasa dijelaskeun nalika ngonpigurasikeun Cloudflare AI, éta kamungkinan kusabab URL Dasar anu salah atanapi format anu salah. Simpen tilu sét URL ieu; anjeun tiasa kalayan gampang mendakan anu leres waktos salajengna.

Sawangsulna.

Janten, kumargi anjeun parantos maca dugi ka dieu, upami anjeun mendakan ieu mangpaat, punten like sareng share. Upami anjeun hoyong nampi apdet heula, anjeun ogé tiasa ngiringan kuring! ⭐

Hatur nuhun parantos maca tulisan abdi. Tepang deui engké.