Documentação

Primeira transcrição

Envie um arquivo e receba o texto, quem falou e o horário de cada palavra.

Você precisa de uma chave de API nas variáveis NOUS_API_KEY e NOUS_API_BASE_URL. Ainda não tem? Veja criar conta e chave.

1. Envie o arquivo

curl -sS "$NOUS_API_BASE_URL/transcriptions" \
  -H "Authorization: Bearer $NOUS_API_KEY" \
  -F "file=@audiencia.mp3"

Áudios de até 30 minutos voltam na mesma chamada, já prontos. Acima disso, a resposta chega com status: "processing": veja webhooks para ser avisado quando terminar.

2. Leia a resposta

{
  "id": "tr_8f2k9d7c",
  "status": "completed",
  "title": "audiencia.mp3",
  "duration_s": 312.4,
  "text": "Meu e-mail é joao.silva@gmail.com e o CPF 123.456.789-09.",
  "words": [{ "text": "Meu", "start_s": 0.42, "end_s": 0.61, "confidence": 0.98, "speaker": null }],
  "entities": {
    "emails": [{ "value": "joao.silva@gmail.com", "said": "joão ponto silva arroba gmail ponto com", "start_s": 1.1, "end_s": 3.9, "confidence": 0.91, "speaker": null }],
    "cpfs": [{ "value": "123.456.789-09", "valid": true, "said": "um dois três quatro cinco seis sete oito nove zero nove", "start_s": 4.2, "end_s": 8.0, "confidence": 0.95, "speaker": null }],
    "phones": [],
    "ceps": [],
    "amounts": []
  },
  "speakers": [],
  "sentiment": null,
  "conversation": null,
  "billing": { "seconds": 313, "cost_brl": 0.1565, "balance_brl": 42.14 }
}

3. Peça mais recursos

Some parâmetros na URL. Sem multipart, mande o arquivo direto no corpo, o que é mais rápido para arquivos grandes (até 100 MB):

curl -sS "$NOUS_API_BASE_URL/transcriptions?diarization=true&sentiment=true&keyterms=TJSP&keyterms=habeas%20corpus" \
  -H "Authorization: Bearer $NOUS_API_KEY" \
  -H "Content-Type: audio/mpeg" \
  --data-binary "@audiencia.mp3"
ParâmetroO que fazCusto extra por minuto
diarization=truesepara até 4 pessoasincluído
sentiment=truesentimento por trecho (contas com assinatura)R$ 0,002
keyterms=...vocabulário, repetívelgrátis
webhook_url=https://...avisa quando terminargrátis

Próximos passos: vocabulário, falantes e sentimento, referência completa.

Nesta página