eu/jev: API классификации текста с размещением в Германии

eu/jev — независимый API решений под управлением Bevelites GmbH. Он предназначен для разработчиков, которым нужны структурированные ответы для маршрутизации обращений, классификации контента и оценки вариантов.

Для чего нужен eu/jev: простое объяснение

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

Категории и вопросы в запросе

Опишите смысл каждой категории, подготовьте обычные и неоднозначные сообщения с проверенными ответами. В instructions задайте вопрос, а в criteria — варианты. Документированный путь использует готовую модель, без предварительного обучения собственной. Это не отменяет проверки качества на данных вашей задачи.

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

Нужны допущенный аккаунт и ключ из панели. Заявки рассматриваются по доступной мощности; форма не создаёт аккаунт и не гарантирует допуск. Держите ключ на сервере.

Поместите контекст в state, именованный вопрос в questions. Отправьте JSON методом POST на https://eu-jev.com/v1/systemone с Bearer и Content-Type: application/json. Используйте jeff-latest либо документированную фиксированную версию вроде jeff-1.0.0. Сначала проверьте HTTP-статус, затем answers.team.choice, probabilities и confidence. State может быть объектом или массивом JSON.

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

В официальной документации также есть HTTP-примеры для JavaScript и Python.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "В счёте указано дополнительное списание. Прошу проверить.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Выбери команду для обработки сообщения.",
      "criteria": {
        "billing": "Счета, платежи и возвраты",
        "technical": "Ошибки, сбои и доступ к аккаунту"
      }
    }
  }
}'

Документация API и ошибок

Разница между выбором, вероятностью и оценкой

Choice выбирает из 2–10 вариантов и возвращает вероятности и confidence. Уверенность нормирована относительно равномерного угадывания и отличается от вероятности выбранного варианта. Noul даёт вероятность да/нет от 0 до 1. Score использует 2–10 упорядоченных критериев и возвращает ожидаемую позицию от 0 до N−1, вероятности и легенду.

Высокая уверенность не равна измеренной точности на ваших данных. Сравните ответы с проверенными примерами и оставьте контроль важных решений. В ответе также есть версия модели, входные токены, ID запроса и точная стоимость meta.cost_eur при успехе.

Стартовый кредит и оплата входных токенов

Проверено 5 октября 2026 года, EUR: новые допущенные аккаунты получают разовый рекламный кредит €5, без ежемесячного восстановления или автоматического списания оплаты. Тариф — €37 за миллиард входных токенов, то есть €0,037 за миллион; выходные токены бесплатны.

Вход включает контекст, инструкции, критерии и подготовку; общий state считается один раз. Повторный или кешированный вход имеет тот же тариф. Кредит расходуют только успешные результаты, включая Playground с входом в аккаунт. Если средств мало, HTTP 402 insufficient_credits останавливает запрос до инференса. Дополнительное использование запрашивается через форму; платные условия требуют отдельного явного соглашения.

Цена и условия использования

Размещение в Германии и обработка данных

Origin, база приложения и процесс модели находятся у Hetzner в Германии. На описанном пути инференса нет внешнего прокси модели или CDN. Вход и ответы не сохраняются в базе или логах приложения и не используются для обучения, но кеши RAM могут оставаться между запросами.

Данные аккаунта, использования, кредита и безопасности сохраняются, без автоматического удаления по возрасту записей аккаунта/использования. Google, почта и внешняя форма могут включать обработку вне ЕЭЗ, в том числе в США. Немецкий инференс не означает все данные исключительно в ЕС. Для делового использования персональных данных нужна DPA; в анонимном Playground используйте синтетический или неперсональный текст.

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

Конфиденциальность и данные · DPA для организаций

Ограничения интеграции

Все ключи и Playground с авторизацией делят 60 запросов/минуту на аккаунт. Анонимно разрешены 12/минуту и 100/день на посетителя. API: 256 KiB JSON, 100 000 символов строкового state, восемь вопросов, 1000 символов инструкции и 500 критерия после сериализации. Подготовленный контекст должен помещаться в 32 768 позиций с учётом ветвлений и оформления. Поле Playground отдельно ограничено 12 000 символами.

Запросы исполняются по одному, ключи приоритетны; ожидание в очереди — до 20 секунд. Соблюдайте Retry-After при 429/503 и исправляйте вход при 422. latency_ms не измеряет полный сетевой путь. Совместимость TypeSafe касается структуры HTTP: ID модели Jev дают 400, работа SDK и одинаковые ответы не гарантированы. Коммерческая интеграция подчиняется условиям; модель Winnow не делает сервис открытым или доступным для самостоятельного размещения.

Вопросы интеграции

Какие задачи классификации текста решает eu/jev?

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

Нужно ли обучать собственную модель для новых категорий?

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

Как проверить качество классификации перед автоматизацией?

Сравните типичные и сложные сообщения с проверенными ответами. Вероятности и уверенность не гарантируют правильность; предусмотрите участие человека при существенных последствиях.

Стартовый кредит обновляется каждый месяц?

Нет. Принятый аккаунт получает €5 один раз. Успешные вызовы расходуют баланс по тарифу входных токенов; дополнительное использование и оплата требуют отдельного явного соглашения.

Немецкий инференс означает, что все данные аккаунта остаются в ЕС?

Нет. Google, почта и форма могут включать обработку вне ЕЭЗ. Деловая обработка персональных данных требует DPA; место инференса не описывает все потоки сервиса.

Официальные материалы

• Официальные FAQ и модель
• Заявка на доступ или дополнительные объёмы