API Voice-Processor

#Autenticação

A plataforma LeoRad utiliza dois tipos de tokens para diferentes cenários de integração. Entender a distinção entre eles é essencial para utilizar a API corretamente.

#Token de Login

O Token de Login é exclusivo para cada usuário da plataforma LeoRad. Ele é utilizado para autenticar o acesso à aplicação web e para obter o Token de API nas integrações REST.

Como obter seu Token de Login

1. 1
   Crie sua conta: Acesse app.leorad.com.br e crie sua conta caso ainda não possua uma.
2. 2
   Acesse seu Perfil: Após fazer login, clique no ícone de engrenagem no menu lateral para acessar as configurações do seu perfil.
3. 3
   Gere o Token: Dentro do Perfil, selecione a opção "Token" e clique em "Gerar Token". O token será exibido e estará pronto para uso.

Acesso direto à aplicação web

O Token de Login pode ser utilizado para abrir a aplicação LeoRad diretamente, incorporando-o na URL de acesso:

https://app.leorad.com.br/<SEU_TOKEN_DE_LOGIN>

#Token de API

Para utilizar a API Voice-Processor, é necessário obter um Token de API (JWT). Esse token é gerado a partir do seu Token de Login e deve ser incluído no cabeçalho de todas as requisições à API.

Obtendo o Token de API

Faça uma requisição POST para o endpoint abaixo, substituindo <SEU_TOKEN_DE_LOGIN> pelo token obtido na seção anterior:

curl -X POST \
  "https://api-app.leorad.com.br/legacy-api/public/token-login/<SEU_TOKEN_DE_LOGIN>"

Exemplo de resposta

{
  "apiToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9..."
}

Utilizando o Token de API

O apiToken retornado deve ser incluído no cabeçalho Authorization de todas as requisições à API Voice-Processor, precedido da palavra Bearer:

Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...

#Métodos da API

Todos os endpoints abaixo utilizam a URL base https://voice-processor.leorad.com.br e exigem autenticação via Token de API no cabeçalho Authorization.

#POST /ai/assistant

Recebe parâmetros como prompt, agente e conteúdo do editor para gerar um laudo radiológico completo. A resposta é transmitida via streaming, permitindo exibição progressiva do conteúdo em tempo real. Ideal para relatórios completos.

Exemplo de requisição (JavaScript)

const formData = new FormData();
formData.append('user', 'usuario@email.com');
formData.append('agent', 'general');
formData.append('language', 'pt-BR');
formData.append('languageSpeech', 'pt-BR');
formData.append('files', audioBlob, 'audio.mp3');

const response = await fetch('https://voice-processor.leorad.com.br/ai/assistant', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <SEU_TOKEN_DE_API>',
  },
  body: formData,
});

// Processar streaming
const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  const chunk = decoder.decode(value);
  console.log('Trecho do laudo:', chunk);
}

#POST /ai/speech

Recebe um arquivo de áudio e realiza a transcrição do conteúdo falado em texto. Útil para capturar ditados do radiologista e converter em texto antes de processamento adicional.

Exemplo de requisição (JavaScript)

const formData = new FormData();
formData.append('user', 'usuario@email.com');
formData.append('languageSpeech', 'pt-BR');
formData.append('files', audioBlob, 'audio.mp3');

const response = await fetch('https://voice-processor.leorad.com.br/ai/speech', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <SEU_TOKEN_DE_API>',
  },
  body: formData,
});

const result = await response.json();
console.log('Transcrição:', result);

#POST /ai/review

Recebe o conteúdo textual de um laudo e realiza uma revisão anotada, incluindo comentários explicativos sobre o conteúdo. Ideal para validação e controle de qualidade de laudos existentes.

Exemplo de requisição (JavaScript)

const response = await fetch('https://voice-processor.leorad.com.br/ai/review', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <SEU_TOKEN_DE_API>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    user: 'usuario@email.com',
    language: 'pt-BR',
    editorContent: '<p>Fígado de dimensões normais, com contornos regulares...</p>',
  }),
});

const result = await response.json();
console.log('Revisão:', result);

#POST /ai/scan

Recebe uma imagem, áudio ou documento como entrada e extrai o texto contido nele por meio de OCR (Optical Character Recognition) com IA. Indicado para digitalização de laudos físicos ou documentos escaneados.

Exemplo de requisição (JavaScript)

const formData = new FormData();
formData.append('user', 'usuario@email.com');
formData.append('agent', 'V2');
formData.append('file', imageFile, 'laudo.jpg');

const response = await fetch('https://voice-processor.leorad.com.br/ai/scan', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <SEU_TOKEN_DE_API>',
  },
  body: formData,
});

const result = await response.json();
console.log('Texto extraído:', result);