Introdução

A API do transcrevo converte áudio em texto. Você manda o áudio (uma URL pública ou o arquivo direto) e recebe a transcrição completa, com detecção automática de idioma e separação de falantes opcional.

Base URL

https://api.transcrevo.com

Como funciona

1. Crie a transcrição com POST /v1/transcripts.
2. Ela roda de forma assíncrona: a resposta volta na hora com status: "processing".
3. Consulte GET /v1/transcripts/{id} até status virar done (o texto vem em text) ou failed (o motivo vem em error).

Quickstart

Áudio numa URL pública, uma requisição:

curl https://api.transcrevo.com/v1/transcripts \
  -H "Authorization: Bearer $TRANSCREVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "url": "https://example.com/podcast.mp3" }'

{
	"data": {
		"id": "6b9f2b81-1c9a-4f4e-9d5f-8f2a7c1e3b90",
		"status": "processing",
		"text": null,
		"words": null,
		"error": null,
		"language": null,
		"durationSeconds": 0,
		"speakerCount": null,
		"cost": 0,
		"currency": "USD",
		"model": "trv-1",
		"url": "https://example.com/podcast.mp3",
		"createdAt": "2026-08-24T18:00:00.000Z"
	}
}

Depois é só consultar até concluir:

curl https://api.transcrevo.com/v1/transcripts/6b9f2b81-1c9a-4f4e-9d5f-8f2a7c1e3b90 \
  -H "Authorization: Bearer $TRANSCREVO_API_KEY"

Arquivo local? Mande o arquivo e use o id que voltar:

UPLOAD_ID=$(curl -s -X POST https://api.transcrevo.com/v1/uploads \
  -H "Authorization: Bearer $TRANSCREVO_API_KEY" \
  --data-binary @reuniao.mp3 | jq -r .data.id)

curl https://api.transcrevo.com/v1/transcripts \
  -H "Authorization: Bearer $TRANSCREVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{ \"uploadId\": \"$UPLOAD_ID\", \"speakers\": true }"

Envelope de resposta

Toda resposta JSON da API usa o mesmo envelope:

• Sucesso: { "data": ... }
• Erro: { "error": { "code": "...", "message": "...", "fields": { ... } } }. O message explica o que houve; o code é o que o seu código deve testar. Veja Erros.

Próximos passos

• Referência da API: gerada automaticamente do spec OpenAPI.
• Autenticação: sua chave de API nasce com a conta.
• Transcrições: referência completa do recurso.
• Envio de arquivos: arquivo local, numa requisição ou retomável.
• Preços e limites: quanto custa e até onde vai.
• Precisão e qualidade: WER de 6,34% em português, DER de 4,6% na diarização e como cada número foi medido.