Biogran IA SDK LogoBIOGRAN
Documentação técnica

Como a BiogranIASDK funciona por dentro.

Um resumo técnico das decisões de arquitetura, das 3 IAs de reconhecimento facial disponíveis e de como o licenciamento funciona na prática. Para a referência completa de API, com todos os exemplos de código (C#, PHP) e detalhes de instalação, fale com o suporte para receber o manual completo.

Arquitetura: local-first, sem servidor de inferência

A BiogranIASDK é uma biblioteca nativa (BiogranIASDK.dll ou BiogranIASDK-plus.dll, também disponível para Linux) que você carrega dentro do processo da sua própria aplicação. A imagem, o template biométrico e o resultado da comparação nunca saem da máquina onde o seu software já está rodando — a única comunicação de rede acontece na ativação da licença, não durante o reconhecimento em si.

Sua aplicação
chama a API em C
BiogranIASDK.dll
processa a imagem localmente
Sem chamada de rede
nenhum dado sai da máquina

As 3 IAs de reconhecimento facial

Antes de reconhecer, o BiogranDetector — motor neural proprietário — detecta e alinha o rosto. A edição Base traz a IA BioBase; a edição Plus embute as três e cruza os resultados por validação cruzada, decidindo quais usar a cada chamada — sem trocar de biblioteca nem reinstalar nada.

BioBase512-d
Base e Plus

Reconhecimento de alta densidade vetorial — o algoritmo comprovado das duas edições.

BioBaseT2128-d
Só Plus

Otimizada para invariância a iluminação e ângulos, selecionável por chamada.

BioBaseT3192-d
Só Plus

Especializada em microexpressões e variações severas de pose.

Ativação e consumo de volume

A licença é vinculada à máquina (Machine ID), assinada digitalmente e ativada uma única vez — qualquer aplicação rodando nessa máquina depois já a encontra ativada automaticamente, sem precisar de nenhum servidor de licença no ar para validar cada chamada.

Edição Base

1 IA disponível. Cada operação — gerar template, comparar imagens ou comparar templates — consome 1 unidade do volume contratado, sempre pela mesma IA.

Edição Plus

As 3 IAs compartilham o mesmo volume — não existe saldo separado por IA. Cada IA chamada numa operação consome 1 unidade desse saldo comum; comparar a mesma face nas 3 IAs de uma vez consome 3 unidades.

Integração em minutos

API em C, com wrappers de referência prontos em C# (P/Invoke) e PHP (FFI). Exemplo real de comparação entre duas fotos:

csharp
[DllImport("BiogranIASDK.dll", CallingConvention = CallingConvention.Cdecl)]
private static extern IntPtr BiogranIA_Create();

[DllImport("BiogranIASDK.dll", CallingConvention = CallingConvention.Cdecl)]
private static extern int BiogranIA_CompareImages(
    IntPtr context,
    byte[] imageDataA, int imageSizeA,
    byte[] imageDataB, int imageSizeB,
    out BiogranIAImageComparisonResult result);

var context = BiogranIA_Create();
int status = BiogranIA_CompareImages(context, fotoA, fotoA.Length, fotoB, fotoB.Length, out var resultado);
// resultado.score: similaridade entre as duas fotos, sem nenhuma chamada de rede

Códigos de erro mais comuns

CódigoSignificado
BIOGRAN_ERROR_LICENSE_NOT_ACTIVATEDNenhuma licença foi ativada nesta máquina
BIOGRAN_ERROR_LICENSE_EXPIREDA licença expirou
BIOGRAN_ERROR_LICENSE_MACHINE_MISMATCHA licença foi emitida para outra máquina
BIOGRAN_ERROR_IMAGE_COMPARISON_LIMIT_EXCEEDEDSaldo de comparação de imagens esgotado
BIOGRAN_ERROR_TEMPLATE_GENERATION_LIMIT_EXCEEDEDSaldo de geração de template esgotado
BIOGRAN_ERROR_INVALID_IMAGEImagem corrompida ou sem rosto detectável