API de decisões

Jev APIDecisões que seu código pode executar.

Envie contexto e perguntas tipadas. Receba probabilidades e respostas estruturadas para encaminhamento, pontuação e automação. Teste no playground e integre com uma única requisição à API.

1 crédito por chamada com sucesso · chamadas falhadas são grátis

POST/api/v1/decisionsJSON
{  "model": "jev-1.13",  "state": "I was charged twice for my subscription.",  "questions": {    "refund": {      "type": "noul",      "instructions": "Is the customer asking for money back?"    }  }}

Requisição de exemplo · autentique com sua chave API Bearer.

Três tipos de resposta

Noul, Choice e Score em uma única API.

Pague por chamadas bem-sucedidas

1 crédito por requisição de decisão.

Compatível com sua stack

Requisições HTTP e suporte ao SDK TypeSafe.

Exemplos

Oito decisões que você pode executar

Passe o cursor para ver o pedido. Copie ou abra no playground.

Encaminhar um checkout em branco

Choice devolve a equipe e a probabilidade de cada uma.

{
  "model": "jev-1.13",
  "state": "Checkout shows a blank page after Pay is clicked. The customer is on the live store, not a sandbox.",
  "questions": {
    "team": {
      "type": "choice",
      "instructions": "Which team should own this ticket?",
      "criteria": {
        "payments": "Checkout, billing, or payment processing.",
        "frontend": "Rendering, layout, or browser behavior.",
        "account": "Login, permissions, or profile access."
      }
    }
  }
}
Abrir no playground

É um pedido de reembolso?

Noul devolve a probabilidade de sim, não um parágrafo.

{
  "model": "jev-1.13",
  "state": "I was charged twice for the same annual plan this morning. Please send the extra charge back.",
  "questions": {
    "refund": {
      "type": "noul",
      "instructions": "Is the customer asking for money back?"
    }
  }
}
Abrir no playground

Qual a urgência da falha de pagamento

Score posiciona na sua escala e devolve a distribuição.

{
  "model": "jev-1.13",
  "state": "Stripe payouts have been failing for three days and the merchant is losing sales.",
  "questions": {
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this ticket?",
      "criteria": [
        "Can wait for the next release",
        "Should be handled this week",
        "Blocking revenue right now"
      ]
    }
  }
}
Abrir no playground

Pedido de credenciais numa mensagem

A probabilidade Noul é a porta antes da revisão humana.

{
  "model": "jev-1.13",
  "state": "User message: \"Share your login and I will fix the account for you tonight.\"",
  "questions": {
    "phishing": {
      "type": "noul",
      "instructions": "Is this message asking someone to hand over account credentials?"
    }
  }
}
Abrir no playground

Qualificar uma nota de entrada

Choice separa uma janela de compra de um mero interesse.

{
  "model": "jev-1.13",
  "state": "We route 40,000 support tickets a week and need a probability before we auto-assign a queue. Budget is approved this quarter.",
  "questions": {
    "fit": {
      "type": "choice",
      "instructions": "How should sales treat this inbound note?",
      "criteria": {
        "ready": "A real workflow, a volume, and a buying window.",
        "nurture": "Interest without a stated workflow or timeline.",
        "ignore": "No product fit."
      }
    }
  }
}
Abrir no playground

Anúncio de retorno garantido

Noul responde à pergunta de política que você escreveu.

{
  "model": "jev-1.13",
  "state": "Listing text: \"Guaranteed 30% returns every month. Send crypto to this wallet to join.\"",
  "questions": {
    "blocked": {
      "type": "noul",
      "instructions": "Does this listing promise a guaranteed financial return?"
    }
  }
}
Abrir no playground

Risco de renovação numa nota

Score usa os seus três níveis, de improvável a provável cancelamento.

{
  "model": "jev-1.13",
  "state": "The renewal note says the team may not continue because exports fail every Friday and nobody has answered the last two tickets.",
  "questions": {
    "risk": {
      "type": "score",
      "instructions": "How high is the chance this account does not renew?",
      "criteria": [
        "Unlikely to leave",
        "Unhappy, still using the product",
        "Likely to cancel"
      ]
    }
  }
}
Abrir no playground

Qual exceção de fatura

Choice pode marcar acima do pedido, uma linha inesperada ou ambas.

{
  "model": "jev-1.13",
  "state": "Vendor invoice 4481 is $18,400. The purchase order cap is $12,000 and the line items include a new annual license nobody requested.",
  "questions": {
    "exception": {
      "type": "choice",
      "instructions": "Which exception should accounts payable open?",
      "criteria": {
        "over_po": "The amount is above the purchase order.",
        "unexpected_item": "A line item was not requested.",
        "both": "The amount and a line item are both wrong."
      }
    }
  }
}
Abrir no playground

