Referência da API
Transcrição de Fala para Texto (STT)
Envie arquivos de áudio pré-gravados para obter transcrições de texto precisas com marcações de tempo de forma assíncrona.
Como arquivos de áudio grandes podem levar vários minutos para serem processados, esta API usa uma arquitetura robusta de Envio e Consulta (Submit & Poll). Primeiro, você envia o arquivo para receber um job_id e, em seguida, consulta o endpoint de status até que a transcrição seja concluída.
1. Enviar tarefa de áudio
POST
/api/v1/stt/submit/
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
| audio | obrigatório | file | O arquivo de áudio a ser transcrito. Suporta mp3, wav, m4a, etc. Máx. 50 MB. |
| language | opcional | string | O padrão é ar-JO. |
| output_format | opcional | string | Aceita json ou srt. O padrão é json. |
2. Verificar status da tarefa
GET
/api/v1/stt/status/{job_id}/
Exemplo de integração em produção (Python)
import requests
import time
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1. Enviar o arquivo de áudio
submit_url = "https://moknah.io/api/v1/stt/submit/"
files = {"audio": ("audio.mp3", open("long_audio.mp3", "rb"), "audio/mpeg")}
data = {"language": "ar-JO", "output_format": "json"}
print("Enviando áudio...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"Tarefa na fila! ID: {job_id}")
# 2. Consultar o resultado
status_url = f"https://moknah.io/api/v1/stt/status/{job_id}/"
while True:
res = requests.get(status_url, headers=HEADERS)
result = res.json()
if result.get("status") in ["queued", "processing"]:
print("Processando... verificando novamente em 5 segundos.")
time.sleep(5)
elif result.get("status") == "completed":
print("\nTranscrição concluída!")
print(result["result"]["subtitles"])
break
else:
print("\nFalha na tarefa:", result)
break
Suporte da API
Para dúvidas ou problemas relacionados à API, entre em contato conosco em api@moknah.io.