AI AestheticOS Developers

Análise estética como infraestrutura. ACESSO ANTECIPADO

A API do AI AestheticOS transforma uma foto em uma análise estética estruturada — pele em 8 dimensões, proporções faciais e idade estimada da pele — pronta para entrar no seu app, clínica, e-commerce ou pesquisa. Informativa e não diagnóstica, por design.

Acesso antecipado. A especificação v1 abaixo está em validação com os parceiros do piloto e pode receber ajustes até a disponibilidade geral. Para obter chaves de API, escreva para dev@nutoken.com.br.

Por que esta API é diferente

Capacidade	Como fazemos	Prática comum no mercado
Uma chamada	`POST /v1/analyses` com a imagem direto no corpo — pronto	3 chamadas + upload pré-assinado para qualquer análise
Webhook-first	Evento assinado `analysis.completed`; polling é o fallback	Polling obrigatório
Sandbox real	Chaves `sk_test_` com respostas determinísticas e gratuitas	Testa-se gastando créditos de produção
Idempotência	Header `Idempotency-Key` em toda criação	Retry duplica cobrança
Scores transparentes	`score` + `confidence` + regiões; calibração documentada	Score "ajustado psicologicamente" sem documentação
Consentimento nativo	Objeto `consent` obrigatório, auditável (LGPD)	Responsabilidade empurrada para o integrador

Comece em 60 segundos

Com uma chave de teste, uma única chamada devolve o analysis_id; o resultado chega por webhook (ou GET):

curl

curl -X POST https://api.nutoken.com.br/v1/analyses \
  -H "Authorization: Bearer sk_test_sua_chave" \
  -H "Idempotency-Key: pedido-123" \
  -F "image=@selfie.jpg" \
  -F 'dimensions=["wrinkle","pore","texture","acne","oiliness","moisture","redness","age_spot"]' \
  -F 'consent={"obtained":true,"policy_version":"2026-10","subject_ref":"u_84f2"}'

resposta · 202

{
  "analysis_id": "ana_7Kp2mQ",
  "status": "processing",
  "estimated_seconds": 8,
  "links": { "self": "/v1/analyses/ana_7Kp2mQ" }
}

Explore a documentação

Guia de integração

Do upload ao resultado em 3 passos, com curl, JavaScript e Python.

Entradas & saídas

Dimensões disponíveis, esquema dos scores, máscaras e idade da pele.

Arquivos & erros

Especificações de imagem e o catálogo completo de erros com solução.

Capture Kit (JS)

Captura guiada no navegador com gate de qualidade e consentimento embutido.

Webhooks

Eventos assinados com HMAC, retries e verificação em 5 linhas.

Referência da API v1

Todos os endpoints, parâmetros, códigos de status e política de versões.

Princípios que valem para toda a plataforma

Não diagnóstica. A API descreve condições estéticas; nunca nomeia doenças nem prescreve. Saídas com flag de segurança recomendam avaliação profissional.
Privacidade por padrão. Imagens são apagadas após o processamento (retenção configurável pelo controlador); todo acesso é auditado.
Todos os fototipos. Os modelos são avaliados nos fototipos I–VI; métricas de equidade fazem parte dos nossos critérios de release.