Xatoliklarni oldini oling! OpenAI mosligi uchun Cloudflare’ning asosiy URL manzili va API’sini osongina sozlang.

CloudFlare AI Nima uchun asosiy URL har doim 404 xatosini qaytaradi?

Ushbu maqola sizga Cloudflare bilan mos keladigan OpenAI asosiy URL manzilini qanday qilib tezda olish va sozlashni bir necha soniya ichida o'rgatadi. Unda rasmiy REST API, AI Gateway formati va uchinchi tomon mijozlari (Dify/One-API) uchun mukammal shablonlar mavjud bo'lib, sizga bir marta bosish orqali bepul AI API-larini ishga tushirishga yordam beradi!

O'tgan hafta mustaqil ishlab chiqish bilan shug'ullanadigan do'stim to'satdan men bilan bog'lanib, 401 ta xatoga to'la ekran tasvirini yubordi. U: "Birodar, men kun bo'yi Cloudflare'ning AI API'sini tuzatishga harakat qildim, lekin bu ish bermayapti", dedi.

Men uning kodiga qaradim. Asosiy URL manzili /ai/v1 ga o'rnatilgan edi, lekin so'rov matni rasmiy REST API sifatida formatlangan edi, shuning uchun ikkalasi umuman mos kelmadi.

U shunchaki Workers AI’dagi modelni nosozliklarni tuzatish uchun OpenAI SDK’sidan foydalanmoqchi ekanligini aytdi, biron bir muammo bormi?

Bu katta muammo.

Cloudflare’ning AI xizmatlari vaziyatga qarab uchta butunlay boshqa asosiy URL manzillaridan foydalanadi. Ularning har biri oʻz formatiga va tegishli stsenariylarga ega. Hujjatlar mavjud boʻlsa-da, ular turli sahifalarda tarqalgan boʻlib, birinchi urinishda qaysi biriga murojaat qilishni bilishni qiyinlashtiradi. Notoʻgʻri URL manzilidan foydalanish 401 yoki 400 xatosiga olib keladi va bu sizning xizmatga kirishingizga toʻsqinlik qiladi.

Men bu muammoga birinchi marta duch kelganimda, uni tushunishdan oldin bir necha marta urinib ko'rdim. Xato xabarlariga to'la ekranga qarab, lol qoldim.

Bugun men siz uchun mana shu uchta yo'lni aniq chizib beraman, shunda buni o'qib bo'lgach, boshqa xato qilmaysiz.

OpenAI bilan mos keladigan interfeys bazasi URL manzili

Keling, eng ko'p ishlatiladiganidan boshlaylik.

Agar siz OpenAI SDK yoki LangChain, Dify, NextChat yoki One-API kabi maxsus OpenAI formatlarini qo'llab-quvvatlaydigan vositalardan foydalanayotgan bo'lsangiz, unda bu to'g'ri yondashuv.

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

Bu Cloudflare tomonidan OpenAI interfeys formati bilan moslashtirish uchun maxsus ishlab chiqilgan narsa. To'liq dialog tugash nuqtasidan keyin `/chat/completions` ni qo'shing. Asl OpenAI bazaviy URL manzilingizni shu bilan almashtiring va API kalitini Cloudflare tokeningiz bilan almashtiring, shunda u to'g'ridan-to'g'ri ishga tushishi kerak. Men `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` va `@cf/meta/llama-3.1-8b-instruct` kabi modellarni sinab ko'rdim va ularning barchasi yaxshi ishlaydi.

Biroq, shuni ta'kidlash kerakki, bu faqat matnga asoslangan dialog modellarini qo'llab-quvvatlaydi.

Cloudflare’ning rasmiy REST API’si

Agar sizga grafika yaratish uchun Stable Diffusion, audio transkripsiya uchun Whisper yoki boshqa matnsiz model kerak bo'lsa, ikkinchi yo'lni tanlang, bu Cloudflare rasmiy REST API.

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

