API de décision

Jev API pour des décisions typées dans votre code

Jev est le modèle System One de TypeSafe AI. Il renvoie un Noul, un Choice ou un Score avec des probabilités plutôt que du texte. Obtenez une clé ici et appelez-le en un POST, sans liste d’attente.

{
  "model": "jev-1.13",
  "state": "I was charged twice for my subscription.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}

2 appels offerts pour les nouveaux comptes · 1 crédit par appel réussi · les appels échoués sont gratuits

Exemples

Huit décisions que vous pouvez lancer

Survolez une carte pour lire la requête. Copiez-la ou ouvrez-la dans le playground.

Router un paiement vide

Choice renvoie l’équipe et la probabilité de chacune.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
Ouvrir dans le playground

Est-ce une demande de remboursement ?

Noul renvoie une probabilité de oui, pas un paragraphe.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
Ouvrir dans le playground

Quelle urgence pour l’échec de versement

Score place la note sur votre échelle et renvoie la distribution.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
Ouvrir dans le playground

Demande d’identifiants dans un message

La probabilité Noul est le filtre avant la revue humaine.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
Ouvrir dans le playground

Qualifier une note entrante

Choice sépare une fenêtre d’achat d’un simple intérêt.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
Ouvrir dans le playground

Annonce à rendement garanti

Noul répond à la question de politique que vous avez écrite.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
Ouvrir dans le playground

Risque de renouvellement dans une note

Score utilise vos trois niveaux, d’improbable à annulation probable.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
Ouvrir dans le playground

Quelle exception de facture

Choice peut marquer un dépassement, une ligne imprévue, ou les deux.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
Ouvrir dans le playground

Réponse

Des réponses sur lesquelles le code peut brancher

Jev n’écrit pas un paragraphe à analyser. Il renvoie la décision demandée et sa probabilité.

Chaque option garde sa probabilité

Choice nomme le gagnant et renvoie encore la probabilité de chaque option.

Noul, Choice et Score en une requête

Jusqu’à six questions partagent un état et reviennent en une réponse. Un oui/non, un choix étiqueté et un score coûtent un aller-retour et un crédit.

Épinglez le modèle si le seuil compte

Envoyez jev-1.13 si vous réglez un seuil. jev-latest suit la version servie par cette API.

Mode d’emploi

Comment appeler Jev API

  1. 01

    Créez une clé

    Connectez-vous et copiez une clé. Le playground peut en créer une pour le compte.

  2. 02

    POST d’un état et de questions

    Le corps a model, state et une map de questions. Vos ids sont des étiquettes ; le texte va dans instructions.

  3. 03

    Branchez sur la réponse typée

    Lisez noul, choice ou score. Pour Choice et Score, confidence dit si les options sont proches.

Limites

Limites de Jev API sur cet endpoint

Ce que POST /api/v1/decisions accepte aujourd’hui.

ÉlémentCet endpoint
EndpointPOST /api/v1/decisions, clé Bearer
Modèlejev-1.13 (jev-latest est un alias)
Questions par appel1 à 6
Options de Choice2 à 8
Niveaux de Score2 à 10, le plus bas d’abord
StateChaîne, objet JSON ou tableau, jusqu’à 60 000 caractères
Facturation1 crédit par appel réussi ; les échoués sont gratuits
StreamingNon pris en charge

L’API propre de TypeSafe est POST https://api.typesafe.ai/v1/systemone. Elle accepte les ids versionnés comme jev-1.13.0, jusqu’à 255 options de Choice et facture par token d’entrée.

Référence complète dans Jev Docs

FAQ de Jev API

Qu’est-ce que Jev API ?

Jev API est le moyen pour un logiciel d’appeler Jev, le modèle System One de TypeSafe AI. Vous envoyez un état et des questions typées. Jev renvoie une probabilité Noul, un Choice avec une probabilité par option ou un Score sur votre échelle. Il n’écrit pas de texte.

Comment obtenir une clé Jev API ?

Connectez-vous et créez une clé dans le tableau de bord. Le playground peut en créer une à la première exécution. Les nouveaux comptes reçoivent 2 crédits, soit 2 appels réussis. Il n’y a pas de liste d’attente.

Combien coûte un appel Jev API ?

Un POST /api/v1/decisions réussi utilise 1 crédit, qu’il porte une ou six questions. Les erreurs de validation et les échecs amont n’en utilisent aucun. Environ 100 crédits coûtent 1 USD hors taxes. Les offres sont sur la page des tarifs.

Est-ce l’API officielle de TypeSafe ?

Non. TypeSafe AI construit et sert Jev. Ce site est un service d’API indépendant : clés, crédits et support viennent de ce site, pas d’un compte TypeSafe. Pour la console de TypeSafe et la facturation par token, allez sur typesafe.ai.

En quoi cet endpoint diffère-t-il de api.typesafe.ai/v1/systemone ?

Le corps a la même forme : model, state et questions de type noul, choice ou score. Ici le chemin est /api/v1/decisions, la clé vient du tableau de bord de ce site et l’id du modèle est jev-1.13 ou jev-latest. Les limites sont plus strictes : 1 à 6 questions, 2 à 8 options de Choice et 2 à 10 niveaux de Score.

Quelle est la différence entre Noul, Choice et Score ?

Noul est un oui/non avec une probabilité. Choice choisit une de vos options et renvoie la probabilité de chacune. Score place l’état sur votre échelle, du plus bas au plus haut.

Envoyez la première décision

Ouvrez le playground avec un exemple, ou suivez Jev Docs et appelez l’endpoint avec votre clé.