Skip to main content

POST Transcrever Áudio

Envia um áudio para transcrição por IA e devolve o texto. É o ponto único de transcrição da pré-consulta. O áudio não é salvo nem vinculado à pré-consulta — para isso use o fluxo de Salvar URL do Áudio.

Autenticação necessária

Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.

Permissão necessária

Exige a permissão update_preconsultations.

Provedor de IA

A transcrição usa o provedor de IA configurado para a conta, com idioma fixo em português. O tempo de resposta depende do tamanho do áudio (vários segundos).


Endpoint​

POST https://api-dev.imagemais.com.br/api/pre-consultations/{id}/transcription

Path Parameter​

CampoTipoObrigatórioDescrição
idnumber✅ID da pré-consulta

Corpo da Requisição (multipart/form-data)​

CampoTipoObrigatórioDescrição
fileFile✅Áudio mp3, wav, webm, mp4, m4a, ogg ou aac, até 50 MB
promptstring✅Instrução/contexto para a transcrição (ex.: termos médicos esperados)

Requisição​

curl -X 'POST' \
'https://api-dev.imagemais.com.br/api/pre-consultations/29/transcription' \
-H 'accept: application/json' \
-H 'Authorization: Bearer {accessToken}' \
-F 'file=@relato.webm;type=audio/webm' \
-F 'prompt=Relato do paciente na pré-consulta'

Respostas​

201 Sucesso​

Retorna o texto transcrito em text (string vazia quando não há fala no áudio).

Texto normalizado pelo servidor

O servidor remove todos os acentos e apaga o primeiro ponto final (.) do texto antes de devolver — os demais pontos são mantidos. Registrado nas pendências de código.

{
"text": "Paciente relata dor de cabeca ha tres dias, pior no fim da tarde, sem febre"
}

400 Bad Request​

Retornado quando prompt não é enviado.

{
"message": [
"prompt must be a string",
"prompt should not be empty"
],
"error": "Bad Request",
"statusCode": 400
}

404 Pré-consulta não encontrada​

Retornado quando o id não existe, foi excluído ou pertence a outra conta.

{
"message": "Pré-consulta não encontrada",
"error": "Not Found",
"statusCode": 404
}

422 Arquivo inválido​

Retornado quando o arquivo não é um áudio aceito ou passa de 50 MB.

{
"message": "Apenas arquivos de áudio são permitidos (mp3, mp3, wav, webm, mp4, m4a, ogg, aac, aac) com até 50MB.",
"error": "Unprocessable Entity",
"statusCode": 422
}