Commencer sans code
Vous pouvez tester votre texte et votre question dans la démo gratuite et indépendante de ce site sans fournir de clé API. Définissez une règle Oui/Non ou 2 à 6 options. Pour connecter Jev à votre application, suivez la procédure officielle d’accès au compte et à l’API TypeSafe, expliquée séparément ci-dessous.
La démo autorise jusqu’à 10 000 caractères au total pour le texte, la question, les règles et les options, comptés en points de code Unicode. Il s’agit de la limite du site, pas de la fenêtre de contexte de Jev. Les vérifications en direct peuvent nécessiter une vérification humaine et s’arrêter aux limites d’usage ou de budget. Charger un modèle de tâche ne l’exécute pas et ne fournit aucun résultat du modèle.
Ouvrir l’éditeur personnalisé · Charger le modèle de classement des retours
1. Choisir le bon parcours d’accès
Au 17 septembre 2026, le site public de TypeSafe présente une liste d’attente. Le guide officiel de démarrage rapide fournit des instructions pour le Playground et l’API. Une page de documentation accessible ne signifie pas que tous les comptes ont accès au modèle.
- Si vous n’avez pas accès : utilisez la liste d’attente sur le site officiel de TypeSafe. Ce site ne peut ni approuver les comptes, ni délivrer des clés d’API.
- Si votre compte dispose d’un accès : ouvrez la console TypeSafe et suivez le parcours du Playground ou de création de clé d’API.
La disponibilité des comptes et les modalités de prise en main peuvent évoluer. La console officielle est l’endroit où vérifier votre propre situation.
2. Essayer une question précise
Dans le Playground, utilisez un court message fictif comme entrée et posez une question Noul. Par exemple, prenez un message demandant à être rappelé et demandez si un rappel est explicitement sollicité. Remplacez ensuite l’entrée par une demande d’aide vague et observez si le résultat change.
Il s’agit d’un exercice d’exploration, pas d’un test d’exactitude. Commencer par deux exemples contrastés permet de voir si votre question exprime bien la distinction souhaitée.
Jev appelle state les informations fournies. Il peut s’agir d’une chaîne, d’un objet JSON ou d’un tableau. Pour des tâches plus riches, utilisez des champs nommés pour distinguer le message, les données justificatives et la politique applicable. Formats d’entrée
Pour les développeurs
3. Envoyer une première requête à l’API
Le point d’accès documenté est POST https://api.typesafe.ai/v1/systemone. Il accepte un nom de modèle, un état et des questions nommées. L’authentification utilise un jeton de type Bearer. Référence de l’API
Définissez TYPESAFE_API_KEY de manière sécurisée dans votre environnement local, puis exécutez cet exemple original dans un terminal :
Voir les détails techniques
curl --fail-with-body --silent --show-error \
https://api.typesafe.ai/v1/systemone \
-H "Authorization: Bearer $TYPESAFE_API_KEY" \
-H "Content-Type: application/json" \
--data-binary @- <<'JSON'
{
"model": "jev-latest",
"state": "Please call me tomorrow morning to discuss the setup.",
"questions": {
"callback_requested": {
"type": "noul",
"instructions": "Does the sender explicitly ask for a phone call?"
}
}
}
JSONLisez answers.callback_requested.noul et usage.input_tokens dans une réponse réussie. Champs de réponse
Noul exprime la probabilité estimée d’une réponse positive. Interprétation de Noul
Conservez les clés dans l’environnement de votre terminal ou de votre serveur. Ne les intégrez pas au JavaScript du navigateur, à un dépôt public, à une capture d’écran ou à un exemple partagé. Ce guide ne vous demande jamais de coller une clé sur le site.
4. Ajouter de la structure uniquement si la tâche le nécessite
Utilisez Choice lorsque la prochaine étape dépend d’une catégorie, Score lorsque vous disposez de niveaux ordonnés significatifs et Noul lorsque vous avez besoin d’une probabilité oui/non. Regroupez les questions indépendantes portant sur le même état ; traitez leurs résultats dans votre application.
Pour une prochaine étape concrète, suivez l’exemple de ticket d’assistance. Il montre comment une sortie documentée devient une proposition de routage.
5. Diagnostiquer séparément l’accès et la requête
Si la connexion à la console n’aboutit pas, rouvrez la console officielle depuis son point d’entrée habituel et vérifiez que vous utilisez le compte qui dispose d’un accès. Évitez de modifier sans cesse votre requête à l’API pour résoudre un problème de connexion dans le navigateur. Une connexion réussie ne prouve pas non plus qu’une clé d’API a été délivrée. Si vous avez besoin d’aide pour votre compte, utilisez le canal d’assistance officiel de TypeSafe ; ne publiez jamais de clé ni de lien de connexion dans un signalement public.
Pour une requête HTTP, examinez le statut et le corps de l’erreur avant de modifier la question :
| Symptôme | Vérification suivante |
|---|---|
Réponse 401 |
Confirmer la clé et l’en-tête d’authentification Bearer |
Réponse 422 |
Lire les détails de validation renvoyés et vérifier les champs de la requête |
Réponse 429 |
Réduire la pression des requêtes et réessayer avec un délai croissant |
Réponse 529 |
Traiter le cas comme une surcharge temporaire et réessayer avec un délai croissant |
Ces codes figurent dans la référence de l’API. Pour 429 ou 529, utilisez un délai exponentiel entre les tentatives. Les SDK réessaient déjà par défaut ; tenez compte de ces tentatives avant d’ajouter une boucle externe de reprise.
Un délai d’attente dépassé est différent d’une réponse négative. Fixez une échéance globale et un nombre limité de tentatives, puis orientez les tâches non résolues vers une révision. Veillez à ce qu’une nouvelle tentative de requête au modèle ne puisse pas répéter une action en aval, comme la création d’une affectation.
6. Comprendre une réponse surprenante
| Ce que vous observez | Une piste d’investigation utile |
|---|---|
| Une réponse valide à la mauvaise question | Comparer les instructions exactes à la condition visée ; préciser les exceptions |
| Un résultat change après une modification | Enregistrer ensemble la version du modèle, l’état, les libellés des options, leur ordre et la grille d’évaluation |
| Un score se situe entre deux niveaux | Le lire comme une position pondérée, pas comme une étiquette entière ni une quantité exacte |
| Un résultat affirmé avec peu d’éléments à l’appui | Vérifier ce que contient réellement l’état ; la confiance ne fournit pas les données manquantes |
| Deux réponses se contredisent | Vérifier chaque question séparément et définir la règle de résolution des conflits dans le code |
Ces étapes de diagnostic sont des conseils éditoriaux. Le guide de Score explique les valeurs fractionnaires ; notre page des limites renvoie aux réserves actuelles du fournisseur et aux observations de la communauté, identifiées séparément.
L’alias jev-latest peut pointer vers un modèle plus récent. Enregistrez l’identifiant de modèle renvoyé pendant les tests ; si la reproductibilité compte, utilisez un identifiant versionné pris en charge par votre compte. Alias de modèles
7. Décider si le premier processus est prêt
Avant d’activer des actions automatiques, conservez un petit ensemble de décisions attendues, examinez les erreurs et choisissez les seuils de votre processus. Utilisez le calculateur de tarifs pour estimer les dépenses en tokens d’entrée et le guide comparatif pour déterminer ce qui doit rester confié à d’autres outils.
Sources et lectures complémentaires
Ce guide s’appuie sur la documentation officielle et les témoignages de la communauté liés. Les observations de la communauté sont attribuées à leurs auteurs.
- Accès à TypeSafe et liste d’attente
- Guide officiel de démarrage rapide
- Référence de l’API HTTP
- État et formats d’entrée
- Modèles et alias