eu/jev: Almanya’da barındırılan metin sınıflandırma API’si

Bevelites GmbH tarafından işletilen eu/jev, bağımsız bir karar API’sidir. Geliştiriciler destek mesajlarını yönlendirmek, içeriği sınıflandırmak ve seçenekleri açıklanan ölçütlere göre değerlendirmek için kullanabilir.

eu/jev ne işe yarar? Basit bir açıklama

Hatalı bir fatura hakkında müşteri mesajı aldığınızı düşünün. Ödeme ve teknik destek kategorilerini tarif edersiniz; eu/jev bir seçim ve olasılık bilgisi döndürür. Uygulamanız bu alanlarla sonraki adımı belirler. Playground örnek etkileşimi gösterir; destek sistemine bağlanma ve işlemi gerçekleştirme entegrasyonunuzun görevidir.

İstek içinde etiketleri tanımlama

Kategorilere açık anlamlar ve örnekler verin. Sık görülen mesajlar kadar belirsiz ve az rastlanan durumları da hazırlayın. Görevinizi doğrudan sorunun instructions alanında, seçenekleri criteria içinde anlatabilirsiniz. Belgelenen kullanım, barındırılan modeli kullanır; önceden kendi modelinizi eğitme adımı istemez. Yine de doğruluğu kendi verinizle ölçmeniz gerekir.

Choice, Noul ve Score sonuçlarını okuma

Choice, 2–10 seçenekten birini, probabilities ve confidence ile döndürür. Confidence eşit olasılıklı tahmine göre normalize edilir; seçilen seçeneğin olasılığıyla aynı değildir. Noul 0–1 aralığında evet/hayır olasılığı verir. Score, 2–10 sıralı ölçüt üzerinde 0 ile N−1 arasında beklenen konumu, olasılıkları ve açıklama anahtarını verir.

Yanıt ayrıca model sürümü, giriş token sayısı, istek kimliği ve başarılı çağrıda meta.cost_eur içerir. Yüksek güven değerini hatasız sonuç garantisi saymayın.

İlk API çağrısı ve sonucu kontrol etme

Kabul edilmiş hesap ve panelden alınmış API anahtarı gerekir. Erişim başvuruları kapasiteye göre değerlendirilir; form hesap oluşturmaz ve kabul garantisi vermez. Anahtarı sunucuda saklayın.

Bağlamı state, adlandırılmış soruyu questions içine koyun. Bearer ve Content-Type: application/json ile https://eu-jev.com/v1/systemone adresine JSON POST edin. jeff-latest ya da jeff-1.0.0 gibi belgelenmiş sabit sürümü kullanın. Önce HTTP durumunu, sonra answers.team.choice, probabilities ve confidence alanlarını okuyun. State JSON nesnesi veya dizi de olabilir.

Örnek belge formatından hazırlanmıştır; gerçek anahtarla çağrı yapılmamıştır. Tam dil listesi yayımlanmadığı için Türkçe ve proje metinlerini örneklerle sınayın.

Resmî belgelerde JavaScript ve Python için HTTP örnekleri de bulunur.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "Faturada ek bir ödeme görünüyor. Kontrol edilmesini istiyorum.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Bu mesajı ele alması gereken ekibi seç.",
      "criteria": {
        "billing": "Faturalar, ödemeler ve iadeler",
        "technical": "Hatalar, kesintiler ve hesap erişimi"
      }
    }
  }
}'

API formatı ve hatalar

Başlangıç kredisi ve kullanım maliyeti

5 Ekim 2026 tarihinde EUR olarak doğrulandı: yeni kabul edilen hesaplara bir defalık €5 promosyon kredisi verilir; aylık yenileme veya otomatik tahsilat yoktur. Fiyat milyar giriş token başına €37, yani milyon başına €0,037’dir. Çıkış tokenları ücretsizdir.

