Независимое руководствоНезависимое руководство по Jev — модели TypeSafe AI
Практический путеводитель по Jev

От получения доступа до первого запроса

Как начать работу с Jev

Попробуйте свой вопрос с Jev без собственного API-ключа, а затем следуйте официальным шагам TypeSafe для получения доступа и подключения API.

Независимое руководствоПоследняя проверка Обновлено

Главное

Попробуйте свой вопрос здесь без собственного API-ключа. Для интеграции в приложение получите доступ к аккаунту и API TypeSafe через официальную консоль.

01

Начать без кода

Проверьте вопрос «Да/Нет» или 2–6 своих вариантов в бесплатной независимой демоверсии. Собственный API-ключ не нужен; живые проверки зависят от доступности сервиса.

Попробовать
02

Для разработчиков

Попробуйте свой вопрос здесь без собственного API-ключа. Для интеграции в приложение получите доступ к аккаунту и API TypeSafe через официальную консоль.

Отправьте минимальный запрос

Первый запрос к API

Отправьте минимальный запрос

Когда аккаунт TypeSafe будет готов, начните с одного state и одного именованного вопроса.

  1. Задайте TYPESAFE_API_KEY в локальном окружении.
  2. Отправьте один state и один вопрос Noul на документированный адрес.
  3. Прочитайте именованный ответ и расход токенов в ответе.
Открыть официальный справочник API

Это только пример структуры. Данный сайт не выполнял запрос и не измерял результат.

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 '{
  "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?"
    }
  }
}'

Практические руководства

Формулируйте вопросы точнее и разбирайтесь в результатах.

Начать без кода

Вы можете попробовать свой текст и вопрос в бесплатной независимой демоверсии этого сайта, не предоставляя API-ключ. Задайте правило «Да/Нет» или 2–6 вариантов. Чтобы подключить Jev к своему приложению, используйте отдельный официальный путь доступа к аккаунту и API TypeSafe, описанный ниже.

Демоверсия допускает до 10 000 символов суммарно в тексте, вопросе, правилах и вариантах, считая кодовые точки Unicode. Это лимит сайта, а не контекстное окно Jev. Живые проверки могут требовать подтверждения, что вы человек, и приостанавливаться при достижении квот или бюджета. Загрузка шаблона не запускает запрос и не подставляет результат модели.

Открыть редактор своей задачи · Загрузить шаблон классификации отзывов

1. Выберите подходящий способ получить доступ

В официальном объявлении от 21 сентября 2026 года TypeSafe сообщает, что Jev теперь доступен всем без списка ожидания. Откройте консоль TypeSafe, проверьте состояние аккаунта и следуйте инструкциям для Playground или API-ключа. В официальном кратком руководстве описаны шаги для Playground и API.

  • Если консоль открывается: попробуйте Jev в Playground или создайте API-ключ для подключения приложения.
  • Если консоль по-прежнему показывает проблему с доступом: воспользуйтесь официальной поддержкой TypeSafe и проверьте аккаунт, отображаемый в консоли. Этот сайт не может одобрять аккаунты или выдавать API-ключи.

Доступность и настройка могут измениться. Мы перепроверим эту страницу, если TypeSafe изменит порядок доступа; состояние конкретного аккаунта проверяйте в официальной консоли.

2. Попробуйте один узкий вопрос

В Playground возьмите короткое вымышленное сообщение в качестве входных данных и задайте один вопрос Noul. Например, используйте сообщение с просьбой перезвонить и спросите, содержится ли в нём явная просьба об обратном звонке. Затем замените его неопределённой просьбой о помощи и посмотрите, изменится ли результат.

Это ознакомительное упражнение, а не проверка точности. Два контрастных примера помогают понять, отражает ли вопрос именно то различие, которое вы хотели выделить.

Jev называет переданную информацию state, то есть контекстом. Это может быть строка, объект JSON или массив. В более сложных задачах используйте именованные поля, чтобы сообщение, подтверждающие записи и соответствующие правила оставались различимыми. Форматы входных данных

Для разработчиков

3. Отправьте первый запрос к API

Документированный адрес — POST https://api.typesafe.ai/v1/systemone. Он принимает имя модели, контекст и именованные вопросы. Для аутентификации используется bearer-токен. Справочник API

Безопасно задайте TYPESAFE_API_KEY в локальном окружении, затем выполните этот авторский пример в терминале:

