​
O que são Notas?

As Notas são transcrições estruturadas de consultas veterinárias. Você envia um arquivo de áudio via API e recebe de volta texto organizado em seções úteis como anamnese, diagnóstico e tratamento.

​
Fluxo de Processamento

1

Upload do áudio

Envie seu arquivo de áudio via POST para /v1/notes
2

Processamento

Nossa IA processa e transcreve o áudio (1-5 minutos)
3

Estruturação

O texto é automaticamente organizado em seções médicas
4

Disponibilização

Os dados ficam disponíveis via GET /v1/notes/{id}

​
Estados de Processamento

Uma nota pode ter os seguintes status:

pending

Aguardando processamentoÁudio foi recebido e está na fila

processing

Em processamentoIA está transcrevendo o áudio

completed

ConcluídoTranscrição finalizada e seções disponíveis

failed

FalhouErro no processamento (verifique qualidade do áudio)

​
Estrutura de uma Nota

​
Dados Básicos

{
  "id": "6a4fe1de-52c4-4b2b-a30f-4b3fa9d7d8b3",
  "name": "Rex",
  "gender": "male",
  "external_id": "CLIENTE_123",
  "transcription_status": "completed",
  "created_at": "2024-02-14T18:25:43Z"
}
CampoTipoDescrição
idUUIDIdentificador único da nota
nameStringNome do paciente
genderStringSexo: male, female, unidentified
external_idStringID do seu sistema (opcional)
transcription_statusStringStatus atual do processamento

​
Seções Estruturadas

Quando processada, a nota é dividida automaticamente em seções: 
{
  "note_sections": [
    {
      "id": "9b7d8b6a-12e3-45fa-9c1c-7e12f5c4a1b2",
      "title": "Anamnese",
      "label": "anamnesis",
      "content": "Paciente apresenta histórico de...",
      "order": "1"
    },
    {
      "title": "Diagnóstico", 
      "label": "diagnosis",
      "content": "Após exame físico, diagnosticado...",
      "order": "2"
    }
  ]
}

​
Seções Padrão

Anamnese

Histórico do paciente
  • Sintomas relatados pelo tutor
  • Histórico médico anterior
  • Observações de comportamento

Exame Físico

Avaliação física
  • Peso, temperatura, sinais vitais
  • Observações do exame clínico
  • Alterações encontradas

Diagnóstico

Conclusões médicas
  • Diagnóstico principal
  • Diagnósticos diferenciais
  • Suspeitas clínicas

Tratamento

Plano terapêutico
  • Medicações prescritas
  • Dosagens e frequência
  • Instruções para o tutor

​
Metadados Personalizados

Você pode incluir informações adicionais ao criar uma nota: 
{
  "metadata": [
    {"key": "procedimento", "value": "vacina"},
    {"key": "peso", "value": "12.5kg"},
    {"key": "idade", "value": "3 anos"},
    {"key": "veterinario", "value": "Dr. Silva"}
  ]
}
Casos de uso para metadados:
  • Identificação do veterinário
  • Tipo de procedimento
  • Informações do paciente
  • Referências do seu sistema

​
Requisitos de Áudio

​
Formato Recomendado

Para melhores resultados, use WAV, 16kHz, mono, 16-bit
Especificações ideais:
  • Formato: WAV ou FLAC
  • Taxa de amostragem: 16.000 Hz
  • Canais: Mono (1 canal)
  • Bit depth: 16-bit

​
Formatos Aceitos

FormatoSuporteQualidade
WAV✅ IdealExcelente
FLAC✅ BomBoa
MP3⚠️ AceitoRegular
M4A⚠️ AceitoRegular

​
Dicas para Melhor Qualidade

🔇 Ambiente Silencioso

Minimize ruído de fundo durante a gravação

🎤 Distância Adequada

Mantenha 30-50cm de distância do microfone

🗣️ Fala Clara

Evite falar muito rápido ou com volume muito baixo

⏱️ Duração

Entre 1 minuto e 1 hora de duração

​
Limitações

Limitações importantes:
  • Tamanho máximo: 100MB por arquivo
  • Duração máxima: 60 minutos
  • Idioma: Português brasileiro (primário)
  • Qualidade: Áudio com muito ruído pode falhar

​
Monitoramento via Webhook

Ao invés de fazer polling, configure webhooks para receber notificações: 
{
  "event": "note.completed",
  "data": {
    "note_id": "6a4fe1de-52c4-4b2b-a30f-4b3fa9d7d8b3",
    "status": "completed"
  }
}
Veja mais em Conceitos de Webhooks.
Próximo passo: Experimente criar sua primeira nota seguindo o Guia de Início Rápido.