API v1

Reconhecimento de placas,
em uma chamada.

Envie uma imagem. Receba a placa normalizada, a confiança e a latência. Sem SDK, sem webhook, sem fila — apenas HTTP.

Quickstart

Passo 1

Crie sua conta

Criar conta grátis. Para chamadas em produção, você precisa de uma assinatura ou pacote pré-pago.

Passo 2

Gere uma API key

No Dashboard, clique em Nova chave. A chave começa com lp_live_ e é mostrada uma única vez — guarde com cuidado.

Passo 3

Faça sua primeira request

Envie uma imagem JPEG, PNG, WEBP ou HEIC. A resposta é JSON.

terminal

curl -X POST https://leituradeplaca.com.br/api/v1/read-plate \
  -H "X-API-Key: lp_live_..." \
  -H "Content-Type: image/jpeg" \
  --data-binary "@carro.jpg"

Teste agora

Cole sua API key, arraste uma foto e veja a resposta real do servidor.

try-it.sh

X-API-Key

Imagem do veículo

Clique ou arraste uma foto

JPEG, PNG, WEBP ou HEIC, até 8 MB

Resposta

Aguardando requisição…

Referência

POST/api/v1/read-plate

Envia uma imagem para reconhecimento. Aceita três formatos de body — escolha o mais conveniente.

Autenticação

Toda requisição precisa de uma API key em um destes headers:

X-API-Key: lp_live_...
# ou
Authorization: Bearer lp_live_...

Formatos de imagem

Raw binary — recomendado

O body é o conteúdo do arquivo. Content-Type indica o tipo.

curl -X POST https://leituradeplaca.com.br/api/v1/read-plate \
  -H "X-API-Key: lp_live_..." \
  -H "Content-Type: image/jpeg" \
  --data-binary "@carro.jpg"

Multipart form-data

Útil para uploads vindos direto de um formulário HTML.

curl -X POST https://leituradeplaca.com.br/api/v1/read-plate \
  -H "X-API-Key: lp_live_..." \
  -F "image=@carro.jpg"

JSON com base64

Para integrações onde só JSON é viável (ex: low-code).

curl -X POST https://leituradeplaca.com.br/api/v1/read-plate \
  -H "X-API-Key: lp_live_..." \
  -H "Content-Type: application/json" \
  -d '{"image_base64":"<base64 da imagem>","mime_type":"image/jpeg"}'

Resposta de sucesso

200 OK com application/json:

response.json

{
  "plate": "BRA2E19",
  "confidence": 0.94,
  "error": null,
  "latency_ms": 2410
}

plate: string | null — placa normalizada (A-Z e 0-9). null se ilegível.
confidence: number — confiança subjetiva entre 0 e 1.
error: string | null — descrição quando plate é null.
latency_ms: number — tempo total de processamento.

Exemplos por linguagem

Cole, troque sua chave e está rodando.

curl -X POST https://leituradeplaca.com.br/api/v1/read-plate \
  -H "X-API-Key: lp_live_..." \
  -H "Content-Type: image/jpeg" \
  --data-binary "@carro.jpg"

Erros

Código	Nome	Quando acontece
401	Unauthorized	API key ausente ou revogada.
402	Payment Required	Sem assinatura ativa.
400	Bad Request	Imagem ausente ou body inválido.
413	Payload Too Large	Imagem maior que 8 MB.
415	Unsupported Media Type	Mime type fora de jpeg/png/webp/heic.
502	Bad Gateway	Falha do backend de OCR.

Formato de erro

error.json

{
  "statusCode": 401,
  "statusMessage": "Invalid or revoked API key"
}

Limites

Tamanho máximo: 8 MB
Mime types: image/jpeg, image/png, image/webp, image/heic
Resolução: a placa deve ocupar pelo menos 100×30 px no quadro

Reconhecimento de placas,em uma chamada.