Bağlam, talimatlar, ölçütler ve hazırlık tokenları sayılır; paylaşılan state bir kez sayılır. Tekrarlanan veya önbellekteki girişin fiyatı aynıdır. Yalnızca başarılı yanıtlar bakiye tüketir; giriş yapılmış Playground aynı bakiyeyi kullanır. Yetersiz bakiye, çıkarım öncesinde HTTP 402 insufficient_credits döndürür. Ek kullanım formdan istenir; ödeme ayrı açık anlaşma gerektirir.

Ücretler ve hizmet şartları

Almanya barındırması ve veri kapsamı

Origin, uygulama veritabanı ve model işlemi Almanya’da Hetzner’dedir; belgelenen çıkarım yolunda harici model proxy’si veya CDN yoktur. Giriş ve yanıtlar uygulama veritabanı/loglarına kalıcı kaydedilmez ve eğitimde kullanılmaz; RAM önbellekleri istekler arasında kalabilir.

Hesap, kullanım, kredi ve güvenlik verileri saklanır; hesap/kullanım kayıtları için yaşa dayalı otomatik silme işi yoktur. Google girişi, e-posta ve form, ABD dahil AEA dışı işleme içerebilir. Alman çıkarımı bütün verilerin yalnızca AB’de kalması demek değildir. İş amaçlı kişisel veri için DPA gerekir; anonim Playground’da sentetik veya kişisel olmayan içerik kullanın.

Hassas veya yüksek riskli işleme ayrı yazılı koşullar ve korumalar gerektirir; önemli kararlar uygun insan incelemesine tabi olmalıdır.

Gizlilik ve veri işleme · İş kullanımı için DPA

İstek sınırları ve uyumluluk

Anahtarlar ve giriş yapılmış Playground hesap başına 60 istek/dakikayı paylaşır. Anonim sınır ziyaretçi başına 12/dakika ve 100/gündür. API sınırları: 256 KiB JSON, metin state için 100.000 karakter, sekiz soru, talimat başına 1.000 ve serileştirilmiş ölçüt başına 500 karakter. Hazırlanmış giriş, dallar ve biçimlendirme dahil 32.768 bağlam konumuna sığmalıdır. Playground metin alanı ayrıca 12.000 karakterdir.

İstekler tek tek işlenir; anahtarlılar önceliklidir, kuyrukta en fazla 20 saniye beklenebilir. 429/503 için Retry-After’a uyun, 422’de girdiyi değiştirin. latency_ms uçtan uca gecikme değildir. TypeSafe uyumluluğu HTTP yapısıyla sınırlıdır; Jev model kimlikleri 400 verir, SDK ve aynı sonuçlar garanti edilmez. Ticari entegrasyon şartlara tabidir; Winnow taban modeli hizmeti açık kaynak veya kendi sunucunuzda çalıştırılabilir yapmaz.

Sık sorulan sorular

eu/jev metni nasıl sınıflandırır?

Bağlam ve açıklanan seçeneklerden kategoriler veya yapılandırılmış değerlendirmeler üretir. Sonraki uygulama işlemini sizin entegrasyonunuz yürütür.

Etiketleri API isteğinde nasıl tanımlarım?

Choice için criteria içinde kategori adlarını ve açıklamalarını verin. Mevcut model bu isteği işler; belgelenen yol kendi eğitim sürecinizi gerektirmez.

Olasılık değerini otomatik karar için nasıl değerlendiririm?

Kontrol edilmiş örneklerle karşılaştırın, hata ve belirsiz durumları inceleyin. Önemli sonuçlar için insan incelemesi sağlayın; olasılık doğruluk garantisi değildir.

Başlangıç kredisi her ay yenilenir mi?

Hayır. Kabul edilen hesaplara bir defa €5 verilir. Başarılı çağrılar giriş token ücretine göre bakiyeyi kullanır; ek kullanım ve ödeme ayrı açık anlaşma gerektirir.

Alman barındırması tüm hesap verilerinin AB’de kalması demek mi?

Hayır. Google girişi, e-posta ve form AEA dışında işleme içerebilir. İş amaçlı kişisel veriler için DPA gerekir; çıkarım konumu tüm hizmet akışlarını kapsamaz.

Resmî kaynaklar

• Resmî SSS ve taban model
• Erişim veya ek kullanım başvurusu