Guide indépendantUn guide indépendant sur Jev, le modèle de TypeSafe AI
Le guide pratique de Jev

De l’accès à la première requête

Comment démarrer avec Jev

Essayez une question personnalisée avec Jev sans votre propre clé API, puis suivez les étapes officielles de TypeSafe pour l’accès et l’intégration API.

Guide indépendantDernière vérification Mise à jour

L’essentiel

Essayez ici une question personnalisée sans votre propre clé API. Pour une intégration dans une application, obtenez l’accès au compte et à l’API TypeSafe via la console officielle.

01

Commencer sans code

Testez une question Oui/Non ou 2 à 6 options personnalisées dans cette démo gratuite et indépendante. Votre propre clé API n’est pas nécessaire ; les vérifications en direct dépendent de la disponibilité.

Essayer
02

Pour les développeurs

Essayez ici une question personnalisée sans votre propre clé API. Pour une intégration dans une application, obtenez l’accès au compte et à l’API TypeSafe via la console officielle.

Voir les détails techniques

Guides pratiques

Formulez des questions plus claires et comprenez le résultat.

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?"
    }
  }
}
JSON

Lisez 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.

  1. Accès à TypeSafe et liste d’attente
  2. Guide officiel de démarrage rapide
  3. Référence de l’API HTTP
  4. État et formats d’entrée
  5. Modèles et alias
Comment nous vérifions nos sources