eu/jev: API klasyfikacji tekstu hostowane w Niemczech

eu/jev to niezależne API decyzji prowadzone przez Bevelites GmbH. Pomaga programistom kierować zgłoszenia, klasyfikować treści i oceniać opcje na podstawie opisanych kryteriów.

eu/jev w prostych słowach

Jeśli klient pisze o błędnej fakturze, opisujesz kategorie „rozliczenia” i „pomoc techniczna”. System zwraca wybór wraz z informacją o prawdopodobieństwie, a twoja aplikacja może wykorzystać odpowiedź do przekierowania. Playground pokazuje mechanizm; połączenie z systemem zgłoszeń i wykonanie działań należą do integracji.

Własne kategorie w żądaniu API

Potrzebujesz przyjętego konta i klucza z panelu. Wnioski są oceniane według dostępnej pojemności; formularz nie zakłada konta ani nie gwarantuje dostępu. Klucz trzymaj na serwerze.

Umieść kontekst w state, nazwij pytanie w questions i opisz 2–10 opcji dla choice. Wyślij JSON przez POST do https://eu-jev.com/v1/systemone z Bearer oraz Content-Type: application/json. Wybierz jeff-latest albo udokumentowaną wersję, np. jeff-1.0.0. Sprawdź status HTTP, a następnie answers.team.choice, probabilities i confidence. State może też być obiektem lub tablicą JSON.

Przykład opiera się na dokumentacji; nie wykonano wywołania z prawdziwym kluczem. Pełna lista języków nie jest opublikowana, dlatego przetestuj teksty projektu.

Oficjalna dokumentacja zawiera też przykłady HTTP w JavaScript i Pythonie.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "Na fakturze jest dodatkowe obciążenie. Proszę o sprawdzenie.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Wybierz zespół odpowiedzialny za wiadomość.",
      "criteria": {
        "billing": "Faktury, płatności i zwroty",
        "technical": "Błędy, awarie i dostęp do konta"
      }
    }
  }
}'

Dokumentacja API i błędów

Wybór, prawdopodobieństwo i skala ocen

Choice zwraca opcję, rozkład prawdopodobieństw i confidence. Pewność jest normalizowana względem równomiernego zgadywania, więc nie jest prawdopodobieństwem wybranej opcji. Noul daje prawdopodobieństwo tak/nie od 0 do 1. Score używa 2–10 uporządkowanych kryteriów i zwraca oczekiwaną pozycję od 0 do N−1, wraz z prawdopodobieństwami i legendą.

Odpowiedź zawiera także wersję modelu, tokeny wejścia, identyfikator żądania i dokładny koszt meta.cost_eur przy sukcesie.

Sprawdzenie jakości na własnych tekstach

Przygotuj reprezentatywne wiadomości z ocenionymi odpowiedziami, przypadki niejednoznaczne i rzadkie kategorie. Porównaj wyniki przed ustawieniem progów automatyzacji. Wysoka pewność nie jest zmierzoną trafnością na twoich danych; ważne lub niepewne decyzje powinny mieć drogę kontroli przez człowieka.

Dostęp, kredyt i rozliczenie tokenów

Stan na 5 października 2026, EUR: nowe przyjęte konta dostają jednorazowy promocyjny kredyt €5, bez comiesięcznego odnawiania i automatycznych obciążeń. Stawka wynosi €37 za miliard tokenów wejścia, czyli €0,037 za milion; wyjście jest bezpłatne.

Wlicza się kontekst, instrukcje, kryteria i przygotowanie; wspólny state liczony jest raz. Powtórzone i buforowane wejście ma tę samą stawkę. Saldo zużywają tylko udane wyniki, także w zalogowanym Playground. Za małe saldo powoduje HTTP 402 insufficient_credits przed inferencją. Dodatkowe użycie wymaga wniosku; płatność opiera się na osobnym wyraźnym porozumieniu.

Ceny i warunki usługi

Przetwarzanie danych w Niemczech

Serwer origin, baza aplikacji i proces modelu działają u Hetzner w Niemczech, bez zewnętrznego proxy modelu lub CDN w opisanej ścieżce. Wejście i odpowiedzi nie są utrwalane w bazie lub logach aplikacji ani używane do treningu; bufory RAM mogą jednak przetrwać między żądaniami.

Dane konta, użycia, salda i bezpieczeństwa są przechowywane bez automatycznego usuwania według wieku rekordów konta/użycia. Google, poczta i formularz mogą obejmować przetwarzanie poza EOG, w tym w USA. Nie oznacza to wszystkich danych wyłącznie w UE. Firmowe przetwarzanie danych osobowych wymaga DPA; w anonimowym Playground używaj danych syntetycznych lub nieosobowych.

Przetwarzanie wrażliwe lub wysokiego ryzyka wymaga odrębnych pisemnych warunków i zabezpieczeń; istotne decyzje potrzebują odpowiedniej kontroli człowieka.

Prywatność i przetwarzanie · DPA dla firm

Ograniczenia wywołań

Klucze i zalogowany Playground dzielą 60 żądań/minutę na konto; anonimowo jest 12/minutę i 100/dzień na odwiedzającego. Maksimum to 256 KiB JSON, 100 000 znaków state tekstowego, osiem pytań, 1000 znaków instrukcji i 500 kryterium po serializacji. Przygotowany kontekst musi zmieścić się w 32 768 pozycjach, razem z rozgałęzieniami i formatowaniem. Pole Playground ograniczono do 12 000 znaków.

Żądania są wykonywane pojedynczo, z pierwszeństwem kluczy i oczekiwaniem w kolejce do 20 sekund. Respektuj Retry-After przy 429/503, skróć nieodpowiednie wejście przy 422. latency_ms nie mierzy pełnej drogi sieciowej. Zgodność TypeSafe dotyczy struktury HTTP: identyfikatory Jev dają 400, SDK i identyczne wyniki nie są gwarantowane. Komercyjna integracja podlega warunkom; model Winnow nie ustanawia otwartej licencji lub własnego hostingu dla usługi.

Pytania o integrację

Do czego służy klasyfikacja tekstu w eu/jev?

Do przypisywania treściom kategorii i uzyskiwania ocen strukturalnych, np. do kierowania zgłoszeń. Aplikacja musi wykorzystać wynik w dalszej pracy.

Jak opisać własne kategorie w żądaniu API?

W choice podajesz nazwy i opisy kategorii jako criteria. Dokumentowany sposób wykorzystuje istniejący model i nie wymaga własnego treningu.

Czy prawdopodobieństwo odpowiedzi jest gwarancją poprawności?

Nie. Sprawdź wyniki na ocenionych przykładach, pamiętaj o różnicy między prawdopodobieństwem a confidence i zachowaj kontrolę ważnych decyzji.

Czy kredyt początkowy odnawia się co miesiąc?

Nie. Przyjęte konta dostają jednorazowo €5. Udane żądania zużywają saldo według ceny tokenów wejściowych; dodatkowe użycie i płatności wymagają osobnej umowy.

Czy niemiecka inferencja oznacza wszystkie dane konta wyłącznie w UE?

Nie. Google, poczta i formularz mogą wiązać się z przetwarzaniem poza EOG. Biznesowe użycie danych osobowych wymaga DPA, niezależnie od niemieckiej inferencji.

Oficjalne zasoby

• FAQ i model bazowy
• Wniosek o dostęp lub dodatkowe użycie