conta jevmodel.org

Entre para ganhar 100.000 tokens de entrada grátis

Cerca de 500 requisições Jev no playground ou a partir do seu código com uma API key. Os pacotes começam em $9,90 quando você precisar de mais. Sem necessidade de cartão.

Ao entrar, você concorda com os nossos termos. Usamos seu email apenas para a sua conta.
Jev Model · Referência para desenvolvedores

Documentação da API Jev

Chame a API de decisões Jev hospedada com um state e um conjunto de perguntas tipadas — receba uma escolha, um score e probabilidades sim/não nas quais seu código pode ramificar. Esta referência cobre o formato do wire, campos de resposta, cobrança, tratamento de erros e o servidor MCP remoto para agentes.

URL base https://jevmodel.org Endpoint de avaliação POST /v1/systemone · POST /mcp

Visão geral

Jev avalia um state — um ticket de suporte, um log de chat, uma chamada de ferramenta, qualquer texto ou JSON — contra um conjunto de perguntas tipadas e retorna respostas estruturadas nas quais seu código pode ramificar. Não gera texto.

Uma requisição pode fazer até 8 perguntas; elas são avaliadas juntas e compartilham o custo de entrada do state. O corpo da requisição tem o mesmo formato aceito pela API SystemOne da TypeSafe — para migrar uma integração que funciona, troque a URL base e a chave Bearer.

  • POST https://jevmodel.org/v1/systemone — o único endpoint de decisão.
  • CORS está aberto (access-control-allow-origin: *), o endpoint responde de qualquer origem. Mantenha sua chave no servidor mesmo assim.
  • O playground envia exatamente o mesmo formato de requisição pela sua sessão de navegador — o que você pré-visualiza lá é o que você envia.

Autenticação

Toda chamada de API precisa de uma chave do jevmodel.org. Crie uma em Dashboard → API keys; as chaves começam com sk- e são mostradas uma única vez na criação. Guarde-a como variável de ambiente, por exemplo JEVMODEL_API_KEY.

Cabeçalho Authorization
Authorization: Bearer $JEVMODEL_API_KEY

As chaves pertencem ao saldo de tokens da sua conta e podem ser revogadas no dashboard. Nunca exponha uma chave em código do lado do cliente nem a commite num repositório — se vazar, revogue e gere outra. O playground autentica com a sua sessão de navegador conectada e não precisa de chave.

Endpoint HTTP

Envie um corpo JSON ao endpoint de avaliação com autenticação Bearer:

Requisição HTTP
POST /v1/systemone HTTP/1.1
Host: jevmodel.org
Authorization: Bearer $JEVMODEL_API_KEY
Content-Type: application/json
Idempotency-Key: ticket-4821-run-1   # optional

Idempotency-Key é opcional (até 100 caracteres). Novas tentativas com a mesma chave reutilizam o registro de cobrança original, então uma requisição repetida não é cobrada duas vezes pela mesma entrada.

Exemplo cURL completo
curl -X POST https://jevmodel.org/v1/systemone \
  -H "Authorization: Bearer $JEVMODEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "jev-latest",
    "state": "The customer has been billed twice and wants a refund today.",
    "questions": {
      "route": {
        "type": "choice",
        "instructions": "Which queue should own this ticket?",
        "criteria": {
          "billing": "Payments, refunds, invoices",
          "technical": "Product errors and usage problems",
          "sales": "Pricing, upgrades, new business"
        }
      },
      "escalate": {
        "type": "noul",
        "instructions": "Does this need a human right now?"
      },
      "urgency": {
        "type": "score",
        "instructions": "How urgent is this for the customer?",
        "criteria": ["routine", "soon", "urgent", "critical"]
      }
    }
  }'

Corpo da requisição

Um objeto JSON com um state e um mapa de perguntas:

