API NIDIA · v1

Documentação

Uma única chamada HTTP para levar IA jurídica ao seu sistema. Você paga só pelo que usar.

Início rápido

Crie sua conta (ganhe R$ 2,00 para testar) e gere uma chave.
Envie uma pergunta para o endpoint de chat.
Leia o campo output da resposta.

curl https://sua-url/api/public/v1/chat \
  -H "Authorization: Bearer nidia_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "messages": [
    {
      "role": "user",
      "content": "Explique a teoria da perda de uma chance."
    }
  ]
}'

Autenticação

Envie sua chave no cabeçalho Authorization: Bearer nidia_... em todas as chamadas.

Guarde a chave no servidor. Nunca coloque no código do navegador ou do aplicativo.

Endpoint de chat

POST https://sua-url/api/public/v1/chat

Campo	Tipo	Descrição
`prompt`	string	Pergunta única. Use isto ou messages.
`messages`	array	Conversa: lista de { role, content }, até 50 itens.
`messages[].role`	"user" \| "assistant"	Quem enviou a mensagem.
`messages[].content`	string	Texto da mensagem (até 50.000 caracteres).

Conversa com histórico

A API não guarda conversas. Para perguntas de acompanhamento, envie as mensagens anteriores junto, em ordem.

curl https://sua-url/api/public/v1/chat \
  -H "Authorization: Bearer nidia_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "messages": [
    {
      "role": "user",
      "content": "Qual o prazo da apelação no CPC?"
    },
    {
      "role": "assistant",
      "content": "O prazo é de 15 dias úteis (art. 1.003, § 5º)."
    },
    {
      "role": "user",
      "content": "E se o apelante for a Fazenda Pública?"
    }
  ]
}'

Pesquisa de jurisprudência

Quando a pergunta envolve precedentes, decisões ou um número de processo, a NIDIA pesquisa automaticamente uma base de jurisprudência real e cita as decisões encontradas (tribunal, número, relator, datas e link).

Não é preciso nenhum parâmetro extra. A resposta vem pronta, sem etapas intermediárias.

curl https://sua-url/api/public/v1/chat \
  -H "Authorization: Bearer nidia_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "messages": [
    {
      "role": "user",
      "content": "Traga decisões recentes do STJ sobre dano moral por negativação indevida."
    }
  ]
}'

Resposta

{
  "model": "nidia-1",
  "output": "A teoria da perda de uma chance...",
  "usage": { "input_tokens": 120, "output_tokens": 640 },
  "cost_brl": 0.01188,
  "balance_brl": 4.98812
}

Campo	Descrição
`output`	Texto da resposta, em Markdown.
`usage`	Tokens usados na chamada, incluindo pesquisas.
`cost_brl`	Valor descontado do saldo, em reais.
`balance_brl`	Saldo restante após a chamada.

Erros

Erros retornam { "error": "mensagem" } com o código HTTP abaixo.

Código	Significado	O que fazer
`400`	Corpo inválido	Envie prompt ou messages válidos.
`401`	Chave ausente, inválida ou revogada	Confira o cabeçalho Authorization.
`402`	Saldo insuficiente	Adicione créditos no console.
`429`	Muitas requisições	Aguarde alguns segundos e tente de novo.
`502`	Falha temporária	Tente novamente; não há cobrança.

Preços

Item	Preço
Tokens de entrada	R$ 9,00 por milhão
Tokens de saída	R$ 54,00 por milhão
Crédito de boas-vindas	R$ 2,00
Recarga mensal mínima	R$ 20,00

Calculadora

Perguntas por mêsTokens de entrada (média)Tokens de saída (média)

≈ R$ 0,0513 por perguntaR$ 51,30 / mês

Perguntas com pesquisa de jurisprudência usam mais tokens de entrada.

Limites

Até 50 mensagens por chamada e 50.000 caracteres por mensagem.
A chamada é recusada quando o saldo chega a zero.
Em picos de uso, você pode receber 429; repita com uma pequena espera.