Открыть технические подробности
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

В успешном ответе прочитайте answers.callback_requested.noul и usage.input_tokens. Поля ответа

Noul выражает оценочную вероятность ответа «да». Как интерпретировать Noul

Храните ключи в окружении терминала или сервера. Не помещайте их в браузерный JavaScript, публичный репозиторий, снимок экрана или пример для общего доступа. Это руководство никогда не предлагает вставить ключ на данный сайт.

4. Добавляйте структуру по мере необходимости

Используйте Choice, когда следующий шаг зависит от категории, Score — когда у вас есть осмысленные упорядоченные уровни, и Noul — когда нужна вероятность ответа «да» или «нет». Объединяйте независимые вопросы к одному контексту в запросе, а результаты обрабатывайте в приложении.

В качестве конкретного следующего шага разберите пример обращения в поддержку. В нём показано, как документированный вывод превращается в предложение по маршрутизации.

5. Разбирайтесь с доступом и запросом по отдельности

Если вход в консоль не завершается, повторно откройте официальную консоль через обычную точку входа и проверьте, что используете аккаунт с доступом. Не пытайтесь решить проблему входа в браузере многократными изменениями API-запроса. Успешный вход также не подтверждает, что ключ API уже выдан. Если нужна помощь с аккаунтом, воспользуйтесь официальным каналом поддержки TypeSafe; никогда не публикуйте ключ или ссылку для входа в открытом сообщении о проблеме.

При работе с HTTP-запросом сначала проверьте статус и тело ошибки, а уже затем меняйте вопрос:

Признак Что проверить дальше
Ответ 401 Проверьте ключ и заголовок аутентификации bearer
Ответ 422 Прочитайте возвращённые сведения об ошибке валидации и проверьте поля запроса
Ответ 429 Снизьте частоту запросов и повторите попытку с увеличением интервала
Ответ 529 Рассматривайте его как временную перегрузку и повторите попытку с увеличением интервала

Эти коды описаны в справочнике API. При 429 или 529 используйте экспоненциальное увеличение интервала. SDK по умолчанию уже выполняют повторные попытки; учитывайте их, прежде чем добавлять внешний цикл повторов.

Тайм-аут отличается от отрицательного ответа. Установите общий предельный срок и ограниченное число попыток, после чего направляйте нерешённые случаи на проверку. Убедитесь, что повтор запроса к модели не может повторить последующее действие, например создание назначения.

6. Разберитесь с неожиданным ответом

Что вы наблюдаете Что полезно проверить
Формально верный ответ на другой вопрос Сравните точные инструкции с нужным условием; явно укажите исключения
Результат изменился после правки Сохраняйте вместе версию модели, контекст, метки вариантов, их порядок и шкалу оценки
Оценка оказалась между уровнями Понимайте её как взвешенную позицию, а не целочисленную метку или точную величину
Убедительный результат при слабой доказательной базе Проверьте фактическое содержимое контекста; уверенность не восполняет отсутствующие записи
Два ответа противоречат друг другу Проверьте каждый вопрос независимо и задайте в коде правила разрешения конфликтов

Это редакционные рекомендации по отладке. Руководство по Score объясняет дробные значения; наша страница ограничений ссылается на текущие оговорки поставщика и отдельно отмеченные наблюдения участников сообщества.

Псевдоним jev-latest может начать указывать на более новую модель. Во время тестирования записывайте возвращённый идентификатор модели; когда важна воспроизводимость, используйте версионный идентификатор, поддерживаемый вашим аккаунтом. Псевдонимы моделей

7. Определите, готов ли первый рабочий процесс

Прежде чем включать автоматические действия, соберите небольшой набор ожидаемых решений, изучите ошибки и выберите пороговые значения для своего процесса. С помощью калькулятора стоимости оцените расходы на входные токены, а сравнение инструментов поможет определить, какие задачи стоит оставить другим средствам.

Источники и дополнительные материалы

Руководство опирается на официальную документацию и сообщения сообщества по ссылкам. Авторы наблюдений сообщества указаны.

  1. Состояние доступа к TypeSafe
  2. Публичное объявление TypeSafe о доступности
  3. Официальное краткое руководство
  4. Справочник HTTP API
  5. Контекст и форматы входных данных
  6. Модели и псевдонимы
Как мы проверяем источники