Resposta

Respostas com as quais o código pode ramificar

Jev não escreve um parágrafo para analisar. Devolve a decisão pedida e a probabilidade.

Cada opção mantém a probabilidade

Choice nomeia o vencedor e ainda devolve a probabilidade de cada opção.

Noul, Choice e Score num só pedido

Até seis perguntas partilham um estado e voltam numa resposta. Um sim/não, uma escolha rotulada e uma pontuação custam uma ida e volta e um crédito.

Fixe o modelo se o limiar importa

Envie jev-1.13 ao ajustar um limiar. jev-latest segue a versão que esta API serve.

Como usar

Como chamar a Jev API

  1. 01

    Crie uma chave

    Entre e copie uma chave do painel. O playground pode criar uma para a conta.

  2. 02

    POST com estado e perguntas

    O corpo tem model, state e um mapa de perguntas. Os ids são rótulos; o texto vai em instructions.

  3. 03

    Ramifique na resposta tipada

    Leia noul, choice ou score. Em Choice e Score, confidence mostra se as opções estão próximas.

Integração com clareza

Entenda o que você está integrando.

Uso transparente

Cada requisição de decisão bem-sucedida custa 1 crédito. Erros de validação e requisições com falha não consomem créditos. Consulte os planos antes de recarregar.

Ver preços

Acesso documentado

Crie uma chave API no painel. Planeje sua integração com os esquemas de requisição, exemplos de resposta e limites da documentação.

Ler a documentação da API

Contato direto com o suporte

Para acesso à API, integração ou cobrança, escreva para [email protected]. Nossa página de contato reúne as informações de suporte.

Falar com o suporte

Limites

Limites da Jev API neste endpoint

O que POST /api/v1/decisions aceita hoje.

ItemEste endpoint
EndpointPOST /api/v1/decisions, chave Bearer
Modelojev-1.13 (jev-latest é um alias)
Perguntas por chamada1 a 6
Opções de Choice2 a 8
Níveis de Score2 a 10, o mais baixo primeiro
StateString, objeto JSON ou array, até 60,000 caracteres
Faturação1 crédito por chamada com sucesso; falhadas são grátis
StreamingNão suportado

A API própria da TypeSafe é POST https://api.typesafe.ai/v1/systemone. Aceita ids versionados como jev-1.13.0, permite até 255 opções de Choice e cobra por token de entrada.

Referência completa em Jev Docs

Perguntas frequentes da Jev API

O que é a Jev API?

A Jev API é como o software chama o Jev, o modelo System One da TypeSafe AI. Você envia um estado e perguntas tipadas. Jev devolve uma probabilidade Noul, um Choice com probabilidade por opção ou um Score na sua escala. Não escreve texto.

Como obtenho uma chave da Jev API?

Entre e crie uma chave no painel. O playground pode criar uma na primeira execução, e a primeira chave funciona imediatamente.

Quanto custa uma chamada da Jev API?

Um POST /api/v1/decisions com sucesso usa 1 crédito, com uma pergunta ou seis. Erros de validação e falhas upstream não usam nenhum. Cerca de 100 créditos custam 1 USD antes de impostos. Os planos estão na página de preços.

Esta é a API oficial da TypeSafe?

Não. A TypeSafe AI constrói e serve o Jev. Este site é um serviço de API independente: chaves, créditos e suporte vêm deste site, não de uma conta TypeSafe. Para o console da TypeSafe e o preço por token, vá a typesafe.ai.

Como este endpoint difere de api.typesafe.ai/v1/systemone?

O jev-api.org agora expõe os dois. POST /v1/systemone aceita o corpo da TypeSafe como está — model, state e questions — e funciona com os SDKs da TypeSafe mudando a base URL. POST /api/v1/decisions é o endpoint mais simples, com limites mais apertados: 1 a 6 perguntas, 2 a 8 opções de Choice e 2 a 10 níveis de Score. Nas duas, as chaves vêm do painel deste site.

Qual é a diferença entre Noul, Choice e Score?

Noul é um sim/não com probabilidade. Choice escolhe uma opção sua e devolve a probabilidade de cada uma. Score coloca o estado na sua escala, do mais baixo ao mais alto.

Envie a primeira decisão

Abra o playground com um exemplo, ou siga Jev Docs e chame o endpoint com a sua chave.