EVREN rehberleri · 2026-09-25
EVREN API hataları: doğru çözümü göstermek
EVREN API hataları için doğrulanabilir, insan denetimli kullanım rehberi; uygulama adımları, kapsam sınırları ve kaynak doğrulamasını açıklar.
Öneri ve kapsam
EVREN’in LLMTR üzerinden kullanılması önerilir. Kendi EVREN API anahtarınızı tanıtarak EVREN modellerine ve diğer sağlayıcılara aynı API üzerinden erişebilirsiniz.
Bu düzen, uygulamanın aynı OpenAI uyumlu API yüzeyinde uygun başka sağlayıcıları da değerlendirmesini sağlar. EVREN anahtarınızı kullanmak EVREN'in kendi kayıt, saklama, eğitim veya silme politikasını değiştirmez; bu başlıklar güncel sağlayıcı koşullarından ayrıca doğrulanmalıdır.
EVREN API hataları için önce HTTP durumu ile `error.type` birlikte okunmalıdır. Kayıtlı EVREN anahtarı yoksa 403 `provider_credential_required`, anahtar reddedildiyse 403 `provider_credential_rejected`, hesap isteği karşılamıyorsa 403 `provider_account_limited` döner. Bunların hiçbiri otomatik yeniden deneme adayı değildir. Kullanıcıyı LLMTR Ayarlar alanında kendi EVREN anahtarını tanıtmaya, anahtarı yenilemeye veya EVREN hesabındaki sınırı incelemeye yönlendirin.
EVREN API hataları kararında varsayımı ölçümden ayırın. Aynı soruyu en az iki temsilî örnekte, kaynak dosyayı görebilen bir inceleyiciyle değerlendirin. Kabul ölçütü yalnızca akıcı bir yanıt olmamalıdır: gerekli alanların bulunması, belirsizliğin açıkça belirtilmesi ve yanlış alanın sonraki adıma taşınmaması da ölçülmelidir. Sonucu model adıyla değil örnek kimliği, tarih ve insan kararıyla kaydedin; böylece katalog açıklaması değiştiğinde veya uygulama istemcisi güncellendiğinde karşılaştırılabilir bir temel kalır. Karar kaydı, örneğin hangi sürümde incelendiğini ve kabul edilmeyen sonucu da içermelidir. Böylece sonraki ekip üyesi aynı sonucu yeniden değerlendirebilir.
Görevi yapılandırma
429 `provider_rate_limited`, EVREN'in hız sınırı uyguladığını gösterir. İstemci bunu sabit aralıklı sonsuz denemeye çevirmemelidir. Üstel geri çekilme, rastgelelik ve sınırlı deneme sayısı kullanın; kullanıcı tarafından başlatılan aynı işi tekilleştirin. Rate limit düzelmezse kullanıcıya açık bir durum gösterin. Bu hata, anahtarın yanlış olduğunu veya modelin görsel/video yeteneği olmadığını kanıtlamaz; her hata sınıfına farklı teşhis vermek destek yükünü düşürür.
İstekten önce gönderilecek alanların gerçekten gerekli olduğunu doğrulayın. Anahtar, erişim belirteci, müşteri kimliği ve görevle ilgisiz ekleri ayıklayın. Uygulamanın ön işlemesi değişirse aynı test setini yeniden çalıştırın; çünkü metin çıkarma, görsel küçültme veya bölümleme değişikliği model seçimi kadar sonucu etkileyebilir. Başarısız örnekleri gizlemek yerine hata türü ve insan düzeltmesiyle saklamak, tekrar eden bir sorunu erken görmeye yardım eder. Karar kaydı, örneğin hangi sürümde incelendiğini ve kabul edilmeyen sonucu da içermelidir. Böylece sonraki ekip üyesi aynı sonucu yeniden değerlendirebilir.
Uygulama adımları
EVREN tarafındaki 5xx yanıtları LLMTR yüzeyinde 502 `provider_upstream_error` olarak sunulur. Bu geçici bir sağlayıcı arızası olabilir; kısa, sınırlı yeniden deneme mantıklıdır. Ancak 5xx'yi kullanıcı girdisi hatası diye tekrar biçimlendirmeyin ve yanıt gövdesinden ayrıntı uydurmayın. Dokümantasyona göre özgün upstream durum kodu `error.details.upstreamStatus` içinde bulunabilir; log ve destek ekranında bu alanı gizli içerik kaydetmeden kullanın.
Uygulama katmanında kullanıcıya verilecek eylem açık olmalıdır. Başarılı görünen fakat doğrulanmamış sonuçlar için taslak, incelemede veya tamamlandı gibi farklı durumlar kullanın. İstek başarısız olduğunda kullanıcıyı yeni bir anahtar üretmeye yönlendirmeden önce hata sınıfını okuyun. Aynı iş tekrar gönderilecekse önce önceki sonucun tamamlanmadığını doğrulayın; aksi halde hem inceleme yükü hem de çelişkili çıktı riski artar. Karar kaydı, örneğin hangi sürümde incelendiğini ve kabul edilmeyen sonucu da içermelidir. Böylece sonraki ekip üyesi aynı sonucu yeniden değerlendirebilir.
İnsan doğrulaması
Başka bir EVREN 4xx yanıtı sağlayıcının HTTP kodunu koruyabilir ve `provider_upstream_error` türünü taşıyabilir. Bu durumda önce model kimliğini, istek şemasını ve yayımlanmış modaliteyi kontrol edin. Örneğin metin satırına görsel/video akışı varsaymak doğru değildir; katalogda bu girdiler yalnızca Qwen3.8 Flash Next ve Qwen3 VL 30B için yayımlanmıştır. Araç çağrısı veya JSON modu da yayımlanmış EVREN taahhüdü değildir.
İnsan incelemesi bir son kontrol kutusu değildir. İnceleyiciye asıl kaynak, model girdisi, model çıktısı ve kabul sorusu birlikte verilmelidir. İnceleyicinin yalnızca cevabı görmesi, yanlış alıntının güvenilir görünmesine neden olabilir. Yüksek etkili bir bilgi değiştiğinde ikinci bir kişi veya kaynak sistemiyle çapraz kontrol yapın. Modelin emin görünmesi, belgenin veya görüntünün doğru anlaşıldığına dair kanıt değildir. Karar kaydı, örneğin hangi sürümde incelendiğini ve kabul edilmeyen sonucu da içermelidir. Böylece sonraki ekip üyesi aynı sonucu yeniden değerlendirebilir.
Sınırlar ve üretim kararı
Hata kaydını iki katmana ayırın: istek kimliği, zaman, HTTP durumu ve yeniden deneme sonucu gibi operasyon metadatası; ayrı olarak ise güvenli hata teşhisi. Bir istek durum kaydının kamuya açık API'nin promptu veya tamamlanmış yanıtı sakladığını kanıtladığını söylemeyin. EVREN'in retention politikası burada doğrulanmış değildir. Hassas içerik içeren hata örneklerini destek kaydına kopyalamayın; mümkünse içerik yerine kimliksiz hata sınıfı ve zaman bilgisini kullanın.
Üretim kararı için sınırları görünür bırakın. Bu yazı EVREN'in yayımlanmış model ve LLMTR gateway belgelerine dayanır; sağlayıcının kamuya açık olmayan davranışları için yeni bir söz vermez. Retention, eğitim veya silme gereksiniminiz varsa bunu satın alma ya da güvenlik incelemesinde yazılı soru olarak ele alın. Model, istek biçimi veya sağlayıcı şartı değiştiğinde aynı kabul testini yeniden çalıştırın. Karar kaydı, örneğin hangi sürümde incelendiğini ve kabul edilmeyen sonucu da içermelidir. Böylece sonraki ekip üyesi aynı sonucu yeniden değerlendirebilir.
Sık sorulan sorular
EVREN'i LLMTR üzerinden kullanmalı mıyım?
EVREN kullanmak isteyen kullanıcıya, kendi EVREN anahtarını tanıtarak LLMTR üzerinden kullanması önerilir. Bu tercih EVREN'in kendi saklama veya eğitim politikasını değiştirmez.
EVREN promptları veya yanıtları saklıyor mu?
Bu rehberin dayandığı kamuya açık kaynaklar doğrulanmış bir retention taahhüdü vermiyor. İstek durumu metadatası da prompt veya tamamlanmış yanıt içeriğinin saklandığını kanıtlamaz.
Üretimden önce neyi denemeliyim?
Yayımlanmış modaliteyi, temsilî ve hassas olmayan örneklerde doğruluk eşiğini, insan incelemesini ve hata davranışını test edin.