Verifica se a API esta operacional e quais modelos de ML estao carregados. Use este endpoint para confirmar que o servico esta pronto antes de enviar requisicoes de verificacao.
| Campo | Tipo | Descricao |
|---|---|---|
| status | string | "ok" quando saudavel, "degraded" quando modelos nao carregados |
| models_loaded | int[] | Lista de IDs dos modelos carregados (ex: [60, 62, 64]) |
Clique em Verificar para checar o status da API.
Envie 3 fotos de referencia de um animal conhecido e 1 foto de prova para verificar se pertencem ao mesmo individuo. O sistema utiliza um ensemble de 3 modelos siameses com perda triplet para comparar embeddings do focinho bovino -- a "digital" unica de cada animal.
Todos os criterios devem ser atendidos para decision.verdict retornar MATCH:
| Metrica | Limiar | Descricao |
|---|---|---|
| Similaridade Cosseno | >= 0.60 | Similaridade probe vs template de referencia |
| Distancia Euclidiana | <= 0.85 | Distancia no espaco de embeddings |
| Similaridade Mutua | >= 0.55 | Consistencia entre as 3 referencias |
| Verificacao de Dominio | deve passar | Fotos devem ser focinhos validos |
O campo decision consolida o veredicto, score e confianca. O campo summary detalha os criterios. O campo details contem dados tecnicos por modelo:
| Campo | Descricao |
|---|---|
decision.verdict | MATCH, NO_MATCH ou INVALID_INPUT |
decision.score | Similaridade cosseno do ensemble (metrica principal) |
decision.confidence | Score de confianca derivado da distancia euclidiana |
decision.confidence_label | NOT_THE_ANIMAL, FAIR, GOOD ou EXCELLENT |
decision.explanation | Explicacao em texto do resultado |
summary.criteria[] | Lista com cada metrica, valor observado, limiar e se passou |
details.models[] | Detalhes por modelo individual (debug) |
details.ensemble | Resumo do ensemble com metricas agregadas |
details.reference_mutual_similarity | Similaridade mutua entre as referencias |
| Label | Faixa | Significado |
|---|---|---|
| NOT_THE_ANIMAL | 0.00 | Animal diferente ou fora do dominio |
| FAIR | 0.65 - 0.75 | Possivel correspondencia, revisao recomendada |
| GOOD | 0.75 - 0.85 | Alta probabilidade de correspondencia |
| EXCELLENT | >= 0.85 | Correspondencia quase certa |
Todas as requisicoes exigem header X-API-Key. Limite: 30 req / 60s por IP.
| Codigo | Descricao |
|---|---|
| 401 | API Key invalida ou ausente |
| 422 | Payload invalido (menos de 3 referencias, tamanho excedido) |
| 429 | Limite de requisicoes excedido (Retry-After header) |
| 500 | Erro interno de processamento |
| 503 | Modelos nao carregados |
A MUU Agrotech e uma empresa brasileira de inovacao tecnologica que desenvolveu a MUU Biometria, um sistema de rastreabilidade por biometria facial bovina. A tecnologia utiliza o focinho do animal como identificador unico -- uma verdadeira "digital" do gado.
Ao contrario dos brincos e chips tradicionais, a identidade biometrica acompanha o animal por toda a vida. O sistema emite um passaporte animal digital que permite rastrear o individuo desde o nascimento ate o abate.
Acompanhe cada animal da fazenda ao frigorifico com identidade verificada e inalteravel.
Impeca a substituicao de animais em transacoes comerciais.
Verifique a identidade na recepcao, embarque e desembarque.
Utilize a identidade biometrica como garantia em credito rural.
Variante do endpoint /predict que aceita arquivos JPEG ou PNG via multipart/form-data em vez de strings base64. Ideal para integracoes que enviam imagens diretamente do disco ou camera sem conversao para base64.
| Campo | Tipo | Descricao |
|---|---|---|
| reference_photo_1 | file | Primeira foto de referencia (JPEG ou PNG) |
| reference_photo_2 | file | Segunda foto de referencia (JPEG ou PNG) |
| reference_photo_3 | file | Terceira foto de referencia (JPEG ou PNG) |
| probe_photo | file | Foto de prova para verificar identidade (JPEG ou PNG) |
Identica ao POST /predict: mesmos criterios de decisao, niveis de confianca e verificacao de dominio.
Header X-API-Key obrigatorio (quando configurado). Limite: 30 req / 60s por IP.
| Codigo | Descricao |
|---|---|
| 401 | API Key invalida ou ausente |
| 422 | Arquivo invalido (formato, tamanho, ausente) |
| 429 | Limite de requisicoes excedido |
| 500 | Erro interno de processamento |
| 503 | Modelos nao carregados |
Verifica se uma unica imagem e um focinho bovino valido. Analisa propriedades do embedding (norma, variancia, consistencia entre modelos) para detectar imagens fora do dominio.
| Metrica | Limiar | Descricao |
|---|---|---|
| Variancia do Embedding | >= 0.0050 | Embeddings sem informacao tem variancia proxima de zero |
| Consistencia entre Modelos | <= 0.20 | Similaridade par-a-par entre modelos nao deve exceder; valores altos indicam colapso |
| Campo | Descricao |
|---|---|
decision.verdict | VALID_MUZZLE ou INVALID_INPUT |
decision.explanation | Explicacao em texto do resultado |
embedding_variance | Variancia dos valores do embedding |
cross_model_consistency | Similaridade cosseno media par-a-par entre modelos individuais |
summary.criteria[] | Detalhamento dos criterios avaliados |
Header X-API-Key obrigatorio (quando configurado). Limite: 30 req / 60s por IP.
| Codigo | Descricao |
|---|---|
| 401 | API Key invalida ou ausente |
| 422 | Payload invalido (imagem ausente ou excedendo tamanho) |
| 429 | Limite de requisicoes excedido |
| 500 | Erro interno de processamento |
| 503 | Modelos nao carregados |
Variante do endpoint /domain-check que aceita um arquivo JPEG ou PNG via multipart/form-data em vez de string base64. Ideal para integracoes que enviam imagens diretamente do disco ou camera.
Identica ao POST /domain-check: mesmos criterios de validacao e formato de resposta.
Header X-API-Key obrigatorio (quando configurado). Limite: 30 req / 60s por IP.