Conceitos
Unidades & cobrança
Um modelo simples o suficiente para caber em uma frase: 1 análise bem-sucedida = 1 unidade, independentemente de quantas dimensões você pedir.
Quando unidades são consumidas
- Apenas em sucesso. Análise com status
failed— por qualquer motivo, inclusive falha interna nossa — não consome nada. - Erros de validação não consomem. Foto escura, rosto pequeno, consent ausente:
422grátis. - Retries idempotentes não consomem de novo. Mesma
Idempotency-Key= mesma análise = uma unidade só. - Sandbox é grátis. Chaves
sk_test_nunca tocam o saldo.
Tabela de consumo
| Operação | Unidades | Observação |
|---|---|---|
| Análise de pele (até 8 dimensões) | 1 | Pedir 2 ou 8 dimensões custa o mesmo — peça o que precisar |
| Alta fidelidade (entrada ≥ 1080 px) | 1 | Sem sobrepreço por resolução |
| Dimensões estendidas (quando disponíveis) | +0,5 | Por análise que as inclua, não por dimensão |
| Reemissão de máscaras expiradas (> 72 h) | 0,1 | Via POST /v1/analyses/{id}/masks |
| Webhooks, polling, consulta de saldo | 0 | Nunca cobramos por você perguntar |
Expiração e ordem de débito
Unidades têm validade de 12 meses. O débito prioriza automaticamente as que expiram primeiro (e, em empate, as adquiridas há mais tempo) — você nunca perde unidade nova tendo unidade velha no saldo.
Acompanhe o saldo sem esforço
Toda resposta de análise bem-sucedida já traz o saldo — sem chamada extra:
json
"units": { "consumed": 1, "remaining": 499 }Além disso:
- Header
X-AOS-Units-Remainingem todas as respostas autenticadas GET /v1/units— saldo, lotes e datas de expiração- Webhook
units.lowquando o saldo cruza o limiar que você definir no painel (padrão: 10%)
Sem surpresa de fim de mês: com
units.low + débito só-em-sucesso + sandbox grátis, o seu custo é função direta do seu volume de análises reais — e de nada mais.Preços
Os pacotes de unidades do programa de acesso antecipado são definidos no onboarding de parceiros (volume, mercado e caso de uso variam muito entre clínicas, apps e pesquisa). Fale com dev@nutoken.com.br.