Model nomi yo'lga yozilishi mumkin, masalan, /ai/run/@cf/bytedance/stable-diffusion-xl-lightning yoki so'rov matnining "model" maydoniga joylashtirilishi mumkin. Men uni maydonga qo'yishni afzal ko'raman; yo'l qisqaroq va tozaroq. Avvaliga men ham bu tafsilot haqida chalkashib qoldim. Ba'zi modellar ikkala usulni ham qabul qiladi, boshqalari esa faqat bittasini qabul qiladi. Hujjatlarni tekshirishda bunga e'tibor bering.

AI Gateway bazasi URL manzili

Uchinchi yo'l bor: AI Gateway.

Bu stsenariy biroz boshqacha. Agar siz Cloudflare orqa tomonida proksi uchinchi tomon API'lariga AI shlyuzini o'rnatgan bo'lsangiz, masalan, keshlash, monitoring qilish va tezlikni cheklash uchun Cloudflare shlyuzi orqali OpenAI so'rovlarini yo'naltirsangiz, unda asosiy URL manzili... bo'ladi.

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

To'liq tugash nuqtasidan keyin `/chat/completions` ni qo'shish barcha trafik Cloudflare shlyuzi orqali o'tishini ta'minlaydi va jurnal paneli har bir so'rovning kechikishi va natijasini ko'rsatadi. Bu xususiyat jamoa ko'proq loyihalar bilan o'sib borishi bilan nihoyatda foydali bo'lib, turli sotuvchilarning orqa tomonlaridan ma'lumotlarni birma-bir qidirish zaruratini yo'q qiladi.

Qanday tanlash kerak: Bitta jumlada uchta URL to'plami tushuntirilgan.

Xo'sh, bu uchta yo'lni qamrab oladi. Xulosa qilib aytganda, faqat bitta tamoyil mavjud.

Siz tanlagan yo'l siz foydalanadigan vositalarga bog'liq.

OpenAI SDK dan foydalanib, dialog modelini chaqirish uchun `/ai/v1` ga o'ting. Tasvir/audio modelini chaqirish uchun `/ai/run` ga o'ting. Shlyuz orqali yagona boshqaruv uchun `/gateway/` ga o'ting. Autentifikatsiya usuli bir xil: sarlavhaga `Authorization: Bearer` dan keyin API Tokeningizni qo'ying. Cloudflare orqa tomonida Token yarating va `Workers AI: Edit` ruxsatini tekshirishni unutmang.

account_id ni qayerdan topish mumkin? Cloudflare administrator paneliga kiring, o'ng yon paneldagi API bo'limiga o'ting yoki brauzeringizning manzil satrini tekshiring; bu 32 belgidan iborat harf-raqamli satr.

Rostini aytsam, o'sha kuni do'stimga buni qilishga yordam berganimdan so'ng, u menga juda to'g'ri deb o'ylagan bir gapni aytdi: men qanday qilishni bilmasligim emas, balki hujjatlarda menga aniq tushuntirilmaganligi sababli.

Ko'pgina texnik konfiguratsiyalar shunday. Ular juda qiyin emas, lekin kirish nuqtalari juda ko'p, bu birinchi urinishda adashib qolishni osonlashtiradi. Agar siz Cloudflare AI ni sozlashda turli xil tushunarsiz xatolarga duch kelgan bo'lsangiz, bu, ehtimol, noto'g'ri asosiy URL yoki noto'g'ri formatlangan format tufaylidir. Ushbu uchta URL to'plamini qo'lingizda saqlang; keyingi safar to'g'risini osongina topishingiz mumkin.

Salomat bo'ling.

Shunday qilib, siz shu yergacha o'qiganingiz uchun, agar foydali bo'lgan bo'lsa, iltimos, layk bosing va ulashing. Agar birinchi bo'lib yangiliklardan xabardor bo'lishni istasangiz, meni kuzatib borishingiz ham mumkin! ⭐

Maqolamni o'qiganingiz uchun tashakkur. Keyingi safar ko'rishguncha.