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-pro.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

A edição Base traz a IA BioBase. A edição Pro embute as três, decidindo qual usar a cada chamada — sem precisar trocar de biblioteca ou reinstalar nada.

BioBase512-d
Base e Pro

IA de alta precisão, o mesmo algoritmo comprovado das duas edições.

BioBaseT2128-d
Só Pro

Otimizada para mobile, com 3 variantes de qualidade selecionáveis por chamada.

  • · Melhor precisão
  • · Balanceado
  • · Mais rápido
BioBaseT3192-d
Só Pro

Modelo customizável — ponto de partida para ajustar ao seu caso de uso específico.

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 Pro

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 foto 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