eu/jev: API de classificação de texto na Alemanha

eu/jev é uma API independente operada pela Bevelites GmbH. Desenvolvedores podem usá-la para classificar conteúdo, encaminhar chamados e avaliar opções a partir de critérios descritos.

O que o eu/jev faz, em linguagem simples

Imagine uma mensagem sobre uma cobrança incorreta. Você descreve as categorias «faturamento» e «suporte técnico», e o serviço devolve uma escolha com probabilidades. Seu aplicativo pode usar esses campos para definir o próximo passo. O Playground demonstra a interação; conectar o resultado ao sistema de atendimento e executar ações continua sendo parte da sua integração.

Como definir categorias para seus textos

Escreva o significado dos rótulos e prepare exemplos representativos, inclusive casos ambíguos. Choice aceita 2–10 opções e retorna escolha, probabilidades e confidence. A confiança é normalizada em relação a uma escolha uniforme e difere da probabilidade da opção selecionada. Noul devolve uma probabilidade sim/não de 0 a 1. Score usa 2–10 critérios ordenados e uma posição esperada entre 0 e N−1, com probabilidades e legenda.

Uma primeira chamada à API

Você precisa de uma conta admitida e chave do painel. O acesso é analisado conforme a capacidade; enviar o formulário não cria conta nem garante aprovação. Mantenha a chave no servidor.

Coloque o contexto em state e uma pergunta nomeada em questions. Envie JSON via POST para https://eu-jev.com/v1/systemone com Bearer e Content-Type: application/json. Use jeff-latest ou versão documentada fixa, como jeff-1.0.0. Verifique o status HTTP antes de answers.team.choice, probabilities e confidence. State também pode ser objeto ou array JSON.

O exemplo segue a documentação, sem chamada autenticada testada. Não há lista completa de idiomas publicada: valide português e seus próprios textos.

A documentação oficial também traz exemplos HTTP em JavaScript e Python.

curl https://eu-jev.com/v1/systemone \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "jeff-latest",
  "state": "A fatura tem uma cobrança adicional. Preciso de uma verificação.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Escolha a equipe responsável pela mensagem.",
      "criteria": {
        "billing": "Faturas, pagamentos e reembolsos",
        "technical": "Erros, interrupções e acesso à conta"
      }
    }
  }
}'

Documentação da API e erros

Validar resultados antes de automatizar

Compare previsões com respostas revisadas e examine rótulos raros e mensagens difíceis. Uma confiança alta não é precisão medida no seu projeto. Defina quais decisões pedem revisão humana. A resposta identifica também modelo, tokens de entrada, ID da requisição e, em caso de sucesso, o custo exato meta.cost_eur.

Crédito inicial e cobrança por tokens

Verificado em 5 de outubro de 2026, em EUR: novas contas admitidas recebem €5 de crédito promocional único, sem renovação mensal ou cobrança automática. A tarifa é €37 por bilhão de tokens de entrada, ou €0,037 por milhão. Tokens de saída são gratuitos.

Contexto, instruções, critérios e preparação contam como entrada; state compartilhado conta uma vez. Entradas repetidas ou em cache têm a mesma tarifa. Só resultados bem-sucedidos consomem o saldo, também usado pelo Playground com login. Saldo insuficiente gera HTTP 402 insufficient_credits antes da inferência. Uso extra deve ser solicitado pelo formulário; pagamento exige acordo expresso separado.

Preço e termos do serviço

Hospedagem na Alemanha e privacidade

Origem, banco da aplicação e processo do modelo ficam na Hetzner, Alemanha, sem proxy externo de modelo ou CDN no caminho documentado. Entradas e respostas não são persistidas no banco ou logs da aplicação nem usadas para treinamento; caches em RAM podem permanecer entre requisições.

Dados de conta, uso, crédito e segurança são armazenados, sem exclusão automática por idade dos registros de conta/uso. Login Google, e-mail e formulário externo podem envolver processamento fora do EEE, inclusive nos EUA. Inferência alemã não significa todos os fluxos somente na UE. Uso empresarial com dados pessoais exige DPA; no Playground anônimo use dados sintéticos ou não pessoais.

Processamento sensível ou de alto risco exige condições escritas e salvaguardas separadas; decisões importantes precisam de revisão humana adequada.

Privacidade e tratamento · DPA para uso empresarial

Limites da integração

Chaves e Playground com login dividem 60 chamadas/minuto por conta. O anônimo permite 12/minuto e 100/dia por visitante. Limites da API: 256 KiB de JSON, 100.000 caracteres de state texto, oito perguntas, 1.000 caracteres por instrução e 500 por critério serializado. A entrada preparada deve caber em 32.768 posições de contexto, contando ramos e formato. O campo Playground tem limite separado de 12.000 caracteres.

As chamadas são atendidas uma de cada vez, com prioridade para chaves e fila de até 20 segundos. Respeite Retry-After em 429/503 e ajuste a entrada em 422. latency_ms não é latência de ponta a ponta. A compatibilidade TypeSafe cobre a estrutura HTTP: IDs Jev dão 400, sem garantia de SDK ou respostas iguais. Integrações comerciais seguem os termos; Winnow como modelo base não torna o serviço aberto ou auto-hospedável.

Dúvidas de integração

Para que serve a classificação de texto no eu/jev?

Para transformar contexto em categorias ou avaliações estruturadas, como o encaminhamento de chamados. O aplicativo executa a ação posterior.

Preciso treinar um modelo para criar categorias?

O caminho documentado usa o modelo hospedado e categorias descritas no pedido, sem treinamento próprio prévio. Testes continuam necessários.

Como testar a classificação com textos do meu projeto?

Use textos representativos com respostas verificadas, incluindo casos ambíguos. Probabilidade e confidence não garantem acerto, então preserve revisão para decisões relevantes.

O crédito inicial é renovado todo mês?

Não. Os €5 são concedidos uma única vez às contas aceitas. Chamadas bem-sucedidas usam o saldo pelo preço dos tokens de entrada; uso adicional e pagamentos precisam de acordo separado.

A hospedagem alemã cobre todos os dados de conta?

Não. Login Google, e-mail e formulário podem envolver processamento fora do EEE. Dados pessoais em uso empresarial exigem DPA; a localização da inferência não define todos os fluxos.

Recursos oficiais

• FAQ e modelo de base
• Solicitar acesso ou uso adicional