feat: Agrega primera version de template (revisar archivo de documentacion - docs.md)

app/api/v1/endpoints/audio/transcription.py

@@ -0,0 +1,38 @@
+"""
+Gateway de IA de Qualidot - Módulo de Procesamiento de Audio
+
+Propósito:     
+    Este endpoint recibe un audio y lo convierte a texto usando inteligencia artificial.
+
+Homologación:  
+    Sin importar qué proveedor de IA se utilice, el resultado siempre se entrega en el mismo formato estándar para Qualidot.
+"""
+
+from dotenv import load_dotenv
+from fastapi import APIRouter, Depends, UploadFile, File, HTTPException
+from fastapi.security import APIKeyHeader
+from app.api.v1.endpoints import router
+from app.schemas.audio_standard import StandardTranscriptionResult, AudioRequestFile
+from app.services.audio.transcription_adapters import transcribe_audio_with_provider
+
+# Inicializar el router de FastAPI para este módulo
+audio_router_transcription = APIRouter()
+
+@audio_router_transcription.post("/transcripts/", response_model=StandardTranscriptionResult)
+async def transcribe_audio(audio_request: AudioRequestFile = Depends()) -> StandardTranscriptionResult:
+    """
+    Endpoint para transcribir audio simple infiriendo el proveedor de IA
+    
+    Args:
+        audio_request: Objeto AudioRequestFile que contiene el archivo de audio, 
+        el proveedor, el modelo y las opciones de diarización, marcas de tiempo y análisis de sentimiento.
+        
+    Returns:
+        StandardTranscriptionResult: Resultado de la transcripción en formato estándar de Qualidot
+    """
+    try:
+        # Transcribir usando el adaptador de transcripción que infiere el proveedor
+        transcription_result = await transcribe_audio_with_provider(audio_request)
+        return transcription_result
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))