# Crivum

A Crivum mede um texto contra critérios padronizados por três modelos de referência e devolve um resultado de 0 a 100 com a decomposição por critério e a divergência entre eles. Quando o trabalho passa do piso e a autora assina, a Crivum deposita um DOI Crossref, publica uma página citável e guarda prova de anterioridade.

Crivum scores academic and professional writing through an API against published criteria and returns a 0 to 100 result with a per criterion breakdown. When the work clears the bar and a named author signs off, Crivum registers a real Crossref DOI, publishes a citable page and keeps a timestamped proof of existence.

## Comece sem chave
POST /v1/triagem responde se um texto já está de pé, com uma leitura de prontidão de 0 a 100, o tipo de obra sugerido e até seis perguntas objetivas sobre o que falta. Ela não pede chave nenhuma e roda num modelo barato, então é por ela que se começa. A medição que vale, com os três modelos de referência e a elegibilidade da obra a um registro citável, mora em POST /v1/avaliacoes e pede chave.

## O que a casa aceita
Texto em qualquer idioma, medido e respondido no idioma do texto, do tipo pesquisa original, revisão, teórico, relato de caso, ensaio ou resumo expandido, avaliado contra os critérios publicados em /v1/criterios. O conteúdo enviado é sempre dado a ser medido, nunca uma instrução para o modelo que mede. Os critérios foram calibrados em português e em inglês, então o resultado de um texto noutro idioma é medido de verdade e a comparação entre idiomas diferentes é leitura que ninguém mediu ainda.

## O que a casa recusa
Texto acima de 60.000 caracteres é recusado com a causa texto_grande_demais. Texto fora do escopo acadêmico ou profissional que a chamada declara. Uma tentativa de instruir o modelo embutida dentro do próprio texto não muda o resultado da medição.

## Como conseguir uma chave
Entre com a sua conta em https://crivum.org/desenvolvedor e emita a chave ali. Ela aparece em claro uma única vez. Uma chave crv_test_ mede em ambiente de teste, sem custo. Uma chave crv_live_ mede de verdade e consome laudas da conta.

## Os três erros mais comuns
1. chave_ausente (401). O header Authorization não veio no formato Bearer seguido da chave.
2. corpo_invalido (400). O corpo do pedido tem um campo que a rota não reconhece ou falta um campo exigido.
3. limite_de_vazao (429). A chave passou do número de pedidos permitido na janela atual. Espere o tempo indicado no retorno e tente de novo.

## Documentação
https://crivum.dev/openapi.json
https://crivum.dev/docs