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.