Mistral API dokümantasyonu: Yaygın Hatalar ve Çözümler

Hata 1: Sınırsız bağlamı sınırları kontrol etmeden varsaymak

Model 100.000 token'lık bir bağlam penceresi destekler ancak bu sonsuz değildir. Bu toplamda hem prompt'u hem de tamamlamayı hesaba katmalısınız. Girdi metniniz 84.000 token'a yaklaşırsa model isteği kesebilir veya reddedebilir. 100.000 token'lık katı limite uymak için token kullanımını her zaman izleyin.

İstekleri göndermeden önce jeton sayılarını tahmin etmek için istemci kodunuzda bir tokenizer kütüphanesi kullanmayı göz önünde bulundurun. Bu, reddedilen yükler için harcanan kredileri önler. Akış, belleği yönetmeye yardımcı olur ancak bağlam penceresi sınırı sıkı kalır.

Hata 2: 8 MB istek gövdesi kısıtlamasını göz ardı etme

Her istek gövdesi 8 MB'ı aşamaz. Bu sınır, JSON yapısı ve meta veriler dahil olmak üzere tüm HTTP yüküne uygulanır. Base64 veya ham metin olarak gönderilen büyük belgeler bu eşiği kolayca aşabilir. Uzun belgeler işlerken girişinizi daha küçük parçalara bölün.

• Göndermeden önce yük boyutunuzu kontrol edin.
• Bellek baskısını azaltmak için akış (streaming) kullanın.
• JSON'ınızdaki gereksiz alanları sıkıştırın.

Bu kısıtlamanın göz ardı edilmesi 413 Payload Too Large hatasına yol açar. Bu sorunu halletmek genellikle ham istek gövdesi boyutunu incelemeyi gerektirir. API'miz performansı korumak için bunu sıkı bir şekilde uygular.

Hata 3: Hiçbir yer olmadığı yerde standart moderasyon bekleyerek

Model sansürsüz olduğundan, standart ticari moderasyon filtrelerini uygulamaz. Reddetme olmadan yetişkin, tartışmalı veya kurgusal içerikler üretecektir. Ancak, katı bir içerik sınırı her zaman geçerlidir: çocuklarla ilgili cinsel içerik reddedilir. Bu yapılandırılabilir bir ayar değil, sabit bir kuraldır.

Modelin ton veya üslup nedeniyle kendini sansürleyeceğini varsaymayın. Doğrudan cevap verir. Denetim gerekiyorsa, bunu kendi uygulama katmanınızda uygulayın. Bu, API sağlayıcısına güvenmeden içerik filtreleme üzerinde tam kontrol sağlar.

Hata 4: Ön ödemeli kripto faturalandırma döngülerini yanlış anlama

Aylık ücretler veya abonelikler yoktur. Kripto ile kredi yüklersiniz ve kredi gerçek token kullanımına göre yansıtılır. Hatalar ücretsizdir, bu nedenle yalnızca başarılı tamamlamalar için ödeme yaparsınız. Kredi süresi dolmaz, bu nedenle istediğiniz zaman kredi yükleyebilirsiniz.

Yüklemeler $20 ile $500 arasında tam tutarlardadır. Bonuslar geçerlidir: $50'den itibaren +%5, $100'den itibaren +%10 ve $200'den itibaren +%15. Ödemeler yalnızca USDT (TRC20) veya USDC (Base) ile kabul edilir. Bu model şeffaf ve öngörülebilirdir.

Hata 5: Uzun tamamlamalar için akış kullanmama

Uzun tamamlamalar önemli zaman alabilir. Akış (streaming) olmadan, istemciniz herhangi bir şey göstermeden önce tüm yanıtı bekler. Bu, kötü bir kullanıcı deneyimine ve potansiyel zaman aşımına yol açar. Tokenlar oluşturuldukça almak için Sunucu Tarafı Olayları (SSE) kullanın.

Streaming ayrıca istemci tarafında bellek kullanımını yönetmeye yardımcı olur. Son parça token kullanım ayrıntılarını içerir. Bu, maliyetleri gerçek zamanlı olarak izlemenize olanak tanır. Akışları (SSE) doğru şekilde işleyecek şekilde istemci kodunuzu ayarlayın.

Hata 6: Hataların ücretsiz olduğunu ancak farklı sayıldığını unutmak

Hatalar token tüketmez, bu nedenle bunlar için ödeme yapmazsınız. Ancak hız sınırlarınızın bir parçası olarak sayılırlar. Dakikada 300 istek gönderirseniz ve çoğu başarısız olursa, hız sınırına takılabilirsiniz. Bu, başarılı istekleri engeller.

Üstel geri çekilme ile yeniden deneme mantığı uygulayın. Bu, API'yi başarısız isteklerle doldurmayı önler. Hata oranlarınızı izleyerek yük yapınızı optimize edin. Ücretsiz hatalar bir avantajdır, ancak hız sınırları katıdır.

Hata 7: Bu API'yi resmi Mistral sağlayıcısıyla karıştırmak

Bu, bağımsız bir hizmettir. Resmi Mistral sağlayıcısı değiliz. Kendi uncensored modelimizi çalıştıran OpenAI-uyumlu bir uç nokta sunuyoruz. Temel URL HTTPS://api.mistralapidoc.com/v1'dir. Resmi Mistral fiyatlandırma veya limitlerinin burada geçerli olduğunu varsaymayın.

Özel modelleri ve fiyatları için resmi Mistral dokümantasyonunu kontrol edin. API'miz, standart SDK uyumluluğu ile censorship'siz çıktı isteyen geliştiriciler için tasarlanmıştır. Diğer satıcıların modellerini sunmayız. Modelimiz yetişkin içerikler için ayarlanmıştır ve standart denetimden yoksundur.

Mistral API dokümantasyonu: Göç Kontrol Listesi

Kodunuzu geçirmeden önce, temel URL'nizi ve API anahtarınızı doğrulayın. Resmi OpenAI SDK'larını uç noktamızla kullanın. Model kimliğini "uncensored" olarak ayarlayın. Önce küçük yüklerle test edin. İstemcinizin SSE akışlarını doğru işlediğinden emin olun.

• base_url'i uç noktamıza güncelleyin.
• Modeli "uncensored" olarak ayarlayın.
• Uzun çıktılar için akış oluşturun.
• Token kullanımını ve hataları izleyin.

Bu kontrol listesi sorunsuz bir geçiş sağlar. API'miz standart OpenAI istemcileri ile uyumludur. Satıcı kilidi yok. Sadece temel URL'yi ve anahtarı değiştirin. İşlevselliği doğrulamak için deneme kredisi ile başlayın.