Jev API

Jev avalia texto ou JSON com base em um conjunto de perguntas e retorna uma resposta estruturada para cada pergunta. As perguntas em uma solicitação compartilham o mesmo state.

Campo de Run	Valor
`provider`	`typesafe`
`endpoint`	`/v1/systemone`

Envie estes campos com input para criar um Run. Use Inspect para consultar o esquema de entrada atual e o preço. Consulte a visão geral da API para saber mais sobre autenticação e gerenciamento de Run.

Entrada

Campo	Descrição
`state`	O conteúdo a ser avaliado: texto, um objeto JSON ou uma matriz JSON.
`questions`	Um objeto que contém uma ou mais perguntas, cada uma com um ID não vazio.
`model`	Nome opcional do modelo. O padrão é `jev-latest`; use `jev-1.13.0` para selecionar essa versão.

Cada pergunta tem um type, instructions que descrevem o que deve ser avaliado e criteria quando necessário:

Tipo	Finalidade	`criteria`
`choice`	Selecionar uma opção	Um objeto com 2–255 opções
`score`	Atribuir uma pontuação	Uma matriz ordenada com 2–10 níveis
`noul`	Avaliar uma afirmação de sim/não	Opcional

As respostas são retornadas em output.answers, indexadas pelos IDs das perguntas. Consulte a referência da API TypeSafe para ver os formatos de perguntas e respostas.

Exemplo

Esta solicitação avalia duas afirmações sobre o mesmo tíquete de suporte:

{
  "provider": "typesafe",
  "endpoint": "/v1/systemone",
  "input": {
    "model": "jev-1.13.0",
    "state": "The customer was charged twice and asks for a refund.",
    "questions": {
      "duplicate_charge": {
        "type": "noul",
        "instructions": "The customer was charged twice."
      },
      "refund": {
        "type": "noul",
        "instructions": "The customer asks for a refund."
      }
    }
  }
}

Limites de tokens

O tamanho do lote depende do conteúdo em state e das perguntas. Jev 1.13 verifica ambos os limites:

Conteúdo	Limite
`state` + todas as perguntas	64 mil tokens
`state` + a pergunta mais longa	32 mil tokens

O conteúdo da pergunta inclui instructions e criteria. A contagem de tokens difere da contagem de caracteres. Consulte os limites de modelos da TypeSafe para conhecer outras versões de modelos e os limites de taxa atuais.

Erros do provedor de dados

Leia o status HTTP de Jev em provider_response.http_status e o corpo do erro em provider_response.error. Uma rejeição por limite de tokens tem status HTTP 400 e este corpo:

{"detail":{"error_type":"max_tokens_exceeded"}}

O erro não identifica qual limite foi excedido. Encurte state ou a pergunta mais longa para atender ao limite de 32 mil; encurte ou divida as perguntas para atender ao limite total de 64 mil. Use um novo Idempotency-Key para a solicitação revisada. Jev retorna 429 para limites de taxa e 529 para sobrecarga temporária. Aguarde antes de criar um novo Run. Consulte Como lidar com a resposta de Run para ver os campos de status e as novas tentativas.

Preços

Jev cobra pelos tokens de entrada; os tokens de saída são gratuitos. Cada lote inclui e cobra state novamente. Rejeições por limite de tokens sem uso de tokens não têm cobrança. Consulte o Endpoint para ver o preço atual da Glasser. O campo charge_usd do Run contém a cobrança real.

Primeiros passos

Endpoints

Run

Saldo

Fontes de dados

Solutions

Entrada

Exemplo

Limites de tokens

Erros do provedor de dados

Preços

​Entrada

​Exemplo

​Limites de tokens

​Erros do provedor de dados

​Preços

Entrada

Exemplo

Limites de tokens

Erros do provedor de dados

Preços