Moknah Documentación
Empieza gratis
Referencia de la API

Transcripción de voz a texto (STT)

Sube archivos de audio pregrabados para obtener transcripciones de texto precisas con marcas de tiempo de forma asíncrona.

Debido a que los archivos de audio grandes pueden tardar varios minutos en procesarse, esta API utiliza una arquitectura robusta de envío y consulta (Submit & Poll). Primero envías el archivo para recibir un job_id y luego consultas el endpoint de estado hasta que se complete la transcripción.

1. Enviar tarea de audio

POST /api/v1/stt/submit/
Parámetro Obligatorio Tipo Descripción
audio obligatorio file El archivo de audio a transcribir. Admite mp3, wav, m4a, etc. Máx. 50 MB.
language opcional string El valor predeterminado es ar-JO.
output_format opcional string Acepta json o srt. El valor predeterminado es json.

2. Comprobar el estado de la tarea

GET /api/v1/stt/status/{job_id}/

Ejemplo de integración en producción (Python)

import requests
import time

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. Enviar el archivo de audio
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 audio...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"¡Tarea en cola! ID: {job_id}")

# 2. Consultar el 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("Procesando... comprobando de nuevo en 5 segundos.")
        time.sleep(5)
    elif result.get("status") == "completed":
        print("\n¡Transcripción finalizada!")
        print(result["result"]["subtitles"])
        break
    else:
        print("\nError en la tarea:", result)
        break
Soporte de API

Para preguntas o problemas relacionados con la API, contáctanos en api@moknah.io.