Corpo da requisição
{
  "model": "jev-latest",
  "state": "The customer has been billed twice and wants a refund today.",
  "questions": {
    "route": {
      "type": "choice",
      "instructions": "Which queue should own this ticket?",
      "criteria": {
        "billing": "Payments, refunds, invoices",
        "technical": "Product errors and usage problems",
        "sales": "Pricing, upgrades, new business"
      }
    },
    "escalate": {
      "type": "noul",
      "instructions": "Does this need a human right now?"
    },
    "urgency": {
      "type": "score",
      "instructions": "How urgent is this for the customer?",
      "criteria": ["routine", "soon", "urgent", "critical"]
    }
  }
}
CampoTipoNotas
modelstringOpcional; padrão jev-latest.
statestring, object ou arrayObrigatório. Forma serializada limitada a 1.000.000 caracteres.
questionsobjectMapa obrigatório de 1–8 nomes de pergunta para definições tipadas. Nomes são identificadores: letras, dígitos e _, até 64 caracteres.
assetsobjectOpcional (experimental). Até 4 imagens PNG/JPEG com um nome de referência escrito em state, instructions ou criteria. Ver Imagens e Box.

Cada pergunta precisa de type e instructions (até 1.800 caracteres) dizendo ao modelo o que decidir. criteria fornece o espaço de resposta — obrigatório para choice e score, opcional para noul.

Tipos de pergunta

Escolha a forma de resposta que sua aplicação consegue usar.

TipoCriteriaResposta
noulDescrições opcionais dos rótulos true / false.noul — a probabilidade de sim, de 0 a 1.
choiceObjeto de 2–20 chaves de opção mapeadas para descrições.A choice selecionada, um mapa probabilities e confidence.
scoreArray ordenado de 2–10 níveis.score numérico (pode ser fracionário) e confidence.
boxNão usado — apenas instructions.box com bordas normalizadas (top/bottom/left/right, 0–1) e confidence. Experimental; requer jev-preview.

Criteria serializados são limitados a 2.000 caracteres por pergunta. Falhas de validação retornam 422 antes de qualquer token ser reservado — requisições inválidas nunca são cobradas.

Imagens e Box (experimental)

O Jev 1.14 aceita imagens PNG e JPEG como entrada de decisão — compreensão de imagens, não geração. Anexe cada imagem em assets com um nome de referência e escreva essa referência em state, nas instructions de uma pergunta ou em criteria; a referência resolve para a imagem nessa posição. Pedidos com imagens ou Box exigem o modelo de pré-visualização — defina model como jev-preview.

Pedido com imagem
{
  "model": "jev-preview",
  "state": "Shipment photo attached as img-1.",
  "assets": {
    "img-1": { "type": "image", "format": "jpg", "data_base64": "/9j/4AAQSkZJRg…" }
  },
  "questions": {
    "damage_visible": {
      "type": "noul",
      "instructions": "Is there visible damage to the package in img-1?"
    },
    "damage_region": {
      "type": "box",
      "instructions": "Locate the damaged area in img-1"
    }
  }
}
  • assets mapeia uma referência para { "type": "image", "format": "png|jpg", "data_base64": "…" } — no máximo 4 imagens, ~4 MB cada após codificação.
  • Cada asset tem de ser referenciado e cada utilização é cobrada — as imagens contam para usage.input_tokens tal como o texto.
  • box aceita apenas instructions e devolve sempre uma caixa — combine-o com um noul como «X está visível» quando o alvo pode estar ausente.
  • É uma superfície experimental opt-in: o proxy aplica automaticamente o header upstream quando o pedido contém assets ou uma pergunta box. Uploads multipart não são suportados — envie base64.

Áudio e vídeo continuam sem suporte — converta-os primeiro em texto ou dados estruturados.

JSON de resposta

Uma resposta 200 é a saída do modelo em si: o modelo resolvido, uma resposta por nome de pergunta e o uso. Os valores abaixo são ilustrativos — execute a requisição para uma saída real.

Resposta 200 ilustrativa
{
  "model": "jev-latest",
  "answers": {
    "route": {
      "type": "choice",
      "choice": "billing",
      "probabilities": { "billing": 0.93, "technical": 0.05, "sales": 0.02 },
      "confidence": 0.93
    },
    "escalate": {
      "type": "noul",
      "noul": 0.12
    },
    "urgency": {
      "type": "score",
      "score": 1.4,
      "confidence": 0.88
    }
  },
  "usage": { "input_tokens": 136, "output_tokens": 18 }
}
  • answers é indexado pelos seus nomes de pergunta — você lê os campos que pediu.
  • Em choice, ramifique pelo rótulo selecionado e inspecione probabilities quando precisar da distribuição completa.
  • noul é P(sim) — seu código define o limiar de ação.
  • usage.input_tokens é o que esta chamada realmente cobrou; tokens de saída são grátis.

