API

Chame julgamentos do seu programa com uma chave de API. O cadastro inclui $$5.00 de crédito. Igual ao jev-1.13.0: apenas tokens de entrada, $$0.042 por milhão, saída grátis.

Emita uma chave na sua página de conta. O texto puro é mostrado uma vez; o servidor guarda apenas seu sha256.

Obter uma chave na sua conta

Autenticação

Toda requisição /v1/* exige uma chave Bearer. Apenas chaves — cookies de sessão não são aceitos, mantendo o login web e as chamadas cobradas separados.

Authorization: Bearer jev_...

Endpoints

`POST /v1/judge`	Execute um julgamento. Cobrado pelos tokens de entrada desta chamada, e somente após o sucesso. Falhas na origem não são cobradas.
`GET /v1/me`	Usuário atual, saldo e gasto total.
`GET /v1/usage`	Saldo, gasto total e lançamentos recentes.

Corpo da requisição (/v1/judge)

`state`	O texto a julgar, 8–4000 caracteres.
`questions`	Até 6 perguntas; as chaves devem ser identificadores que começam com minúscula.

Tipos de pergunta

`noul`	Relevância, retorna um decimal de 0 a 1.
`confidence`	Confiança, retorna um decimal de 0 a 1.
`choice`	Escolha uma opção e retorne a string escolhida. Envie um array options ou um objeto criteria; as options são reunidas em criteria antes do modelo.

Resposta

Saldo após esta chamada.

{
  "id": "k3f9a1c2b4d5",
  "model": "clavue-jev",
  "answers": {
    "relevance":  { "noul": 0.92 },
    "confidence": { "noul": 0.78 },
    "severity":   { "choice": "medium" }
  },
  "credit": { "cents": 500, "usd": "5.00", "microUsd": 5000000, "inputTokensLeft": 119047619 }
}

O objeto credit

{
  "cents": 500,
  "usd": "5.00",
  "microUsd": 5000000,
  "inputTokensLeft": 119047619
}

`cents`	Saldo restante arredondado ao centavo. usd e microUsd são exatos.
`usd`	String USD. Valores pequenos mantêm dígitos em microdólares.
`microUsd`	Microdólares restantes. 1 USD = 1.000.000.
`inputTokensLeft`	Tokens de entrada que este saldo ainda cobre a $0.042 por milhão.

Erros

Status	error
`401`	`unauthorized / invalid_api_key`	Chave de API ausente ou inválida.
`400`	`invalid_request`	state muito curto, ou sem perguntas.
`429`	`quota_exceeded`	Saldo insuficiente; inclui retry-after.
`502`	`upstream_unavailable`	O backend de julgamento está fora do ar. Sem cobrança.

Exemplo

curl https://api.jevcode.ai/v1/judge \
  -H "Authorization: Bearer jev_..." \
  -H "Content-Type: application/json" \
  -d '{
    "state": "The build failed on the second job, then passed after a retry.",
    "questions": {
      "relevance":   { "type": "noul",       "instructions": "Is this about CI?" },
      "confidence":  { "type": "confidence", "instructions": "How sure are you?" },
      "severity":    { "type": "choice",     "instructions": "Pick one.",
                       "options": ["low", "medium", "high"] }
    }
  }'

Testar uma na página de teste Preços

Continue neste site

Teste, documentação, casos e preços se ligam entre si. A próxima página está neste site.

API

Autenticação

Endpoints

Corpo da requisição (/v1/judge)

Tipos de pergunta

Resposta

O objeto credit

Erros

Exemplo

Continue neste site

Usar o clavue-jev

Documentação

Casos

Mais neste site