Teste aqui, depois crie sua chave
Abra o Playground do jevmodel.org e teste uma decisão estreita. Quando a saída for útil, entre, abra o Dashboard, crie uma API key e salve-a como JEVMODEL_API_KEY no seu servidor.
Mantenha o conjunto de respostas pequeno e estável. Nomeie o campo conforme o ramo que seu código vai tomar, não conforme um tema vago.
import os
import requests
response = requests.post(
"https://jevmodel.org/v1/systemone",
headers={"Authorization": f"Bearer {os.environ['JEVMODEL_API_KEY']}"},
json={
"state": "I was charged twice. Please fix this ASAP.",
"model": "jev-latest",
"questions": {
"category": {
"type": "choice",
"instructions": "What is this ticket about?",
"criteria": {"billing": "payments", "technical": "broken product", "other": "other"},
},
},
},
timeout=15,
)
print(response.json())O contrato HTTP
Repositórios que já enviam esta requisição estão listados no diretório de projetos Jev.
Envie um único POST para https://jevmodel.org/v1/systemone. model seleciona jev-latest ou uma versão fixada. state pode ser uma string ou um valor JSON de até 8.000 caracteres após a serialização. questions é um objeto com 1 a 8 perguntas nomeadas do tipo choice, score ou noul.
- O endpoint do jevmodel.org permite 120 requisições por minuto para cada API key.
- Cada requisição bem-sucedida consome tokens de entrada. Requisições que falham no upstream são reembolsadas; adicione um cabeçalho Idempotency-Key ao tentar de novo.
- Coloque um limiar de confiança no seu código. O Jev facilita o ramo, não o torna isento de risco.
curl -X POST https://jevmodel.org/v1/systemone \
-H "Authorization: Bearer $JEVMODEL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "jev-latest",
"state": "Customer: I was charged twice and I am furious.",
"questions": {
"topic": {
"type": "choice",
"instructions": "What is the issue about?",
"criteria": { "billing": "money problems", "bug": "broken product" }
},
"urgent": {
"type": "noul",
"instructions": "Escalate to a human now?"
}
}
}'O que fazer com a resposta
Rame no código da aplicação. Se topic for billing e escalate.noul estiver acima do seu limiar, encaminhe para um humano. Se a confiança for baixa, envie o mesmo estado para um modelo maior ou um revisor. Registre entrada, saída, versão e o resultado a jusante para saber se o Jev está ajudando o fluxo de trabalho ou apenas parecendo decisivo.
FAQ
Como usar a API do Jev?
Crie uma chave no seu Dashboard do jevmodel.org, salve-a como JEVMODEL_API_KEY e faça POST de JSON para https://jevmodel.org/v1/systemone com autenticação Bearer.
Qual ID de modelo Jev devo fixar?
Use jev-1.13.0 em produção se seus limiares estiverem ajustados. jev-latest e jev-preview resolvem atualmente para a mesma versão, mas aliases podem mudar.
Posso testar o Jev antes de escrever código?
Sim. Use primeiro o Playground do jevmodel.org. Ele usa os mesmos tipos de pergunta da API, então você pode validar o formato antes de criar uma chave.
O Jev entende português?
Segundo a documentação da TypeSafe, o inglês é a principal língua de treinamento e oferece a melhor precisão; outros idiomas são processados, mas não tão bem. Teste suas cargas em português com dados reais antes de ir para produção e observe a confiança.