Makale Rehberi
Cloudflare AI temel URL'im neden sürekli 404 hatası veriyor?
Bu makale, Cloudflare ile uyumlu bir OpenAI temel URL'sini saniyeler içinde nasıl edineceğinizi ve yapılandıracağınızı öğretiyor. Resmi REST API, AI Gateway formatı ve üçüncü taraf istemciler (Dify/One-API) için mükemmel şablonlar içeriyor ve tek bir tıklamayla ücretsiz AI API'lerini çalışır hale getirmenize yardımcı oluyor!
Geçen hafta, bağımsız yazılım geliştiren bir arkadaşım aniden benimle iletişime geçti ve ekranın 401 hatalarıyla dolu olduğunu gösteren bir ekran görüntüsü gönderdi. "Kardeşim, tüm gün Cloudflare'ın yapay zeka API'sinde hata ayıklamaya çalıştım ama bir türlü çalışmıyor," dedi.
Koduna şöyle bir göz attım. Temel URL /ai/v1 olarak ayarlanmıştı, ancak istek gövdesi resmi REST API formatında yazılmıştı, bu yüzden ikisi hiç uyuşmuyordu.
Kendisi sadece Workers AI üzerindeki bir modeli hata ayıklamak için OpenAI'nin SDK'sını kullanmak istediğini söyledi, bunda bir sorun var mı?
Bu büyük bir sorun.
Cloudflare'ın yapay zeka hizmetleri, senaryoya bağlı olarak tamamen farklı üç temel URL kullanır. Her birinin kendine özgü formatı ve uygulanabilir senaryoları vardır. Belgeler mevcut olsa da, farklı sayfalara dağılmış durumda, bu da ilk denemede hangisine başvurmanız gerektiğini anlamayı zorlaştırıyor. Yanlış URL kullanmak 401 veya 400 hatasına neden olarak hizmete erişmenizi engelleyecektir.
Bu sorunla ilk karşılaştığımda, çözümü bulana kadar birkaç kez denedim. Ekranda beliren hata mesajlarını görünce nutkum tutuldu.
Bugün bu üç yolu sizin için açıkça çizeceğim, böylece bunu okuduktan sonra artık hata yapmayacaksınız.
OpenAI Uyumlu Arayüz Temel URL'si
En sık kullanılanıyla başlayalım.
Eğer OpenAI SDK'yı veya LangChain, Dify, NextChat veya One-API gibi özel OpenAI formatlarını destekleyen araçları kullanıyorsanız, doğru yaklaşım budur.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/v1
Bu, Cloudflare'ın özellikle OpenAI arayüz formatıyla uyumlu olacak şekilde tasarladığı bir şeydir. Tamamlanmış diyalog uç noktasından sonra `/chat/completions` ekleyin. Orijinal OpenAI Temel URL'nizi bununla değiştirin ve API Anahtarını Cloudflare belirtecinizle değiştirin; doğrudan çalışması gerekir. `@cf/deepseek-ai/deepseek-r1-distill-qwen-32b` ve `@cf/meta/llama-3.1-8b-instruct` gibi modelleri denedim ve hepsi sorunsuz çalıştı.
Ancak, bunun yalnızca metin tabanlı diyalog modellerini desteklediğini belirtmek gerekir.
Cloudflare'ın resmi yerel REST API'si
Grafik oluşturmak için Stable Diffusion'ı, ses transkripsiyonu için Whisper'ı veya metin dışı herhangi bir modeli kullanmanız gerekiyorsa, ikinci yolu, yani Cloudflare'ın resmi yerel REST API'sini kullanın.
https://api.cloudflare.com/client/v4/accounts/{你的account_id}/ai/run
Model adı, /ai/run/@cf/bytedance/stable-diffusion-xl-lightning gibi yolun içine yazılabilir veya istek gövdesinin `model` alanına yerleştirilebilir. Ben alanın içine yazmayı tercih ediyorum; yol daha kısa ve daha temiz. Bu ayrıntı konusunda ben de ilk başta kafam karışmıştı. Bazı modeller her iki yöntemi de kabul ederken, bazıları yalnızca birini kabul eder. Dokümantasyonu incelerken buna dikkat edin.
Yapay Zeka Ağ Geçidi Temel URL'si
Üçüncü bir yol daha var: Yapay Zeka Geçidi.
Bu senaryo biraz farklı. Cloudflare arka ucunda üçüncü taraf API'lerini yönlendirmek için bir AI Gateway kurduysanız (örneğin, önbellekleme, izleme ve hız sınırlama için OpenAI isteklerini Cloudflare ağ geçidi üzerinden iletmek gibi), o zaman Temel URL şu şekilde olacaktır...
https://gateway.ai.cloudflare.com/v1/{你的account_id}/{你的gateway_id}/openai
`/chat/completions` ifadesini `completion` uç noktasından sonra eklemek, tüm trafiğin Cloudflare ağ geçidinden geçmesini sağlar ve günlük paneli her isteğin gecikme süresini ve sonucunu gösterir. Bu özellik, ekip daha fazla projeyle büyüdükçe inanılmaz derecede kullanışlıdır ve çeşitli tedarikçilerin arka uçlarından gelen verileri tek tek arama ihtiyacını ortadan kaldırır.
Nasıl seçilir: Üç farklı URL seti tek cümleyle açıklandı.
Tamam, üç yolu da ele aldık. Özetle, tek bir ilke var.
İzleyeceğiniz yol, kullandığınız araçlara bağlıdır.
OpenAI SDK'yı kullanarak bir diyalog modelini çağırmak için `/ai/v1` adresine gidin. Bir görüntü/ses modelini çağırmak için `/ai/run` adresine gidin. Bir ağ geçidi üzerinden birleşik yönetim için `/gateway/` adresine gidin. Kimlik doğrulama yöntemi aynıdır: başlığa `Authorization: Bearer` ve ardından API Token'ınızı ekleyin. Token'ı Cloudflare arka ucunda oluşturun ve `Workers AI: Edit` iznini işaretlemeyi unutmayın.
account_id'yi nerede bulabilirsiniz? Cloudflare yönetici panelinize giriş yapın, sağ kenar çubuğundaki API bölümüne kadar aşağı kaydırın veya tarayıcınızın adres çubuğunu kontrol edin; 32 karakterlik alfanümerik dize işte o.
Dürüst olmak gerekirse, o gün arkadaşımın işini halletmesine yardım ettikten sonra bana söylediği bir şey bence oldukça doğru: Sorun benim nasıl yapılacağını bilmemem değildi, sorun belgelerde bana açıkça anlatılmamış olmasıydı.
Birçok teknik yapılandırma böyledir. Özellikle zor oldukları anlamına gelmez, ancak çok fazla giriş noktası vardır ve bu da ilk denemenizde kaybolmanızı kolaylaştırır. Cloudflare AI'yı yapılandırırken çeşitli açıklanamayan hatalarla karşılaştıysanız, bunun nedeni büyük olasılıkla yanlış bir Temel URL veya yanlış biçimlendirilmiş bir URL'dir. Bu üç URL kümesini elinizin altında bulundurun; bir dahaki sefere doğru olanı kolayca bulabilirsiniz.
Rica ederim.
Buraya kadar okuduğunuza göre, eğer faydalı bulduysanız lütfen beğenin ve paylaşın. Güncellemeleri ilk öğrenmek istiyorsanız beni takip edebilirsiniz! ⭐
Makalemi okuduğunuz için teşekkür ederim. Bir sonraki yazıda görüşmek üzere.
Umarım Chen Weiliang'ın blogunda ( https://www.chenweiliang.com/ ) paylaşılan "Hata Bildirmeyi Bırakın! Cloudflare'ı OpenAI Uyumluluğu İçin Kolayca Yapılandırın" başlıklı makale size yardımcı olur.
Bu makalenin bağlantısını paylaşmaktan çekinmeyin: https://www.chenweiliang.com/cwl-34252.html