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.
Envie o header Authorization: Bearer {accessToken} (token de usuário) ou x-api-key: {apiKey} (integrações). Veja Autenticação.
Exige a permissão update_preconsultations.
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
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
id | number | ✅ | ID da pré-consulta |
Corpo da Requisição (multipart/form-data)
| Campo | Tipo | Obrigatório | Descrição |
|---|---|---|---|
file | File | ✅ | Áudio mp3, wav, webm, mp4, m4a, ogg ou aac, até 50 MB |
prompt | string | ✅ | 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).
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
}