eu/jev : API de classification de texte hébergée en Allemagne

eu/jev est une API indépendante de Bevelites GmbH pour obtenir des décisions structurées à partir d’un contexte. Elle s’adresse aux développeurs qui veulent classer des contenus, orienter des demandes ou évaluer des options.

eu/jev expliqué simplement

Pour un message signalant une erreur de facturation, vous décrivez les catégories «facturation» et «support technique». Le service choisit une option et fournit des informations de probabilité. Votre application peut exploiter ces champs pour orienter la demande. Le Playground montre le principe ; l’intégration au système métier et l’action finale restent à votre charge.

Définir les catégories avant l’appel API

Il faut un compte admis et une clé créée dans le tableau de bord. Les demandes d’accès sont examinées selon la capacité disponible ; le formulaire ne garantit pas l’admission. Gardez la clé côté serveur.

Placez le contexte dans state, nommez la question dans questions et décrivez 2–10 options pour choice. Envoyez du JSON par POST à https://eu-jev.com/v1/systemone avec Bearer et Content-Type: application/json. jeff-latest suit la version courante ; jeff-1.0.0 est un exemple de version documentée à fixer. Vérifiez le statut HTTP avant answers.team.choice, probabilities et confidence.

L’exemple est fondé sur la documentation, sans appel authentifié effectué. State accepte aussi un objet ou un tableau JSON. La liste complète des langues n’est pas publiée : testez la langue et les textes de votre usage.

La documentation officielle propose également des exemples HTTP en JavaScript et Python.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "Une facture comporte un paiement supplémentaire. Pouvez-vous vérifier ?",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Choisir l’équipe qui doit traiter ce message.",
      "criteria": {
        "billing": "Factures, paiements et remboursements",
        "technical": "Erreurs, interruptions et accès au compte"
      }
    }
  }
}'

Documentation API et erreurs

Passer du résultat à une décision vérifiable

Choice renvoie une option, ses probabilités et confidence, normalisée par rapport à un choix uniforme. Cette confiance diffère de la probabilité de l’option sélectionnée. Noul donne une probabilité oui/non de 0 à 1. Score reçoit 2–10 critères ordonnés et renvoie une position attendue de 0 à N−1 avec probabilités et légende.

Comparez les réponses à des exemples contrôlés avant de choisir un seuil d’automatisation. La réponse indique aussi la version du modèle, les tokens d’entrée, l’identifiant de requête et, en cas de succès, meta.cost_eur.

Hébergement allemand et données de compte

L’origine, la base applicative et le processus d’inférence sont chez Hetzner en Allemagne. Le trajet documenté n’utilise ni proxy de modèle externe ni CDN. Les entrées et réponses ne sont pas enregistrées dans la base ou les logs applicatifs, ni utilisées pour l’entraînement. Des caches en RAM peuvent toutefois persister entre requêtes.

Les données de compte, d’usage, de crédit et de sécurité sont conservées, sans suppression automatique liée à l’âge des données de compte/usage. Google, les courriels et le formulaire externe peuvent impliquer des traitements hors EEE, notamment aux États-Unis. L’inférence allemande ne signifie donc pas que tous les flux restent dans l’UE. Un usage professionnel avec données personnelles requiert une DPA ; le Playground anonyme doit recevoir des textes synthétiques ou non personnels.

Les traitements sensibles ou à haut risque exigent des conditions écrites et des garanties distinctes ; les décisions importantes nécessitent une vérification humaine adaptée.

Confidentialité et traitement · DPA professionnelle

Coût, crédit de départ et accès

Conditions vérifiées le 5 octobre 2026, en EUR : les nouveaux comptes admis reçoivent €5 de crédit promotionnel unique, sans remise à niveau mensuelle ni débit automatique. Le tarif est €37 par milliard de tokens d’entrée, soit €0,037 par million ; les tokens de sortie sont gratuits.

Contexte, instructions, critères et préparation comptent comme entrée. Le contexte partagé compte une fois ; les entrées répétées ou en cache gardent le même tarif. Seuls les résultats réussis consomment le solde, commun aux clés et au Playground connecté. HTTP 402 insufficient_credits arrête une requête trop chère avant l’inférence. L’usage supplémentaire se demande par formulaire ; tout paiement nécessite un accord exprès distinct.

Tarif et conditions d’utilisation

Limites techniques et migration

Les clés et le Playground connecté partagent 60 requêtes/minute par compte. En anonyme : 12/minute et 100/jour par visiteur. Maximum : corps JSON de 256 KiB, state texte de 100 000 caractères, huit questions, 1 000 caractères par instruction et 500 par critère sérialisé. Le contexte préparé doit tenir dans 32 768 positions, branches et format inclus ; le champ Playground est limité à 12 000 caractères.

Les requêtes sont traitées une par une, clés prioritaires, avec jusqu’à 20 secondes en file. Respectez Retry-After pour 429/503 et réduisez une entrée problématique avec 422. latency_ms n’est pas une latence de bout en bout.

La compatibilité TypeSafe concerne le format HTTP, sans garantie de SDK ou de résultats identiques. Les identifiants de modèle Jev donnent 400. L’intégration commerciale suit les conditions ; le modèle Winnow ne rend pas le service hébergé open source ou auto-hébergeable.

Questions sur la classification

À quoi sert la classification de texte avec eu/jev ?

À transformer un texte en catégorie ou en jugement structuré utilisable par une application. Les exemples comprennent l’orientation des demandes et le classement de contenus.

Faut-il entraîner un modèle pour définir les catégories ?

Le parcours documenté utilise le modèle hébergé et les descriptions de catégories dans la requête, sans entraînement personnel préalable. Il reste nécessaire de tester les résultats.

Comment relier une catégorie renvoyée à une action métier ?

Lisez les champs renvoyés, associez-les à vos règles métier et prévoyez une vérification humaine pour les résultats incertains ou importants. L’API n’exécute pas automatiquement votre workflow.

Le crédit de départ revient-il chaque mois ?

Non. Les €5 sont accordés une seule fois aux comptes admis. Les appels réussis consomment le solde au tarif des tokens entrants ; un usage supplémentaire et tout paiement nécessitent un accord distinct.

L’hébergement allemand concerne-t-il toutes les données de compte ?

Non. Google, les courriels et le formulaire peuvent impliquer des traitements hors EEE. Les données personnelles professionnelles requièrent une DPA, même si le calcul du modèle se fait en Allemagne.

Ressources officielles

• FAQ officielle et modèle
• Demande d’accès ou d’usage supplémentaire