API de decisões

Jev API para decisões tipadas no seu código

Jev é o modelo System One da TypeSafe AI. Ele devolve Noul, Choice ou Score com probabilidades em vez de texto. Obtenha uma chave aqui e chame com um POST, sem lista de espera.

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

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

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.

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. Contas novas recebem 2 créditos, que cobrem 2 chamadas com sucesso. Não há lista de espera.

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 corpo tem a mesma forma: model, state e questions do tipo noul, choice ou score. Aqui o caminho é /api/v1/decisions, a chave vem do painel deste site e o id do modelo é jev-1.13 ou jev-latest. Os limites são mais apertados: 1 a 6 perguntas, 2 a 8 opções de Choice e 2 a 10 níveis de Score.

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.