Moknah Documentação
Comece grátis
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.