Cobrança

A API cobra apenas tokens de entrada — a saída é grátis. Cada chamada é cobrada pelos usage.input_tokens reais reportados pelo modelo. Com tokens grátis, uma estimativa é reservada antes e depois liquidada por esse valor. Se Jev falhar no upstream, nada é cobrado.

  • Faça login uma vez e ganhe 100.000 tokens de entrada grátis; pacotes pagos a partir de US$ 9,90 e nunca expiram.
  • Saldo insuficiente retorna 402 antes de chamar o Jev.
  • X-Tokens-Remaining em toda resposta 200 é o seu saldo após a liquidação.
  • Estime você mesmo: Σ ceil((state + question).length / 4): o state conta uma vez por pergunta.

Modelos e limites

jev-latest é o modelo padrão e o servido atualmente — o campo model é opcional. As variantes Laya mostradas no playground estão por vir e ainda não estão expostas neste endpoint.

LimiteValor
Perguntas por requisição8
Nome da perguntaIdentificador ≤ 64 caracteres
state serializado1.000.000 caracteres
instructions por pergunta1.800 caracteres
Opções de choice / níveis de score2–20 opções, 2–10 níveis
criteria serializados2.000 caracteres por pergunta
Limite de taxa120 requisições / minuto por chave
Imagens por pedido (assets)4
Formato / tamanho de imagemPNG ou JPEG em base64, ≤ ~4 MB cada
Dimensões da imagem256–1.568 px por lado

Esses números descrevem o validador da API; o modelo upstream pode ter seus próprios limites de contexto.

Erros e novas tentativas

Erros retornam um envelope JSON com um type legível por máquina e um message para humanos:

Resposta de erro
{
  "error": {
    "type": "invalid_request_error",
    "message": "At most 8 questions per request."
  }
}
StatusTipoCausaCobrado?
401authentication_errorChave ausente, inválida ou revogada.Não
402insufficient_creditsTokens de entrada estimados excedem seu saldo.Não
422invalid_request_errorCorpo falhou na validação — veja message.Não
429rate_limit_errorMais de 120 requisições neste minuto.Não
502upstream_errorJev não conseguiu completar a chamada.Não — reembolsado

Tente de novo 429 e 502 com backoff exponencial — a janela de taxa é por minuto, pausas curtas costumam bastar. Envie um Idempotency-Key ao repetir para que uma requisição repetida liquide no mesmo registro de cobrança em vez de cobrar duas vezes.

Servidor MCP para agentes

jevmodel.org também roda um servidor MCP remoto via Streamable HTTP em https://jevmodel.org/mcp. Ele expõe quatro ferramentas — jev_decide (o contrato completo state-mais-questions), jev_noul, jev_choice e jev_score — para que agentes de código como Claude Code, Cursor ou Cline chamem o Jev sem escrever HTTP.

Claude Code
claude mcp add --transport http jev https://jevmodel.org/mcp \
  --header "Authorization: Bearer $JEVMODEL_API_KEY"
  • Mesma chave Authorization: Bearer sk-… e mesmo saldo de tokens que esta API — tools/call cobra só tokens de entrada.
  • initialize, ping e tools/list são sem autenticação; só tools/call usa sua chave.
  • GET /mcp retorna um cartão JSON de descoberta para agentes e humanos.

Os comandos de instalação para Claude Code e Cursor, e a skill de agente correspondente (manual de julgamento), estão na página de ferramentas de agente.

Guia de ferramentas de agente

Do playground à API

Monte o cenário primeiro no playground — a prévia da requisição mostra o corpo JSON exato que sua aplicação deve enviar, e Copy API example dá o cURL correspondente. Quando as respostas estiverem boas, crie uma chave no dashboard e troque a sessão de navegador por autenticação Bearer.

Leitura adicional: Como usar o Jev percorre uma primeira chamada do início ao fim, e Exemplos da API Jev tem padrões de produção para cada tipo de pergunta.

API keys

Chame o Jev com sua chave.

Envie o estado e perguntas tipadas ao endpoint do Jev. Requisições bem-sucedidas consomem apenas tokens de entrada. Adicione um cabeçalho Idempotency-Key ao tentar de novo.

+ Nova chave