O que é Jev? Guia da API System One da TypeSafe
Jev é o modelo System One da TypeSafe AI. Não é um chatbot nem um gerador de código: a aplicação envia state e perguntas tipadas, e Jev devolve decisões Choice, Score ou Noul com probabilidade e confiança.
A TypeSafe anunciou Jev em acesso antecipado em 15 de setembro de 2026. Confirme acesso e preços na documentação oficial; a disponibilidade e cobrança do gateway aparecem na página de preços.
Decisões nativas do Jev: a URL não é a do chat
jev-latest usa o protocolo nativo de decisões, não um cliente de chat comum. O gateway e a API direta da TypeSafe têm URLs e chaves diferentes.
| Conexão | URL POST completa | Chave API |
|---|---|---|
| Gateway recomendado | https://api.llm-token.cn/v1/decisions |
Chave LLM API Gateway |
| Entrada compatível | https://api.llm-token.cn/v1/systemone |
Chave LLM API Gateway |
| TypeSafe direto | https://api.typesafe.ai/v1/systemone |
Chave TypeSafe |
Se a Base URL já for https://api.llm-token.cn/v1, acrescente apenas /decisions ou /systemone, não /v1/v1/decisions.
Envie model, state e questions. questions é um objeto indexado pelo ID da pergunta, com type e instructions. Os criteria de choice são um objeto de opções; os de score, um array ordenado; noul avalia a probabilidade de sim/não. Não envie messages de chat nem habilite streaming.
Requisição mínima
Defina a chave do gateway na variável de ambiente LLM_API_KEY. Este exemplo faz uma chamada real; confirme seu saldo e a cobrança antes de executar. Leia answers.is_urgent.noul e usage, não choices[0].message.content.
curl -sS -X POST https://api.llm-token.cn/v1/decisions \
-H "Authorization: Bearer $LLM_API_KEY" \
-H "Content-Type: application/json" \
-d @- <<'JSON'
{
"model": "jev-latest",
"state": "The order is due today and the payment has failed.",
"questions": {
"is_urgent": {
"type": "noul",
"instructions": "Does this require urgent attention?"
}
}
}
JSON
Se 500 / convert_request_failed contiver this channel only supports native decisions requests, verifique se o cliente ainda chama /v1/chat/completions ou /v1/messages. É uma incompatibilidade de protocolo, não falta de saldo. Recarregar ou mudar para cobrança por uso não muda o protocolo. Corrija a URL e o corpo antes de tentar novamente; não repita a requisição de chat original.
Formato e solução de problemas · Skill de integração Jev · Referência API TypeSafe
IDs e API
Os IDs são jev-latest, jev-preview e a versão fixa jev-1.13.0. Aliases podem mudar; em produção registre o campo model ou fixe uma versão. O endpoint oficial é POST https://api.typesafe.ai/v1/systemone, com state, model e questions.
Choice seleciona uma categoria, Score avalia uma escala e Noul responde a uma pergunta sim/não. Jev serve para roteamento de tickets, gates de risco, escolha de ferramentas e filtros de busca. Permissões e ação final continuam no código da aplicação.
A documentação indica contexto de 64K, cobrança de tokens de entrada e saída gratuita, mas preços e limites podem mudar. Jev não recebe imagens, áudio ou vídeo diretamente. Veja a documentação da API e os preços.
FAQ
Jev é um LLM generativo?
Não. É um nó de decisão estruturada; use um modelo generativo para escrever, traduzir ou programar.
Qual ID devo usar?
jev-latest para avaliação e jev-1.13.0 para produção reproduzível após testes de regressão.
A probabilidade garante correção?
Não. Mantenha revisão humana e meça calibração, erros e drift.
Fontes: TypeSafe models, Quick Start, Jev launch.