Como usar o Jev: acesso antecipado e primeiros passos

O Jev está em acesso antecipado, e o caminho até a primeira chamada tem etapas que a documentação oficial espalha por páginas diferentes. Esta página organiza o percurso completo em português: entrar na fila, receber acesso, entender o console, fazer a primeira chamada e saber o que pagar por isso.

O que é o acesso antecipado

O Jev abriu em 15 de setembro de 2026 em early access. Na prática, isso significa três coisas. Primeiro, o acesso passa por uma lista de espera em typesafe.ai — a TypeSafe libera a entrada em lotes. Segundo, a API e o produto podem mudar rápido durante essa fase; o changelog merece acompanhamento. Terceiro, quem entra cedo influencia o roteiro: o anúncio oficial pede que os desenvolvedores relatem quais decisões querem automatizar, onde o Jev funciona e onde ele falha.

Para um time brasileiro, o acesso antecipado é também um filtro de leitura: quase todo conteúdo público sobre o Jev vem de quem testa em inglês. As nossas páginas de teste em português e o playground cobrem esse ângulo.

O console e o playground oficial

Aprovado na lista, você chega ao console em console.typesafe.ai. Dois cantos importam no primeiro dia:

• O playground do console (console.typesafe.ai/playground): cole qualquer texto como state, monte perguntas dos três tipos e veja as respostas com probabilidades na hora. É o jeito mais rápido de calibrar a intuição sobre Choice, Score e Noul antes de escrever código.
• As chaves de API (console.typesafe.ai/settings/keys): onde a chave é criada. Ela autentica as chamadas no cabeçalho Authorization: Bearer. Trate-a como qualquer segredo de produção: variável de ambiente ou cofre, nunca no código.

O nosso playground usa a mesma API por trás de uma interface em português, com latência medida no servidor — serve como referência do que a resposta real parece.

O formato da chamada

Toda requisição é um POST para https://api.typesafe.ai/v1/systemone com três campos no corpo:

{
  "state": "Olá, tentei conectar minha conta por 3 dias e continua falhando. Estou perdendo vendas. Podem ajudar com urgência?",
  "model": "jev-latest",
  "questions": {
    "urgente": {
      "type": "noul",
      "instructions": "A mensagem transmite urgência?"
    }
  }
}

A resposta vem com uma entrada em answers para cada pergunta, sob o mesmo identificador que você escolheu, mais o consumo em usage:

{
  "model": "jev-latest",
  "answers": {
    "urgente": { "type": "noul", "noul": 0.99 }
  },
  "usage": { "input_tokens": 312, "output_tokens": 48 }
}

O modelo jev-latest é o apontado pela documentação como o carro-chefe. Os três tipos de pergunta — Choice, Score e Noul — podem ser misturados na mesma chamada e são avaliados em paralelo; a página de primitivas detalha cada um. Os códigos de erro seguem o padrão HTTP: 401 para chave inválida, 422 para corpo malformado, 429 e 529 indicam limite e sobrecarga, com recomendação de retentativa com espera exponencial.

SDKs e bibliotecas

A TypeSafe mantém SDKs oficiais de Python e JavaScript/TypeScript, que dão tipos para perguntas e respostas e retentativas automáticas com política padrão. Em Python, o pacote é typesafe-sdk (pip ou uv):

from typesafe_sdk import Noul, TypeSafeClient

with TypeSafeClient() as client:  # lê TYPESAFE_API_KEY do ambiente
    response = client.system_one(
        state="Minha integração de pagamento falha há 3 dias.",
        questions={"urgente": Noul(instructions="A mensagem transmite urgência?")},
    )
    print(response.answers["urgente"].noul)

Há ainda um repositório público com um adaptador para usar LLMs no mesmo formato da API (typesafe-ai/system-one-adapter-python, no GitHub) — útil para comparar um LLM com o Jev sob o mesmo contrato. E, para quem usa agente de código, a TypeSafe publica uma skill oficial que ensina o formato aos agentes. Em qualquer outra linguagem, o HTTP direto resolve: o corpo é JSON puro.

O modelo de preços em duas linhas

Entrada a US$ 0,042 por milhão de tokens; saída gratuita. Não há cobrança por pergunta avulsa — perguntas extras custam apenas os tokens que adicionam ao corpo da requisição, e a orientação oficial é mandar todas as perguntas de uma vez, porque quase não muda o tempo de resposta. A página Jev: preço e custo traz a calculadora em reais para o seu volume.

Depois da primeira chamada

Com a primeira resposta tipada na mão, o próximo degrau é projetar perguntas boas: uma pergunta por julgamento, critérios que separam bem as opções, e combinações de notas com pesos no seu código. As primitivas e o pilar O que é Jev cobrem o resto do caminho — e as páginas de Python e JavaScript deste guia entram no ar na sequência, com exemplos completos em português.