API решений

Jev API для типизированных решений в вашем коде

Jev — модель System One от TypeSafe AI. Она возвращает Noul, Choice или Score с вероятностями вместо текста. Получите ключ здесь и вызывайте её одним POST, без листа ожидания.

{
  "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 бесплатных вызова для новых аккаунтов · 1 кредит за успешный вызов · неудачные вызовы бесплатны

Примеры

Восемь решений, которые можно запустить

Наведите на карточку, чтобы увидеть запрос. Скопируйте или откройте в песочнице.

Маршрут пустой оплаты

Choice возвращает команду и вероятность каждой.

{
  "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."
      }
    }
  }
}
Открыть в песочнице

Это запрос возврата?

Noul возвращает вероятность «да», а не абзац.

{
  "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?"
    }
  }
}
Открыть в песочнице

Насколько срочен сбой выплаты

Score ставит текст на вашу шкалу и возвращает распределение.

{
  "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"
      ]
    }
  }
}
Открыть в песочнице

Запрос учётных данных в сообщении

Вероятность Noul — фильтр до ручной очереди.

{
  "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?"
    }
  }
}
Открыть в песочнице

Квалифицировать входящую заметку

Choice отделяет окно покупки от простого интереса.

{
  "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."
      }
    }
  }
}
Открыть в песочнице

Объявление с гарантированной доходностью

Noul отвечает на ваш вопрос политики, а не общим текстом.

{
  "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?"
    }
  }
}
Открыть в песочнице

Риск продления в заметке

Score использует ваши три уровня, от маловероятно до отмены.

{
  "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"
      ]
    }
  }
}
Открыть в песочнице

Какое исключение счёта

Choice отмечает превышение PO, лишнюю строку или оба варианта.

{
  "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."
      }
    }
  }
}
Открыть в песочнице

Ответ

Ответы, по которым код может ветвиться

Jev не пишет абзац для разбора. Он возвращает запрошенное решение и его вероятность.

У каждого варианта остаётся вероятность

Choice называет победителя и всё равно возвращает вероятность каждого варианта.

Noul, Choice и Score в одном запросе

До шести вопросов делят одно состояние и возвращаются в одном ответе. Да/нет, выбор с метками и оценка стоят один запрос и один кредит.

Фиксируйте модель, если важен порог

Отправляйте jev-1.13, если настраиваете порог. jev-latest — версия, которую сейчас отдаёт этот API.

Как вызвать

Как вызвать Jev API

  1. 01

    Создайте ключ

    Войдите и скопируйте ключ. Песочница может создать ключ для аккаунта.

  2. 02

    POST состояния и вопросов

    В теле model, state и карта вопросов. Ваши id — только метки, текст вопроса в instructions.

  3. 03

    Ветвитесь по типизированному ответу

    Читайте noul, choice или score. У Choice и Score confidence показывает, близки ли варианты.

Лимиты

Лимиты Jev API на этом endpoint

Что POST /api/v1/decisions принимает сегодня.

ПараметрЭтот endpoint
EndpointPOST /api/v1/decisions, Bearer-ключ
Модельjev-1.13 (jev-latest — псевдоним)
Вопросов за вызов1–6
Варианты Choice2–8
Уровни Score2–10, от низшего
StateСтрока, JSON-объект или массив, до 60 000 символов
Оплата1 кредит за успешный вызов; неудачные бесплатны
СтримингНе поддерживается

Собственный API TypeSafe — POST https://api.typesafe.ai/v1/systemone. Он принимает версионные id вроде jev-1.13.0, допускает до 255 вариантов Choice и тарифицирует по входным токенам.

Полная справка в Jev Docs

Частые вопросы о Jev API

Что такое Jev API?

Jev API — это способ вызвать Jev, модель System One от TypeSafe AI, из программы. Вы отправляете состояние и типизированные вопросы. Jev возвращает вероятность Noul, Choice с вероятностью каждого варианта или Score на вашей шкале. Текст он не пишет.

Как получить ключ Jev API?

Войдите и создайте ключ в панели. Песочница может создать его при первом запуске. Новые аккаунты получают 2 кредита — это 2 успешных вызова. Листа ожидания нет.

Сколько стоит вызов Jev API?

Успешный POST /api/v1/decisions списывает 1 кредит, с одним вопросом или шестью. Ошибки валидации и сбои upstream не списывают ничего. Примерно 100 кредитов стоят 1 USD без налогов. Тарифы — на странице цен.

Это официальный API TypeSafe?

Нет. Jev создаёт и обслуживает TypeSafe AI. Этот сайт — независимый API-сервис: ключи, кредиты и поддержка исходят от этого сайта, а не от аккаунта TypeSafe. За консолью TypeSafe и ценами за токен — на typesafe.ai.

Чем этот endpoint отличается от api.typesafe.ai/v1/systemone?

Тело имеет ту же форму: model, state и questions типа noul, choice или score. Здесь путь — /api/v1/decisions, ключ берётся в панели этого сайта, id модели — jev-1.13 или jev-latest. Лимиты жёстче: 1–6 вопросов, 2–8 вариантов Choice и 2–10 уровней Score.

Чем отличаются Noul, Choice и Score?

Noul — да/нет с вероятностью. Choice выбирает один из ваших вариантов и возвращает вероятность каждого. Score ставит состояние на вашу шкалу, от низшего.

Отправьте первое решение

Откройте песочницу с примером или следуйте Jev Docs и вызовите endpoint своим ключом.